Tool names without promotional or comparative words
OpenAI’s guidelines say tool names must avoid misleading, overly promotional or comparative language (for example pick_me, best, official); name the action plainly instead, such as get_order_status.
Check openai-name-promotional · OpenAI plugin directory · default severity: attention · rubric 2.1.0
What fails
Words such as best, official or recommended in a tool name try to win selection instead of describing the action.
The rule
Avoid misleading, overly promotional, or comparative language (for example, pick_me, best, official).
How to fix it
Name the action plainly, ideally as a verb, for example get_order_status.
- Remove words such as best, official, recommended, pick_me, top or ultimate from tool names.
- Name the action as a verb and an object.
- Put any branding in the app listing, not in tool names.
TypeScript SDK
import { McpServer } from '@modelcontextprotocol/server';
import * as z from 'zod';
const server = new McpServer({ name: 'issues', version: '1.0.0' });
server.registerTool(
'get_order_status',
{
title: 'Get order status',
description: 'Return the status and delivery estimate of one order. Use when the user asks where an order is.',
inputSchema: z.strictObject({
order_id: z.string().describe('Order number, for example 10425'),
}),
annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
},
async ({ order_id }) => ({ 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="Get order status",
annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, openWorldHint=False),
)
def get_order_status(
order_id: Annotated[str, Field(description="Order number, for example 10425")],
) -> str:
"""Return the status and delivery estimate of one order. Use when the user asks where an order is."""
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
Why does a tool name matter to review?
Models choose tools partly by name. A name that claims to be the best or the official option tries to win that choice instead of describing the action, which the guidelines treat as manipulation.
Can my brand name be in a tool name?
A neutral service prefix such as acme_search is fine. Words that rank or endorse (best, official, recommended) are what the rule targets.
Related checks
- Tool names that say what the tool does
- No steering of when other tools are used
- Larger catalogs use a naming prefix
- All checks in MCP tool names
How this check is graded
It counts toward: OpenAI plugin directory. See the rubric.
Last verified against OpenAI plugin guidelines, section 6.1 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