Improve tool descriptions, list tools in README

Author: josevalim

README.md

@@ -263,6 +263,21 @@ options below:
   accessed from another trusted machine
 - `team`: enable Tidewave Web for teams
 
+## Available tools
+
+* `get_docs` - get the documentation for a given module/namespace or a
+  class/interface/enum/type in that namespace. It consults the exact
+  versions used by the project, ensuring you always get correct information
+
+* `get_source_location` - get the source location for a given module/namespace
+  or a class/interface/enum/type in that namespace, so an agent can directly
+  read the source skipping search
+
+* `get_logs` - reads console log written by the server
+
+* `project_eval` - evaluates code within the runtime itself, giving the agent
+  access to dependencies, server code, and all in-memory data
+
 ## CLI
 
 Tidewave.js also comes with a CLI for developers who want to use it as a

src/tools.ts

@@ -28,7 +28,8 @@ export interface Tools {
 }
 
 const projectEvalDescription = `
-Evaluates JavaScript/TypeScript code in the context of the project.
+Evaluates JavaScript/TypeScript code within your project's build tool
+(or server for full-stack applications).
 
 The current NodeJS version is: ${process.version}
 
@@ -37,7 +38,7 @@ including to test the behaviour of a function or to debug
 something. The tool also returns anything written to standard
 output. DO NOT use shell tools to evaluate JavaScript/TypeScript code.
 
-Imports are allowed only as the form of dynamic imports with async/await, e.g.:
+Imports are allowed only as the form of dynamic imports with async/await:
 const path = await import('node:path');
 `;
 
@@ -153,7 +154,7 @@ export const tools: Tools = {
     mcp: {
       name: 'get_logs',
       description:
-        'Retrieve application logs for debugging. Returns logs excluding Tidewave internal logs. Supports filtering by level, time, and pattern matching.',
+        "Retrieve application logs within your project's build tool (or server for full-stack applications). Supports filtering by level, time, and pattern matching.",
       inputSchema: getLogsInputSchema,
     },
   },