zuplo 7.12.5 → 7.12.6

package/docs/handlers/mcp-server.mdx

@@ -324,7 +324,8 @@ define the type of MCP capability and provide specific metadata.
   `graphql`). Defaults to `tool` if not specified.
 - `name`: Override the name shown to AI systems (defaults to `operationId`)
 - `description`: Override the description for AI consumption (defaults to route
-  description/summary)
+  description/summary). The default uses at most the first 350 characters of the
+  route description, while an override has no length limit.
 - `enabled`: Whether this operation should be available in the MCP server.
 
 See the respective [tools](../mcp-server/tools.mdx),

package/docs/mcp-server/prompts.mdx

@@ -77,7 +77,9 @@ The `x-zuplo-route.mcp` configuration for prompts supports:
   to an auto-generated name.
 - `description` - (optional) Description of what the prompt generates. If not
   provided, falls back to the operation's `description` or `summary` fields. If
-  those are not set, uses an auto-generated description.
+  those are not set, uses an auto-generated description. The fallback uses at
+  most the first 350 characters of the operation's `description`, followed by
+  `...`. This field has no length limit.
 
 ### MCP Server Handler Configuration
 

package/docs/mcp-server/resources.mdx

@@ -63,7 +63,9 @@ To provide MCP specific metadata for the resource, use the `mcp` property within
   auto-generated name.
 - `description` (optional) - Description of what the resource provides. Falls
   back to the operation's `description` or `summary`. If those fields are not
-  provided, falls back to an auto-generated description.
+  provided, falls back to an auto-generated description. The fallback uses at
+  most the first 350 characters of the operation's `description`, followed by
+  `...`. This field has no length limit.
 - `uri` (optional) - The URI identifier for the resource (for example,
   `"file:///example.txt"`, `"ui://html"`). Defaults to
   `"mcp://resources/{name}"`.

package/docs/mcp-server/tools.mdx

@@ -73,7 +73,9 @@ The `x-zuplo-route.mcp` configuration for tools supports:
 - `description` (`string`: optional) - Description of what the tool does. Falls
   back to the operation's `description` or `summary`. If the route's
   `description` or `summary` fields are not set, falls back to an auto-generated
-  description.
+  description. The fallback uses at most the first 350 characters of the
+  operation's `description`, followed by `...`. Set `description` here when the
+  tool needs a longer description: this field has no length limit.
 - `enabled` (`boolean`: optional) - Whether this tool is enabled. Defaults to
   `true`.
 - `includeOutputSchema` (`boolean`: optional) - Whether to advertise the route's
@@ -521,6 +523,15 @@ exactly _what_ each tool does.
 When you need to provide more meaningful descriptions or names that don't align
 well with the `operationId`, set the metadata in `x-zuplo-route.mcp`.
 
+:::note
+
+A tool that takes its description from the operation's `description` gets at
+most the first 350 characters of it, followed by `...`. To give a tool a longer
+description, set it in `x-zuplo-route.mcp.description`, which has no length
+limit.
+
+:::
+
 :::tip
 
 Read more about authoring usable tools and good prompt engineering practices

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zuplo",
-  "version": "7.12.5",
+  "version": "7.12.6",
   "type": "module",
   "description": "The official Zuplo CLI for local development and platform management",
   "homepage": "https://zuplo.com/docs/cli/overview",
@@ -32,9 +32,9 @@
     "zuplo": "zuplo.js"
   },
   "dependencies": {
-    "@zuplo/cli": "7.12.5",
-    "@zuplo/core": "7.12.5",
-    "@zuplo/runtime": "7.12.5",
-    "@zuplo/test": "7.12.5"
+    "@zuplo/cli": "7.12.6",
+    "@zuplo/core": "7.12.6",
+    "@zuplo/runtime": "7.12.6",
+    "@zuplo/test": "7.12.6"
   }
 }