Skip to main content
skill CX Codex

mcp-builder · dkyazzentwatwa — Claude Code skill: design MCP servers

mcp-builder — a skill for planning and building MCP servers with tools, schemas, error handling, and evaluation. Use when creating or refactoring MCP integrations.

Apache-2.0 198 installs ★ 136 updated 2026-04-08

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a claude-code
Open on GitHub

What mcp-builder does

This skill teaches agents to structure MCP servers around user workflows rather than raw API endpoints. The approach starts by reading target API documentation and identifying end-to-end scenarios the agent must complete, then designs a focused tool surface with clear identifiers and corrective error messages.

The skill includes design principles for every server, implementation patterns for Python and TypeScript, and helper scripts for testing connections and evaluating server behavior. Infrastructure comes first: authentication, request helpers, pagination, data truncation, and output formatting.

Output is concise and high-signal by default. Human-readable identifiers replace opaque IDs. Error messages tell the agent what to try next rather than just reporting failure. The whole approach assumes limited context and large datasets.

What it helps with

  • Design MCP server tools tied to agent workflows
  • Write tool schemas and docstrings that guide correct automation usage
  • Turn API errors into corrective messages agents can act on
  • Evaluate an MCP server against realistic tasks before launch
  • Build shared infrastructure: auth, request helpers, pagination, formatting

Example prompts for the agent

  • Design an MCP server for Stripe: identify workflows and build a tool inventory
  • Write schemas for S3 file tools with clear error messages and retry guidance
  • Evaluate the MCP server: agent creates a payment and sends a notification

How to install mcp-builder

1Skills CLI (Vercel)

npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a claude-code

2Manually: put the files in place

~/.claude/skills/mcp-builder/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/mcp-builder/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about mcp-builder

How do I install mcp-builder in Claude Code?

Run npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a claude-code, then open ~/.claude/skills/mcp-builder/SKILL.md.

What does mcp-builder do?

It guides agent-friendly MCP server design around workflows, not endpoints. Includes templates for tool schemas, error handling, shared auth and request infrastructure, and evaluation prompts.

What languages does the skill cover?

Python and TypeScript, with separate guides for implementation patterns in each.

Source text

SKILL.md · Apache-2.0
---
name: mcp-builder
description: Plan and build MCP servers with agent-friendly tools, schemas, error handling, and evaluation. Use when creating or refactoring MCP integrations.
---

# MCP Builder

Build MCP servers around user workflows, not raw API endpoints.

## Workflow

1. Read the target API docs and identify the workflows an agent must complete end to end.
2. Design a small tool surface with high-signal outputs, clear identifiers, and actionable errors.
3. Implement shared infrastructure first: auth, request helpers, pagination, truncation, and formatting.
4. Add tool schemas and docstrings that make correct usage obvious.
5. Evaluate the server with realistic tasks before expanding scope.

## Principles

- Prefer workflow tools over thin endpoint wrappers.
- Return concise, high-signal responses by default.
- Use human-readable identifiers whenever possible.
- Make error messages corrective: tell the agent what to try next.
- Design for limited context and large datasets.

## Resources

- `references/mcp_best_practices.md` for design principles that apply to every server.
- `references/python_mcp_server.md` for Python implementation patterns.
- `references/node_mcp_server.md` for TypeScript implementation patterns.
- `scripts/connections.py` and `scripts/evaluation.py` as repo-local helpers.

## Deliverables

- A concrete tool inventory tied to user workflows.
- Strict input/output schemas.
- Evaluation prompts or scripts that confirm the server is usable by an agent.

© dkyazzentwatwa · Apache-2.0 · dkyazzentwatwa/chatgpt-skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

mcp-builder by other authors comes first.

mcp-builder official anthropics mcp-builder guides the agent through building Model Context Protocol servers in TypeScript or Python. It helps design tool schemas, integrate external APIs, and test transports. CX Codex +1 130,949installs mcp-builder jezweb mcp-builder — a skill that takes a short brief and turns it into a deployable MCP server on Python with FastMCP, complete with local tests and a pre-deploy checklist. CX Codex +1 1,400installs mcp-builder waybarrios 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. CX Codex +1 106installs mcp-builder shareAI-lab mcp-builder is a Claude Code and Codex skill that guides an agent through building MCP servers. It activates to give the agent tools, read-only resources, or access to external services. CX Codex +1 ★ 80,707repo stars mcp-builder mcp-use The mcp-builder skill guides MCP server development with mcp-use, from project scaffolding to local inspection and deployment. CX Codex +1 735installs track17 tristanmanchester track17 is a Claude Code skill that registers and tracks parcels through the 17TRACK API, stores delivery events, and handles webhooks. It integrates parcel tracking into an agent workflow. CX Codex +1 104installs build-mcp-server official Anthropic The build-mcp-server skill helps design an MCP server for Claude Code by clarifying the use case, choosing deployment, and shaping the tool interface. CX Codex +1 6,711installs Vivaldo Product Discovery vivaldoeuropes Vivaldo Product Discovery — an MCP server to find and browse products from the Vivaldo European store directly in your IDE. Integrates with Claude Code, Cursor, GitHub Copilot, and other MCP-compatible editors. CX Codex +1 7,716installs cisco-meraki membrane A skill to query and manage Cisco Meraki cloud networking through the terminal. Read organizations, networks, devices, and VLANs; create and update configurations without logging into the dashboard. CX Codex +1 246installs shopify membrane Work with Shopify data directly in your IDE: manage products, orders, and customers via Membrane CLI. Requires a Membrane account (free tier supported). CX Codex +1 240installs runway-dev-recipes runwayml runway-dev-recipes is a skill that integrates Runway Dev API Recipes for image and video generation via the SDK, with server-side calls and UI loading states. CX Codex +1 217installs

From the same set12

The whole set →
document-converter-suite document-converter-suite turns PDFs, Office files, markdown, HTML and tables into editable formats. Useful when you need data out of a document or a rebuilt copy of it. CX Codex +1 495installs image-enhancement-suite The image-enhancement-suite skill for Claude Code processes images in chat with an agent, including background removal, sprite sheet generation, and palette extraction. CX Codex +1 308installs svg-precision-skill svg-precision-skill — a skill for Claude Code, Codex, Cursor, Copilot and others: builds SVG from explicit coordinates and dimensions, validates output before delivery. Used for icons, diagrams, charts, UI mockups and technical drawings. CX Codex +1 306installs qr-code-generator qr-code-generator creates print-ready and web QR codes with clean HTTPS links, optional UTM tags, and batch processing. CX Codex +1 252installs data-storyteller data-storyteller turns CSV and spreadsheets into narrative reports with charts, quality audits, and statistics. Built for exploratory analysis and executive outputs. CX Codex +1 241installs media-toolkit The media-toolkit skill for Claude Code clips, converts, and analyzes audio and video with Python scripts. It handles captions, timelapses, GIFs, and batch operations. CX Codex +1 184installs skill-creator skill-creator — a skill for creating skills: generates folder structure, SKILL.md, agent metadata, and validates everything before packaging. CX Codex +1 167installs geo-toolkit A set of tools for working with geographic information: address normalization, format conversion, geocoding, and distance calculations. Use it when you need to prepare coordinates for mapping or standardize addresses from different sources. CX Codex +1 139installs

Project sponsors

Companies that keep this analytics open