build-mcp-server

Guides developers through designing and scaffolding Model Context Protocol servers for Claude.

1|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/todevelopers/todevelopers-marketplace --skill build-mcp-server-todevelopers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-mcp-server
Source: https://github.com/todevelopers/todevelopers-marketplace/tree/main/plugins/mcp-builder/skills/build-mcp-server
Command: npx skills add https://github.com/todevelopers/todevelopers-marketplace --skill build-mcp-server-todevelopers

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building an MCP server involves early decisions — deployment model, tool-design pattern, framework, and auth — that are painful to reverse later. This Skill replaces guesswork with a structured discovery process that interrogates your use case and recommends the right architecture before any code is written. ## Core Features & Use Cases - Use-case interrogation: Asks targeted questions about what the server connects to, who uses it, how many actions it exposes, and what auth the upstream service requires. - Deployment model recommendation: Chooses between remote streamable-HTTP, MCP apps with UI widgets, MCPB bundled local servers, or local stdio prototypes, with opinionated reasoning. - Tool-design patterns: Applies one-tool-per-action for small API surfaces or the search-plus-execute pattern for large APIs with dozens of endpoints. - Scaffolding and handoff: Scaffolds TypeScript SDK or FastMCP servers inline, or hands off to specialized skills for MCP apps and MCPB packaging. - Use Case: You want to wrap your company's SaaS API so Claude users can query it. The Skill determines you need a remote HTTP server with OAuth via CIMD, recommends the search-plus-execute pattern for your 60 endpoints, and scaffolds a Cloudflare Workers deployment. ## Quick Start Ask Claude to help you build an MCP server that wraps your API, and answer its questions about your use case, users, and authentication requirements.

Frequently Asked Questions about build-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build an MCP server for Claude?

Start by defining what the server connects to and who uses it, then pick a deployment model. Remote streamable-HTTP servers are recommended for cloud APIs, while MCPB suits servers that must run locally. Scaffold with the TypeScript SDK or FastMCP.

Should I use one tool per action or search and execute in MCP?

Use one tool per action when exposing under roughly 15 operations, since Claude reads the full tool list directly. For large APIs with dozens of endpoints, expose search_actions and execute_action tools to keep the context window lean.

TypeScript SDK vs FastMCP for MCP server development?

The official TypeScript SDK offers the best spec coverage and gets new features first. FastMCP 3.x is the choice when you prefer Python or are wrapping a Python library, using decorators with minimal boilerplate.

Does an MCP server support OAuth authentication?

Yes, remote MCP servers support OAuth 2.0 via CIMD, which the spec prefers, or DCR as a backward-compatible fallback. Claude does not support user-pasted bearer tokens or pure client_credentials grants without user consent.

When should I use MCPB instead of a remote MCP server?

Choose MCPB when the server must run on the user's machine, such as reading local files, driving a desktop app, or accessing OS-level APIs. MCPB packages the runtime so users do not need Node or Python installed.

Why does elicitation fail in my MCP tool?

Elicitation fails when the client does not advertise the elicitation capability, causing the SDK to throw CapabilityNotSupported. Check clientCapabilities.elicitation first and provide a text-based fallback that asks Claude to relay the question.