Skip to content

Add annotation titles to all MCP tools #149

Description

@mattzcarey

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions