Every tool has a title
Every tool needs a short human-readable title, such as "Create issue", for the Claude connector directory; either the top-level title field or annotations.title counts.
Check anthropic-title · Anthropic connector directory · default severity: blocking · rubric 2.1.0
What fails
The title is the name people see in Claude. Either the top-level "title" or "annotations.title" counts.
The rule
Every tool must include a
titleand the applicable hint:readOnlyHint: truefor read-only tools, anddestructiveHint: truefor tools that modify or delete data.
How to fix it
Add a short, human-readable "title", for example "Create issue".
- Add a title to every tool: a few words, sentence case, no underscores.
- Use the top-level title field (both SDKs take it as an option).
- Keep the machine name in name, the human name in title.
{ "name": "create_issue", ... }{ "name": "create_issue", "title": "Create issue", ... }TypeScript SDK
import { McpServer } from '@modelcontextprotocol/server';
import * as z from 'zod';
const server = new McpServer({ name: 'issues', version: '1.0.0' });
server.registerTool(
'create_issue',
{
title: 'Create issue',
description: 'Create one issue in a project. Use when the user asks to file or report something.',
inputSchema: z.strictObject({
project_id: z.string().describe('Project ID, for example PRJ-7'),
title: z.string().describe('Issue title, one line'),
}),
annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false },
},
async ({ project_id, title }) => ({ content: [{ type: 'text', text: 'Done' }] }),
);Python SDK
from typing import Annotated
from pydantic import Field
from mcp.server.mcpserver import MCPServer
from mcp.types import ToolAnnotations
server = MCPServer("issues")
@server.tool(
title="Create issue",
annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False, openWorldHint=False),
)
def create_issue(
project_id: Annotated[str, Field(description="Project ID, for example PRJ-7")],
title: Annotated[str, Field(description="Issue title, one line")],
) -> str:
"""Create one issue in a project. Use when the user asks to file or report something."""
return "Done"Run against @modelcontextprotocol/server 2.4.0, mcp 2.3.0 and fastmcp 4.2.2 on 2026-11-18; the checker confirms this check passes on the tool list each snippet produces.
Questions
Top-level title or annotations.title?
Both are in the specification and both satisfy the checklist. Prefer the top-level title, which current SDKs set and clients read first.
Where does the title appear?
In client UIs: tool lists, permission prompts and call logs. The model mostly reads the name and description.
Related checks
- Every tool carries the applicable hint
- readOnlyHint, destructiveHint and openWorldHint are explicit booleans
- Tool names that say what the tool does
- All checks in MCP tool annotations
How this check is graded
It counts toward: Anthropic connector directory. See the rubric.
Last verified against Anthropic connector pre-submission checklist on 2026-11-18. The rule above is quoted in the source’s own words. This page as Markdown.
Check your tool list: paste your tools/list, nothing is sent anywhere