# Tool names are unique within the server (ChatGPT)

**OpenAI’s plugin guidelines state that tool names must be unique within your MCP server, so a duplicate name blocks a ChatGPT app submission even though the MCP specification only says SHOULD.**

Check `openai-name-unique` · OpenAI plugin directory · default severity: blocking · rubric 2.1.0. Last verified against OpenAI plugin guidelines, section 6.1 on 2026-11-18.

## Error message you’ll see

```text
tools: Tool names must be unique.
```

Claude API (400), when two connected tools end up with the same name. Where this was reported: https://github.com/anthropics/claude-code/issues/12994

```text
Tool […] is already registered
```

TypeScript SDK 2.4.0, registerTool with a name already in use. Where this message comes from: https://github.com/modelcontextprotocol/typescript-sdk/blob/951fe5603a7ec0b2dcb6a0b95d92cd86f93ad9e5/packages/server/src/server/mcp.ts#L1103

## What fails

OpenAI makes uniqueness a requirement (the MCP specification says SHOULD).

## The rule

> Tool names must be unique within your MCP server.

Source: [OpenAI plugin guidelines, section 6.1](https://developers.openai.com/plugins/plugin-guidelines)

## How to fix it

Rename or remove the duplicate tools.

1. List every tool name and find the repeats.
2. Rename one of each pair to describe what it does differently, or remove it.
3. Re-submit only after the full list (all pages) has no repeats.

### TypeScript SDK

```ts
import { McpServer } from '@modelcontextprotocol/server';
import * as z from 'zod';

const server = new McpServer({ name: 'issues', version: '1.0.0' });

server.registerTool(
  'list_projects',
  {
    title: 'List projects',
    description: 'List the projects the user can see. Use when the user asks which projects exist.',
    inputSchema: z.strictObject({
      limit: z.number().int().min(1).max(100).default(50).describe('Maximum projects to return'),
    }),
    annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
  },
  async ({ limit }) => ({ content: [{ type: 'text', text: 'Done' }] }),
);
```

### Python SDK

```python
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="List projects",
    annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, openWorldHint=False),
)
def list_projects(
    limit: Annotated[int, Field(description="Maximum projects to return", ge=1, le=100)] = 50,
) -> str:
    """List the projects the user can see. Use when the user asks which projects exist."""
    return "Done"
```

## Questions

### How can a server list the same name twice?

Usually by generating tools: two OpenAPI operations that map to one name, a plugin system that registers a tool twice, or two pages of a paginated list that overlap.

### Does case matter?

Tool names are case-sensitive in the specification, but Get_Issue and get_issue next to each other confuse models and reviewers. Use one spelling.

## Related checks

- [Tool names are unique within the server](https://isokron.ai/mcp-check/checks/spec-name-unique)
- [Larger catalogs use a naming prefix](https://isokron.ai/mcp-check/checks/design-namespace)
- [Tool names that say what the tool does](https://isokron.ai/mcp-check/checks/openai-name-opaque)
- [MCP tool names](https://isokron.ai/mcp-check/checks/names)

Counts toward: OpenAI plugin directory.

Rubric: https://isokron.ai/mcp-check/rubric

Check your tool list: https://isokron.ai/mcp-check
