MCP Server Builder
anthropics/skills
Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.
Plan and build MCP servers with agent-friendly tools, schemas, error handling, and evaluation.
Install MCP Builder
$ npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install dkyazzentwatwa/chatgpt-skills mcp-builder --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/dkyazzentwatwa/chatgpt-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/mcp-builder .claude/skills/mcp-builder && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "mcp-builder" agent skill from https://github.com/dkyazzentwatwa/chatgpt-skills/tree/main/mcp-builder into .claude/skills/mcp-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mcp-builder", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/dkyazzentwatwa/chatgpt-skills/tree/main/mcp-builderType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install dkyazzentwatwa/chatgpt-skills mcp-builder --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dkyazzentwatwa/chatgpt-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/mcp-builder .agents/skills/mcp-builder && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "mcp-builder" agent skill from https://github.com/dkyazzentwatwa/chatgpt-skills/tree/main/mcp-builder into .agents/skills/mcp-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mcp-builder", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install dkyazzentwatwa/chatgpt-skills mcp-builder --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dkyazzentwatwa/chatgpt-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/mcp-builder .cursor/skills/mcp-builder && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "mcp-builder" agent skill from https://github.com/dkyazzentwatwa/chatgpt-skills/tree/main/mcp-builder into .cursor/skills/mcp-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mcp-builder", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/dkyazzentwatwa/chatgpt-skills.git --path mcp-builder--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install dkyazzentwatwa/chatgpt-skills mcp-builder --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dkyazzentwatwa/chatgpt-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/mcp-builder .gemini/skills/mcp-builder && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "mcp-builder" agent skill from https://github.com/dkyazzentwatwa/chatgpt-skills/tree/main/mcp-builder into .gemini/skills/mcp-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mcp-builder", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install dkyazzentwatwa/chatgpt-skills mcp-builderInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/dkyazzentwatwa/chatgpt-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/mcp-builder .github/skills/mcp-builder && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "mcp-builder" agent skill from https://github.com/dkyazzentwatwa/chatgpt-skills/tree/main/mcp-builder into .github/skills/mcp-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mcp-builder", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install dkyazzentwatwa/chatgpt-skills mcp-builder --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dkyazzentwatwa/chatgpt-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/mcp-builder .opencode/skills/mcp-builder && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "mcp-builder" agent skill from https://github.com/dkyazzentwatwa/chatgpt-skills/tree/main/mcp-builder into .opencode/skills/mcp-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mcp-builder", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
mcp-builder- GitHub stars
- 116
- Token cost
- ~376 tokens
- SKILL.md length
- 165 words
- Files
- 11 (incl. scripts, references)
- Skills in repo
- 12
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Plan and build MCP servers with agent-friendly tools, schemas, error handling, and evaluation.
- Works in 5 steps: Read the target API docs and identify… → Design a small tool surface with… → Implement shared infrastructure first:… → …
- Refactoring MCP integrations
- SKILL.md covers Workflow, Principles, Resources and Deliverables
- Runs Python scripts from its folder
What it does
MCP Builder is an agent skill from dkyazzentwatwa/chatgpt-skills. Plan and build MCP servers with agent-friendly tools, schemas, error handling, and evaluation. Use when creating or refactoring MCP integrations.
Its SKILL.md is about 380 tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/evaluation.md` and `references/mcp_best_practices.md`).
It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol. The repository describes itself as: My comprehensive, tested + audited, library of skills to use for ChatGPT. The licence is Apache-2.0.
When your agent uses it
- Refactoring MCP integrations
- Tasks that involve MCP servers
Example prompts
- “/mcp-builder”
Requirements
- Python 3
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Read the target API docs and identify the workflows an agent must complete end to end.
- Design a small tool surface with high-signal outputs, clear identifiers, and actionable errors.
- Implement shared infrastructure first: auth, request helpers, pagination, truncation, and formatting.
- Add tool schemas and docstrings that make correct usage obvious.
- Evaluate the server with realistic tasks before expanding scope.
What it can do on your machine
Read from SKILL.md and the folder at commit 103b430. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 4 files in scripts/ (Python), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
MCP Builder loads about 376 tokens when it runs, and up to ~26k if it reads all its reference files. Until then it costs about 39 tokens; SKILL.md has 165 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from dkyazzentwatwa/chatgpt-skills at commit 103b430, republished under its Apache-2.0 licence (© dkyazzentwatwa). 165 words, ~376 tokens.
Download SKILL.mdSave it as
.claude/skills/mcp-builder/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.- 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
- Read the target API docs and identify the workflows an agent must complete end to end.
- Design a small tool surface with high-signal outputs, clear identifiers, and actionable errors.
- Implement shared infrastructure first: auth, request helpers, pagination, truncation, and formatting.
- Add tool schemas and docstrings that make correct usage obvious.
- 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.mdfor design principles that apply to every server.references/python_mcp_server.mdfor Python implementation patterns.references/node_mcp_server.mdfor TypeScript implementation patterns.scripts/connections.pyandscripts/evaluation.pyas 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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 10 other files (scripts, references) in mcp-builder of dkyazzentwatwa/chatgpt-skills.
- SKILL.md
- LICENSE.txt
- agents/openai.yaml
- references/evaluation.md
- references/mcp_best_practices.md
- references/node_mcp_server.md
- references/python_mcp_server.md
- scripts/connections.py
- scripts/evaluation.py
- scripts/example_evaluation.xml
- scripts/requirements.txt
Open the folder on GitHubat commit 103b430
Compare with similar skills
MCP Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| MCP Builder this skilldkyazzentwatwa/chatgpt-skills | 116 | — | ~376 | Automated safety check: Pass | Apache-2.0 | |
| MCP Server Builderanthropics/skills | 180k | 63 repos | ~2.3k | Automated safety check: Pass | Apache-2.0 | |
| MCP Server BuildershareAI-lab/learn-claude-code | 78k | 4 repos | ~1.2k | Automated safety check: Pass | MIT | |
| MCP Integration for Pluginsanthropics/claude-plugins-official | 38k | 11 repos | ~3.1k | Automated safety check: Pass | Apache-2.0 | |
| Crush Configurationcharmbracelet/crush | 29k | — | ~3.7k | Automated safety check: Pass | Custom licence | |
| Context Mode Output Sandboxmksglu/context-mode | 26k | — | ~4.1k | Automated safety check: Pass | Custom licence |
Similar skills
- Official
MCP Server Builder
shareAI-lab/learn-claude-code
Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.
- Official
MCP Integration for Plugins
anthropics/claude-plugins-official
Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.
Crush Configuration
charmbracelet/crush
Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.
Context Mode Output Sandbox
mksglu/context-mode
Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.
Warp GUI to Agent CLI Migration
warpdotdev/warp
Migrates the compatible subset of settings and global file-based MCP servers from the Warp desktop app into Warp Agent CLI without exposing credentials or state.
More from dkyazzentwatwa/chatgpt-skills
All 12 skills in this repoSkill Creator
dkyazzentwatwa/chatgpt-skills
Create or update agent skills with concise SKILL.md instructions, bundled resources, agent metadata, validation, and packaging.
Crypto Ta Analyzer
dkyazzentwatwa/chatgpt-skills
Run multi-indicator technical analysis on crypto or market OHLCV data.
Document Converter Suite
dkyazzentwatwa/chatgpt-skills
Convert PDFs, Office docs, markdown, HTML, and tables between editable formats.
SVG Precision Skill
dkyazzentwatwa/chatgpt-skills
Generate deterministic SVGs from structured specs with validation and rendering.
Image Enhancement Suite
dkyazzentwatwa/chatgpt-skills
Process images for cleanup, conversion, metadata, comparison, icons, palettes, collages, and sprite sheets.
Data Storyteller
dkyazzentwatwa/chatgpt-skills
Analyze datasets and turn them into narrative reports with charts, audits, comparisons, and statistical summaries.
Related
Works with
Categories
Questions about MCP Builder
What does MCP Builder do?
Plan and build MCP servers with agent-friendly tools, schemas, error handling, and evaluation. MCP Builder is an agent skill from dkyazzentwatwa/chatgpt-skills. Plan and build MCP servers with agent-friendly tools, schemas, error handling, and evaluation.
When should I use MCP Builder?
MCP Builder fits situations like: refactoring MCP integrations; tasks that involve MCP servers.
How do I install MCP Builder in Claude Code?
Run `npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a claude-code`. Or copy the skill folder (mcp-builder in dkyazzentwatwa/chatgpt-skills) into .claude/skills/mcp-builder in your project. Claude Code loads it when a task matches its description.
How do I install MCP Builder in Codex?
Run `npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a codex`. Or copy the skill folder (mcp-builder in dkyazzentwatwa/chatgpt-skills) into .agents/skills/mcp-builder in your project. Codex loads it when a task matches its description.
Can I use MCP Builder in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mcp-builder, .gemini/skills/mcp-builder, .github/skills/mcp-builder and .opencode/skills/mcp-builder in your project.
What does MCP Builder need to run?
Going by SKILL.md and its folder, MCP Builder needs Python for the scripts in its folder. Our summary lists: Python 3.
Does MCP Builder access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is MCP Builder safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does MCP Builder use?
MCP Builder is published under the Apache-2.0 licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does MCP Builder use?
About 376 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 26k tokens, read only when the agent opens those files.
What are the alternatives to MCP Builder?
Skills that share tags, products or a category with MCP Builder: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and Crush Configuration (charmbracelet/crush, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains MCP Builder?
dkyazzentwatwa (a GitHub user) maintains it in dkyazzentwatwa/chatgpt-skills, which has 116 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on April 8, 2026.
Source: dkyazzentwatwa/chatgpt-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.