refactor: Simplify tool descriptions - remove client implementation details

The server tool descriptions now just mention that widgets are interactive
and can be controlled, without teaching the model about list_widget_tools
(which is the client's responsibility to teach).

Before: 'The widget exposes tools: X, Y, Z. Use list_widget_tools to discover...'
After:  'The widget is interactive and exposes tools for X and Y.'

Author: ochafik

examples/budget-allocator-server/server.ts

@@ -269,7 +269,7 @@ export function createServer(): McpServer {
     {
       title: "Get Budget Data",
       description:
-        "Returns budget configuration with 24 months of historical allocations and industry benchmarks by company stage. The widget exposes tools: get-allocations (current allocations), set-allocation (adjust a category), set-total-budget (change budget), set-company-stage (change benchmark stage), get-benchmark-comparison (compare to industry). Use list_widget_tools to discover available actions.",
+        "Returns budget configuration with 24 months of historical allocations and industry benchmarks by company stage. The widget is interactive and exposes tools for reading/modifying allocations, adjusting budgets, and comparing against industry benchmarks.",
       inputSchema: {},
       outputSchema: BudgetDataResponseSchema,
       _meta: { ui: { resourceUri } },

examples/map-server/server.ts

@@ -148,7 +148,7 @@ export function createServer(): McpServer {
     {
       title: "Show Map",
       description:
-        "Display an interactive world map zoomed to a specific bounding box. Use the GeoCode tool to find the bounding box of a location. The widget exposes tools: navigate-to (fly to a new location), get-current-view (get camera position and visible bounds). Use list_widget_tools to discover available actions.",
+        "Display an interactive world map zoomed to a specific bounding box. Use the GeoCode tool to find the bounding box of a location. The widget is interactive and exposes tools for navigation (fly to locations) and querying the current view.",
       inputSchema: {
         west: z
           .number()

examples/pdf-server/server.ts

@@ -136,9 +136,7 @@ Use this tool when the user asks to view, display, read, or open a PDF. Accepts:
 - URLs from list_pdfs (preloaded PDFs)
 - Any arxiv.org URL (loaded dynamically)
 
-The viewer supports zoom, navigation, text selection, and fullscreen mode.
-
-The widget exposes tools: go-to-page (navigate to a page), get-page-text (extract text), search-text (find text in document), set-zoom (adjust zoom level), get-document-info (get metadata). Use list_widget_tools to discover available actions.`,
+The viewer supports zoom, navigation, text selection, and fullscreen mode. The widget is interactive and exposes tools for page navigation, text extraction, searching, and zoom control.`,
       inputSchema: {
         url: z
           .string()

examples/shadertoy-server/server.ts

@@ -51,7 +51,7 @@ LIMITATIONS - Do NOT use:
 For procedural noise:
   float hash(vec2 p) { return fract(sin(dot(p,vec2(127.1,311.7)))*43758.5453); }
 
-The widget exposes tools: set-shader-source (update shader code), get-shader-info (get source and errors). Compilation errors are also sent to model context. Use list_widget_tools to discover available actions.`;
+The widget is interactive and exposes tools for updating shader source code and querying compilation status. Compilation errors are sent to model context automatically.`;
 
 const DEFAULT_FRAGMENT_SHADER = `void mainImage(out vec4 fragColor, in vec2 fragCoord) {
     vec2 uv = fragCoord / iResolution.xy;

examples/wiki-explorer-server/server.ts

@@ -86,7 +86,7 @@ export function createServer(): McpServer {
     {
       title: "Get First-Degree Links",
       description:
-        "Returns all Wikipedia pages that the given page links to directly. The widget exposes tools: expand-node (explore a node's links - the key interaction!), search-article (find articles), get-current-article (get displayed article), highlight-node (highlight a graph node), get-visible-nodes (list visible nodes). Use list_widget_tools to discover available actions.",
+        "Returns all Wikipedia pages that the given page links to directly. The widget is interactive and exposes tools for exploring the graph (expanding nodes to see their links), searching for articles, and querying visible nodes.",
       inputSchema: z.object({
         url: z
           .string()