# /mcp-builder: Build MCP servers that connect agents to external APIs

Source: https://trendhub.net/skills/anthropics-skills/mcp-builder
Skill folder: https://github.com/anthropics/skills/tree/main/skills/mcp-builder
Pack: Anthropic Agent Skills (https://trendhub.net/skills/anthropics-skills)
Works with: Claude Code

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.

## 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

1. **Research and plan**: Claude studies the MCP spec, the chosen SDK docs and the target API, then selects tools to build.
2. **Implement**: It sets up the project and writes tools with input and output schemas, descriptions and annotations.
3. **Review and test**: It checks code quality, builds the server and exercises it with the MCP Inspector or a syntax check.
4. **Create 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

## What it can touch

Fetches MCP specification and SDK documentation from the web, writes server source files in your project, and runs build and test commands such as npm builds, npx for the MCP Inspector or SDK codemods, and Python compile checks.

## Pairs well with

- `/claude-api`
- `/skill-creator`
- `/webapp-testing`

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