---
title: "Build an MCP Server: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/anthropic-build-mcp-server/
description: "Interviews the developer about an MCP server before any code, recommends one deployment model and a tool-design pattern, then scaffolds a remote or local stdio server or hands off to the MCP app or MCPB skill."
---

# Build an MCP Server: review, setup & limitations · Undominated.ai

> Interviews the developer about an MCP server before any code, recommends one deployment model and a tool-design pattern, then scaffolds a remote or local stdio server or hands off to the MCP app or MCPB skill.

[← Explore all skills](/skills/)

AI APPLICATION DEVELOPMENT / Anthropic

# Build an MCP Server

Interviews the developer about an MCP server before any code, recommends one deployment model and a tool-design pattern, then scaffolds a remote or local stdio server or hands off to the MCP app or MCPB skill.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/anthropics/claude-plugins-official/tree/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcp-server)

SOURCE REVIEW

 Reviewed 2026-10-22
 Evidence 7 linked sources
 Publisher Anthropic
 Licence [Apache-2.0 ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/LICENSE)
 Revision 41f32e407b45
 [Read what was—and wasn’t—checked ↓](#review)

“This skill should be used when the user asks to "build an MCP server", "create an MCP", "make an MCP integration", "wrap an API for Claude", "expose tools to Claude", "make an MCP app", or discusses building something with the Model Context Protocol. It is the entry point for MCP server development — it interrogates the user about their use case, determines the right deployment model (remote HTTP, MCPB, local stdio), picks a tool-design pattern, and hands off to specialized skills.”

 [Anthropic · upstream description ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcp-server/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Before any scaffolding it asks five questions (what the server connects to, who will use it, how many actions it exposes, whether a tool needs mid-call input or rich UI, and the upstream auth) and then recommends one of four paths: remote streamable HTTP, MCP app, MCPB or local stdio.
- It gives a tool-design rule tied to surface size: one tool per action below about 15 actions, and a search_actions plus execute_action pair for APIs with dozens to hundreds of endpoints.

### A good fit for

 - Choose between a remote streamable-HTTP server, an MCPB bundle and a local stdio prototype before writing MCP server code
- Plan the tool surface for wrapping a large API as a search-and-execute pair
- Pick between the official TypeScript SDK and FastMCP 3.x for a new MCP server

### Weigh up before choosing

 - Last commit touching plugins/mcp-server-dev/skills/build-mcp-server at revision 41f32e40: 2026-04-17 (b00abee2).
- Before answering, the skill tells the agent to fetch https://claude.com/docs/llms-full.txt, so it needs network access to claude.com.
- MCP app and MCPB work is handed to the build-mcp-app and build-mcpb skills of the same plugin; this skill only scaffolds remote HTTP and local stdio servers itself.
- It describes elicitation host support as new: Claude Code shipped it in v2.1.76 and Claude Desktop is unconfirmed, so the skill says to check clientCapabilities.elicitation and keep a fallback.
- Its Phase 6 test, review-criteria and submission steps point to claude.com connector pages that this review did not fetch.
- No install line for the mcp-server-dev plugin is printed in its README or elsewhere in the repository at this revision.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - plugins/mcp-server-dev/skills/build-mcp-server/SKILL.md
- plugins/mcp-server-dev/README.md
- plugins/mcp-server-dev/LICENSE
- README.md
- .claude-plugin/marketplace.json (mcp-server-dev entry)
- plugins/mcp-server-dev/skills/build-mcp-server/references/remote-http-scaffold.md (install, test and hosting commands)
- plugins/mcp-server-dev/skills/build-mcp-server/references/deploy-cloudflare-workers.md (bootstrap, run and deploy commands)

### Our findings

 - The SKILL.md frontmatter has name, description and version only; no allowed-tools are declared.
- Remote streamable HTTP is the default recommendation for anything wrapping a cloud API; local stdio via npx or uvx is "not recommended for distribution", fine for personal tools and prototypes, and scaffolded only if the user insists
- For OAuth upstreams it says a remote server with CIMD (preferred) or DCR support is needed and points to references/auth.md.
- Besides tools, it tabulates resources, prompts, elicitation and sampling, with who triggers each and when to use it.

### Not established by this review

 - No server was scaffolded, deployed or tested against Claude.
- references/tool-design.md, auth.md, resources-and-prompts.md, elicitation.md, server-capabilities.md and versions.md were not opened; remote-http-scaffold.md and deploy-cloudflare-workers.md were read for their commands only.
- Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/README.md)
 - The mcp-server-dev README prints no install line. It says to ask Claude to "help me build an MCP server", or to invoke `/mcp-server-dev:build-mcp-server` directly.
- The repository README gives `/plugin install {plugin-name}@claude-plugins-official` with the plugin name as a placeholder; the marketplace file lists this plugin as mcp-server-dev. No file prints a filled-in line, so install.command is null.
- The plugin holds three skills, build-mcp-server, build-mcp-app and build-mcpb; installing it brings all three.
- This review installed nothing.

### Before you start

 - Claude Code
- Network access to claude.com for the documentation fetch the skill asks for

### Compatibility

Claude Code

### Guidance that fetches claude.com documentation and can scaffold MCP server code

 - Tool use follows the session's permissions; build-mcp-server sets no allowed-tools
- Network: fetches https://claude.com/docs/llms-full.txt before answering questions or scaffolding
- Phase 5 scaffolds in the user's project: remote-http-scaffold.md runs npm init and npm install @modelcontextprotocol/sdk zod express, or pip install fastmcp, and tests with npx @modelcontextprotocol/inspector
- The Cloudflare path in deploy-cloudflare-workers.md runs npm create cloudflare@latest with the remote-mcp-authless template, then npx wrangler dev and npx wrangler deploy to a workers.dev URL, with secrets set through npx wrangler secret put

### Cost model

Apache-2.0 per plugins/mcp-server-dev/LICENSE; deploy-cloudflare-workers.md says its path starts on Cloudflare's free tier with no credit card, and remote-http-scaffold.md names Render, Railway, Fly.io or a VPS as other hosts, with no prices

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [build-mcp-server SKILL.md ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcp-server/SKILL.md) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcp-server/SKILL.md Supports: upstreamDescription, summary, whySelected[0], whySelected[1], bestFor[0], bestFor[1], bestFor[2], limitations[1], limitations[2], limitations[3], limitations[4], review.findings[0], review.findings[1], review.findings[2], review.findings[3], access.permissions[0], access.permissions[1], access.permissions[2], install.prerequisites[1], compatibility
- [mcp-server-dev README ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/README.md) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/README.md Supports: install.sourceUrl, install.steps[0], install.steps[2], limitations[2], limitations[5], summary
- [build-mcp-server references/remote-http-scaffold.md ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcp-server/references/remote-http-scaffold.md) Checked 2026-10-22 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcp-server/references/remote-http-scaffold.md Supports: access.permissions[2], access.cost
- [build-mcp-server references/deploy-cloudflare-workers.md ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcp-server/references/deploy-cloudflare-workers.md) Checked 2026-10-22 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcp-server/references/deploy-cloudflare-workers.md Supports: access.permissions[3], access.cost
- [mcp-server-dev LICENSE ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/LICENSE) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/LICENSE Supports: license, access.cost
- [Repository README, installation ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/README.md) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/README.md Supports: install.steps[1], install.prerequisites[0], compatibility
- [Marketplace file, mcp-server-dev entry ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/.claude-plugin/marketplace.json) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/.claude-plugin/marketplace.json Supports: install.steps[1]

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Build an MCP App (Interactive UI Widgets) ↗ Adds interactive UI widgets (forms, pickers, confirm dialogs, charts) to an MCP server: the tool declares a ui:// resource, the server serves the widget HTML, and the host renders it in a sandboxed iframe in the chat.](/skills/anthropic-build-mcp-app/)[### Build an MCPB (Bundled Local MCP Server) ↗ Packages a local stdio MCP server with its runtime and dependencies into a .mcpb zip archive with a manifest.json, so a user can install it without setting up Node or Python.](/skills/anthropic-build-mcpb/)[### OpenAI Agents SDK Workflow ↗ Builds a small Agents SDK application around an explicit workflow contract, then checks the real agent path and optional local deployment.](/skills/openai-agents-sdk/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
