Skill Official

mcp-builder

Guide for building high-quality MCP servers in Python (FastMCP) or Node/TypeScript so LLMs can use external APIs.

Author
Anthropic
Works with
Claude Code
Documented
Oct 2, 2026

What mcp-builder is

Four-phase workflow for creating MCP servers: research and planning, implementation, review and testing, and evaluation. Quality is measured by how well an LLM can complete real tasks with the tools.

What it does

How mcp-builder plugs in: which agents run it and what it addsRUNS INYour agentClaude Codeone host documentedSKILL · OFFICIALmcp-builderReusable instructions and scripts…4 install steps1 permission noteWHAT IT ADDSWhat it doesBalances full API coverage agains…Guides tool naming and discoverab…Covers Python FastMCP and TypeScr…Walks through four phases from re…agent → extension → new capability · from the official repository or docs
Where mcp-builder runs and what it adds, from its documentation
  • Balances full API coverage against workflow tools
  • Guides tool naming and discoverability
  • Covers Python FastMCP and TypeScript MCP SDK
  • Walks through four phases from research to evaluation

When to use it

Good fit

  • Wrapping an external API as an MCP server
  • Reviewing the tool design of an existing MCP server

Not for

  • Using an existing MCP server (this is for building)

How to install mcp-builder

  1. Register the marketplace in Claude Code: /plugin marketplace add anthropics/skills
  2. Install the bundle that contains it (document-skills or example-skills): /plugin install example-skills@anthropic-agent-skills
  3. Or copy the skill folder to ~/.claude/skills/mcp-builder/ (personal) or .claude/skills/mcp-builder/ (project)
  4. Mention the task in a prompt; Claude loads the skill automatically when the SKILL.md description matches

Permissions and security

What it can access

  • Instructions loaded into Claude's context; any scripts it bundles run through Claude Code's normal tool permissions (shell, file edits)

Security notes from the maintainers

  • Anthropic repo disclaimer: skills are provided for demonstration and educational purposes; behavior in Claude may differ

Review the source before granting an agent access to credentials or production systems. We document what the maintainers state; we do not audit code.

Limitations

  • Repo README says implementations are examples and may differ from what Claude.ai provides

Tools it extends

Frequently asked questions

How do I install the mcp-builder skill in Claude Code?

Add the marketplace with /plugin marketplace add anthropics/skills and install the bundle containing it, or copy skills/mcp-builder into ~/.claude/skills/. source

When does Claude use the mcp-builder skill?

Claude loads it automatically when the request matches the description field in its SKILL.md frontmatter. source

Is the mcp-builder skill official?

Yes, it is published in Anthropic's anthropics/skills repository. source

Related guides

Sources and gaps

Not stated by the maintainers: last_release (repo has no releases read).

More extensions to look at