Summary
Add explicit MCP annotations.title values to all tools exposed by cloudflare/mcp, so clients can display consistent human-readable tool labels.
Context
While adding the new docs tool, we noticed clients may display annotations.title instead of the raw tool name. We removed a one-off title from docs to keep it displaying as docs, but the better long-term approach is to define titles deliberately and consistently across every tool.
Proposal
- Audit all registered tools in both code mode and non-code mode.
- Add
annotations.title for each tool using a consistent naming convention.
- Keep raw tool names stable for machine invocation.
- Preserve useful annotations such as
readOnlyHint where applicable.
- Add/update tests to assert each registered tool has the expected title.
Acceptance criteria
- Every exposed tool has an intentional
annotations.title.
- Tool titles are consistent across code mode and
?codemode=false.
- Tests cover the registered annotations.
Summary
Add explicit MCP
annotations.titlevalues to all tools exposed bycloudflare/mcp, so clients can display consistent human-readable tool labels.Context
While adding the new
docstool, we noticed clients may displayannotations.titleinstead of the raw tool name. We removed a one-off title fromdocsto keep it displaying asdocs, but the better long-term approach is to define titles deliberately and consistently across every tool.Proposal
annotations.titlefor each tool using a consistent naming convention.readOnlyHintwhere applicable.Acceptance criteria
annotations.title.?codemode=false.