Agent skill · Anthropic Agent Skills
/mcp-builder Build MCP servers that connect agents to external APIs
mcp-builder guides Claude through creating a Model Context Protocol server that exposes an external service as tools an agent can call. It covers research and tool design, implementation in TypeScript or Python with the official SDKs, testing with the MCP Inspector, and writing a set of evaluation questions to check the server works for real tasks.
Works with
- Claude Code
Used forBuilding skills and MCP
When to use it
- You want Claude or another agent to use a service that has an API but no MCP server
- You are designing which tools to expose and how to name and describe them
- An existing MCP server needs review, testing or migration to a newer SDK
How it works
- 1Research and plan
Claude studies the MCP spec, the chosen SDK docs and the target API, then selects tools to build.
- 2Implement
It sets up the project and writes tools with input and output schemas, descriptions and annotations.
- 3Review and test
It checks code quality, builds the server and exercises it with the MCP Inspector or a syntax check.
- 4Create evaluations
It writes ten realistic evaluation questions to measure how well an agent can use the server.
What it steers the agent away from
- Thin one-to-one API wrappers that leave agents with unclear or overlapping tools
- Error messages that do not tell the agent how to recover
- Starting new TypeScript projects on the older v1 SDK without saying so
Install this skill
It installs with the Anthropic Agent Skills pack.
Claude CodeAdds the repo as a plugin marketplace, then installs the document set and the example set separately.
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skillsCommands come from the author’s README; check it for changes before you run them.
Questions
Which languages does it support?
TypeScript, which the skill recommends, and Python using FastMCP from the official Python SDK.
Does it migrate old servers?
If a project already uses the v1 TypeScript SDK, it notes that v2 is current and gives the codemod command, but keeps using v1 unless you ask to migrate.
More guides from Anthropic Agent Skills
/pdfWork with PDF files: extract, merge, fill and createReads, creates, merges, splits, fills and otherwise processes PDF files with Python and CLI tools.Read the guide →/skill-creatorCreate, test and tune your own agent skillsDrafts new skills, tests them on sample prompts and tunes their trigger descriptions.Read the guide →
Also in this pack
/academy-guideSuggests a matching Claude Academy course or tutorial after answering how-to questions about Claude.↗/algorithmic-artCreates original generative art in p5.js with seeded randomness and adjustable parameters.↗/brand-guidelinesApplies Anthropic's brand colors and typography to documents, slides and other artifacts.↗/canvas-designProduces original static visual designs such as posters as PNG or PDF files.↗/discernment-nudgeAdds two or three follow-up questions that help users check facts and assumptions.↗/doc-coauthoringLeads a staged workflow for drafting specs, proposals and other structured documents with the user.↗/docxCreates, reads and edits Word documents, including tracked changes and comments.↗/frontend-designSteers new or reworked user interfaces toward deliberate, non-templated visual design choices.↗/internal-commsDrafts internal communications such as status reports, leadership updates and incident reports.↗/pptxCreates, reads and edits PowerPoint decks and templates, including layouts and speaker notes.↗/slack-gif-creatorMakes small animated GIFs sized and validated for use in Slack.↗/theme-factoryApplies one of ten preset color and font themes, or a new one, to an artifact.↗
Summary by trendhub. The skill itself lives in anthropics/skills/skills/mcp-builder by Anthropic (Apache-2.0); read the full, current text there.