You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs(router): document omit_operation_prefix config for MCP tool names
Add documentation for the new omit_operation_prefix configuration option
that allows cleaner MCP tool names without the execute_operation_ prefix.
Related: wundergraph/cosmo#2441
Copy file name to clipboardExpand all lines: docs/router/mcp.mdx
+21Lines changed: 21 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -216,6 +216,7 @@ mcp:
216
216
exclude_mutations: true
217
217
enable_arbitrary_operations: false
218
218
expose_schema: false
219
+
omit_operation_prefix: false # When true: GetUser → get_user (no execute_operation_ prefix)
219
220
220
221
# Configure storage providers
221
222
storage_providers:
@@ -237,6 +238,7 @@ storage_providers:
237
238
| `exclude_mutations` | Whether to exclude mutation operations from being exposed | `false` |
238
239
| `enable_arbitrary_operations` | Whether to allow arbitrary GraphQL operations to be executed. <Warning>Security risk: Should only be enabled in secure, internal environments.</Warning> | `false` |
239
240
| `expose_schema` | Whether to expose the full GraphQL schema. <Warning>Security risk: Should only be enabled in secure, internal environments.</Warning> | `false` |
241
+
| `omit_operation_prefix` | When true, MCP tool names are generated without the `execute_operation_` prefix (e.g., `GetUser` → `get_user` instead of `execute_operation_get_user`). Can also be set via `MCP_OMIT_OPERATION_PREFIX` environment variable. | `false` |
240
242
241
243
## Session Handling
242
244
@@ -375,6 +377,25 @@ The MCP server converts each operation into a corresponding tool:
375
377
376
378
Operations are converted to snake_case for tool naming consistency.
377
379
380
+
#### Omitting the Operation Prefix
381
+
382
+
By default, all operation tools include the `execute_operation_` prefix. If you prefer shorter, cleaner tool names, enable the `omit_operation_prefix` configuration option:
Enabling this option changes all tool names and may break existing integrations that rely on the `execute_operation_` prefix. Only enable this for new deployments or when you can update all dependent systems.
397
+
</Warning>
398
+
378
399
### Best Practices
379
400
380
401
1. **Meaningful names**: Give operations clear, action-oriented names that describe what they do.
0 commit comments