Skip to content

Conversation

@shelley-cf
Copy link
Contributor

  • Add MCP-compliant tool titles and annotations to 27 tools across 8 files
  • Implement readOnlyHint and destructiveHint
  • Follow MCP specification: 2-5 words, sentence case, active verbs
  • Enhanced UX with friendly tool names in MCP clients like Claude.ai
  • Enable auto-approval for 15 read-only tools, safety warnings for 4 destructive tools

Files updated:

  • d1.tools.ts (5 tools)
  • account.tools.ts (2 tools)
  • docs-vectorize.tools.ts (2 tools)
  • hyperdrive.tools.ts (4 tools)
  • kv_namespace.tools.ts (5 tools)
  • r2_bucket.tools.ts (4 tools)
  • worker.tools.ts (3 tools)
  • zone.tools.ts (2 tools)

- Add MCP-compliant tool titles and annotations to 27 tools across 8 files
- Implement readOnlyHint and destructiveHint for intelligent default approval
- Follow MCP specification: 2-5 words, sentence case, active verbs
- Enhanced UX with friendly tool names in MCP clients like Claude.ai
- Enable auto-approval for 15 read-only tools, safety warnings for 4 destructive tools

Files updated:
- d1.tools.ts (5 tools)
- account.tools.ts (2 tools)
- docs-vectorize.tools.ts (2 tools)
- hyperdrive.tools.ts (4 tools)
- kv_namespace.tools.ts (5 tools)
- r2_bucket.tools.ts (4 tools)
- worker.tools.ts (3 tools)
- zone.tools.ts (2 tools)
@shelley-cf shelley-cf marked this pull request as ready for review August 13, 2025 14:30
agent.server.tool(
'accounts_list',
'List all accounts in your Cloudflare account',
{},
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Going to test if empty objects still cause issues with windsurf tool calling! #80

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

image

Nice ( tested in staging ) ! Looks good

@Maximo-Guk Maximo-Guk force-pushed the feature/mcp-tool-titles-and-hints branch from 3fac853 to 84cb1d6 Compare August 13, 2025 15:17
@Maximo-Guk Maximo-Guk merged commit 24dd872 into cloudflare:main Aug 13, 2025
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants