Working · 2026-11SecondaryGrowth opsMarketplaces

Write tool names and descriptions as the discovery surface

Treat MCP tool names, descriptions and example prompts as the main way assistants decide when to use you.

Also called: MCP tool metadata

Claim and evidence

The claimTreat MCP tool names, descriptions and example prompts as the main way assistants decide when to use you.

No dated example yet. Treat this tactic as a hypothesis.

What the numbers show

No published number for this tactic has passed our word-for-word check yet, so there is no chart.

Why it works

Diagram, not data
User asks for ataskAssistant readstool metadataNarrow,accuratedescriptionmatchesYour tool getscalled
User asks for a taskAssistant reads tool metadataNarrow, accurate descriptionmatchesYour tool gets called

Assistants pick tools from their metadata, so clear, narrow and accurate descriptions drive correct use. Directories also review these for accuracy and misleading instructions.

How to run it

  1. Name each tool for the single task it does
  2. Write a narrow description stating when to use it
  3. Avoid generic or single-word names
  4. Provide example prompts
  5. Do not instruct the model beyond describing the tool

Ways to run it

Design options to test, not promised results.

  1. Option AOne task per tool

    Split broad tools into narrow ones named for the single job each does.

  2. Option BWhen-to-use descriptions

    Say what the tool does and when it applies, without telling the model how to behave.

  3. Option CExample prompts

    Provide sample user requests that should lead to each tool, and test them in the assistant.

Dated examples

No dated example yet. Treat this tactic as a hypothesis.

Does it still work?

Workingas of 2026-11

Platform guidance from OpenAI and Anthropic; the 'new SEO' analogy is a guest author's framing. source

Risks

  • Descriptions with promotional or behavior-steering text are rejected
  • Effect on ranking not quantified

Sources

  1. lennysnewsletter.com · Lenny's Newsletter · Colin Matthews (guest post) · 2026-01-20
    “As you may have been thinking as you read this, tools also represent a new form of SEO (or is it AEO?).”
    ✓ quote checked word-for-word on the page
  2. developers.openai.com · OpenAI developer docs · undated
    “Plugin names and descriptions must be clear, accurate, and straightforward.”
    ✓ quote checked word-for-word on the page
  3. claude.com · Claude docs · undated
    “Describe what the tool does, and don't tell Claude how to behave.”
    ✓ quote checked word-for-word on the page

Change log

  • 2026-11-20 — harvest v0.1 (ops-ai)