MCP Server Builder
OfficialOfficial skill that walks you through researching, implementing, testing, and evaluating high-quality MCP (Model Context Protocol) servers in TypeScript or Python.
Dev & CodingAdvanced★ 177,650⑂ 21,037AI score 8/10Last updated: Sep 22, 2026
What it does
- Breaks MCP server development into four phases: research/planning, implementation, review/testing, and evaluation creation.
- Codifies design principles: consistent tool naming prefixes, context-efficient responses, pagination, and actionable error messages.
- Shows how to define input schemas with Zod/Pydantic, add
outputSchema/structuredContent, and set annotations likereadOnlyHintanddestructiveHint. - Includes build/test steps (
npm run build,npx @modelcontextprotocol/inspector) and a process for authoring 10 verifiable XML eval questions. - Pulls in bundled references: Python guide, TypeScript guide, MCP best practices, and the evaluation guide.
Who it's for
- Backend/tooling engineers wrapping external APIs for LLM access.
- Teams standardizing internal MCP servers against the spec.
- Anyone wanting to benchmark an existing MCP server with an eval set.
Example uses
- "Build a TypeScript MCP server for our ticketing API" → project scaffold, Zod schemas, tool registration code.
- "Review this Python FastMCP server against MCP best practices" → naming, pagination, and error-handling fixes.
- "Generate 10 XML evaluation questions for my finished server" → read-only, verifiable question/answer pairs.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/anthropics/skills/HEAD/skills/mcp-builder/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/mcp-builder folder from the GitHub repo anthropics/skills into my ~/.claude/skills/mcp-builder/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/anthropics/skills.git && mkdir -p ~/.claude/skills && cp -r skills/skills/mcp-builder ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal in your working directory.
- Clone the official repo:
git clone https://github.com/anthropics/skills.git - Create the skills directory:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r skills/skills/mcp-builder ~/.claude/skills/ - Confirm the
reference/guides came along with it. - Restart Claude Code and ask something like "help me build an MCP server" to trigger the skill.
- Have Node.js + npm ready for TypeScript work, or Python 3.10+ for the Python path.