MCP Builder

MCP Builder

✓ Verified

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

Claude / Claude Codetested
GitHub Copilot
Cursor
VS Code
OpenAI Codex
Gemini CLI
DevelopmentDeveloperDevOps Engineer

What it does

Claude generates MCP servers that don't conform to the spec: tools with missing or incorrect JSON Schema for inputs, resources with malformed URI patterns, improper error handling that crashes the server instead of returning a structured error, and server configurations that don't work with Claude Desktop or Claude Code. This skill loads the correct MCP implementation patterns for both Python (FastMCP) and TypeScript (MCP SDK) — tools, resources, prompts, and the configuration files needed to connect them to a client.

Use case

Building an MCP server to expose an API, database, or service to Claude. The failure mode this prevents: an MCP server that starts without errors but whose tools don't appear in Claude, or appear but error on every call. Made by Anthropic.

The Prompt

Copy and use immediately
"Build an MCP server that exposes my company's Jira API as tools for Claude."
"Create an MCP resource that gives Claude read access to our internal docs."
"My MCP tool isn't showing up in Claude — diagnose the implementation."
"Add a Slack tool that lets Claude post to a specific channel."
"Build a filesystem MCP server restricted to a specific directory."

How to use

  1. 1

    Describe the service or API you want to expose and which operations Claude should perform.

  2. 2

    Specify Python or TypeScript — both are fully supported.

  3. 3

    Claude generates a complete, runnable server with the claude_desktop_config.json or .claude/settings.json entry needed to connect it.

Input / Output

Input

A description of the external service, its authentication pattern, and the operations you want Claude to perform.

Output

A complete MCP server with correctly defined tools (proper JSON Schema inputs), resources (correct URI patterns), and configuration for Claude Desktop or Claude Code. Runnable immediately.

Install via CLI

npx skillsadd anthropics/skills/mcp-builder
Added 15 Mar 2026Submitted by anthropics👁 45📋 0

Details

Platforms
Claude / Claude CodeGitHub CopilotCursorVS CodeOpenAI CodexGemini CLI
Category
Development
License
apache-2.0
Author
Anthropic

Stats

📋 Copies0
👁 Views45
👍 Upvotes0

Install with skills.sh

npx skillsadd anthropics/skills/mcp-builder

Requires skills.sh CLI

Community Notes

Sign in with GitHub to leave a note.

No notes yet. Be the first to contribute.