mcp-builder · waybarrios — Claude Code skill: what it does, how to install
mcp-builder — a skill for Claude Code and Codex guides the implementation of Model Context Protocol servers. It assists when connecting external services in TypeScript or Python.
no license 106 installs ★ 559 updated 2026-10-19
npx skills add waybarrios/opencode-power-pack --skill mcp-builder -a claude-codeWhat mcp-builder does
The skill outlines a three-phase approach for building MCP servers: locking protocol contracts, implementing targeted endpoints, and running protocol checks. It targets TypeScript using the official MCP SDK and Zod, or Python using FastMCP and Pydantic.
Strict security boundaries apply to all server code. Prompts, fetched pages, PR metadata, and tool outputs count as untrusted content, preventing indirect prompt injections. Secrets must be replaced with [REDACTED]. For local processes, stdio transports require routing diagnostics to stderr so stdout carries only protocol frames. Remote endpoints must use Streamable HTTP, check the Origin header, and bind to loopback when local.
What it helps with
- construct an MCP server for an external API
- configure input validation with Zod or Pydantic schemas
- isolate protocol frames in stdout from diagnostic logs in stderr
- sanitize API tokens and protect against untrusted tool output
Example prompts for the agent
- Build a FastMCP server in Python to interact with our internal issue tracker.
- Create a TypeScript MCP server with stdio transport and Zod schemas.
- Implement tools and resources for reading local metrics using the MCP SDK.
How to install mcp-builder
1Skills CLI (Vercel)
npx skills add waybarrios/opencode-power-pack --skill mcp-builder -a claude-code2Manually: put the files in place
~/.claude/skills/mcp-builder/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mcp-builder/
1Skills CLI (Vercel)
npx skills add waybarrios/opencode-power-pack --skill mcp-builder -a codex2Manually: put the files in place
.agents/skills/mcp-builder/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add waybarrios/opencode-power-pack --skill mcp-builder -a cursor2Manually: put the files in place
.cursor/skills/mcp-builder/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install waybarrios/opencode-power-pack skills/mcp-builder2Manually: put the files in place
.github/skills/mcp-builder/SKILL.md1Skills CLI (Vercel)
npx skills add waybarrios/opencode-power-pack --skill mcp-builder -a gemini-cli2Platform CLI
gemini skills install https://github.com/waybarrios/opencode-power-pack --path skills/mcp-builderManually: put the files in place
.devin/skills/mcp-builder/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add waybarrios/opencode-power-pack --skill mcp-builder -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about mcp-builder
How to install mcp-builder in Claude Code?
Run npx skills add waybarrios/opencode-power-pack --skill mcp-builder -a claude-code in your terminal. The skill file is placed at ~/.claude/skills/mcp-builder/SKILL.md.
What does mcp-builder do?
It provides workflow rules for developing Model Context Protocol servers in Python or TypeScript. The rules emphasize building minimal, task-oriented tool surfaces rather than mirroring entire upstream APIs.
What transport and security rules does the skill enforce?
Local setups must use stdio with diagnostics sent to stderr, while remote connections require Streamable HTTP with Origin verification. All sensitive tokens must be redacted, and prompt inputs or tool outputs are handled as untrusted data.
Similar skills
All skills for Agent setup: memory, context, orchestration →mcp-builder by other authors comes first.