Skip to content
IsoKron

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).

Source: OpenAI plugin guidelines, section 6.1

How to fix it

Name the action plainly, ideally as a verb, for example get_order_status.

  1. Remove words such as best, official, recommended, pick_me, top or ultimate from tool names.
  2. Name the action as a verb and an object.
  3. Put any branding in the app listing, not in tool names.

TypeScript SDK

TypeScript
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

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="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.

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