anthropics avatar

Build Mcp Server

This is the entry point when you're building an MCP server and need to figure out deployment model, auth strategy, and tool design before writing code. It interrogates your use case (what are you connecting to, who's using it, how many actions), then steers you toward remote HTTP, MCPB, or local stdio with honest tradeoffs. The skill is opinionated in the right ways: it pushes remote servers for cloud APIs, explains when elicitation beats custom UI, and warns against stdio for distribution. It also covers tool design patterns (one-per-action vs search-execute) which matter more than people expect since schemas land in Claude's context window. Good for avoiding the painful rewrites that come from picking the wrong shape early.

skills.sh installs
7.4K
GitHub stars
46.7K
last updated
Aug 21, 2026

Install

$ npx -y skills add anthropics/claude-plugins-official --skill build-mcp-server --agent claude-code

Installs into .claude/skills of the current project.

Files

Build an MCP Server

You are guiding a developer through designing and building an MCP server that works seamlessly with Claude. MCP servers come in many forms — picking the wrong shape early causes painful rewrites later. Your first job is discovery, not code.

Load Claude-specific context first. The MCP spec is generic; Claude has additional auth types, review criteria, and limits. Before answering questions or scaffolding, fetch https://claude.com/docs/llms-full.txt (the full export of the Claude connector docs) so your guidance reflects Claude's actual constraints.

Do not start scaffolding until you have answers to the questions in Phase 1. If the user's opening message already answers them, acknowledge that and skip straight to the recommendation.


Phase 1 — Interrogate the use case

Ask these questions conversationally (batch them into one message, don't interrogate one-at-a-time). Adapt wording to what the user has already told you.

1. What does it connect to?

Sponsors

Details

Repository
github.com/anthropics/claude-plugins-official
Categories
Backend & APIs, DevOps & CI/CD, AI & Agent Building, Design & UI/UX
First seen
Apr 16, 2026

More from anthropics/claude-plugins-official

All 24
1jeffallan avatarwebsocket-engineerjeffallan/claude-skillsUse when building real-time communication systems with WebSockets or Socket.IO. Invoke for bidirectional messaging, horizontal scaling with Redis, presence trac7.1Kskills.sh installs
2payloadcms avatarpayloadpayloadcms/skillsUse when working with Payload projects (payload.config.ts, collections, fields, hooks, access control, Payload API). Use when debugging validation errors, secur7.1Kskills.sh installs
3aws avataramazon-aurora-postgresqlaws/agent-toolkit-for-awsAmazon Aurora PostgreSQL — creates, modifies, and advises on Aurora PostgreSQL clusters specifically (PostgreSQL-compatible engine, Aurora serverless, express c6Kskills.sh installs
4affaan-m avatarprisma-patternsaffaan-m/eccPrisma ORM patterns for TypeScript backends — schema design, query optimization, transactions, pagination, and critical traps like updateMany returning count no5.5Kskills.sh installs
5lobehub avatardrizzlelobehub/lobehubLobeHub Drizzle ORM schema and query style. Use for pgTable schemas, indexes, joins, inferred types, db.select/db.query, schema fields, foreign keys, junction t5.5Kskills.sh installs
6apollographql avatargraphql-schemaapollographql/skillsGuide for designing GraphQL schemas following industry best practices. Use this skill when: (1) designing a new GraphQL schema or API, (2) reviewing existing sc4.3Kskills.sh installs