mcp-builder SKILL.md skillA

This file is byte-identical to the first copy the registry indexed, one of 17 indexed copies. Same content hash, so the same checks give both the same grade.

mcp-builder from nicholyx/ai-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nicholyx/ai-skills/mcp-builder@git:20260516.4d9ab13

Pins git:20260516.4d9ab13 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
nicholyx/ai-skills
Path
.agents/skills/mcp-builder/SKILL.md
Versions recorded
1
Latest version
git:20260516.4d9ab13, committed May 16, 2026
Size
9,092 bytes
Repository stars
6
License
Apache-2.0

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# MCP Server Development Guide

## Overview

Create MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. The quality of an MCP server is measured by how well it enables LLMs to accomplish real-world tasks.

---

# Process

## 🚀 High-Level Workflow

Creating a high-quality MCP server involves four main phases:

### Phase 1: Deep Research and Planning

#### 1.1 Understand Modern MCP Design

**API Coverage vs. Workflow Tools:**
Balance comprehensive API endpoint coverage with specialized workflow tools. Workflow tools can be more convenient for specific tasks, while comprehensive coverage gives agents flexibility to compose operations. Performance varies by client—some clients benefit from code execution that combines basic tools, while others work better with higher-level workflows. When uncertain, prioritize comprehensive API coverage.

**Tool Naming and Discoverability:**
Clear, descriptive tool names help agents find the right tools quickly. Use consistent prefixes (e.g., `github_create_issue`, `github_list_repos`) and action-oriented naming.

**Context Management:**
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nicholyx/ai-skills/mcp-builder@sha256:0f4592dcb53cf2b5

The line at the top of this page pins the label git:20260516.4d9ab13, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_niolvxg6ypn2aqxj.svg)](https://markdownregistry.com/a/art_niolvxg6ypn2aqxj)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on May 16, 2026.

versioncommittedcommitsizeaudit
git:20260516.4d9ab13 latest2026-05-16 4d9ab13 9,092 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9092 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

nicholyx/ai-skills · 6 stars · license Apache-2.0 · pushed 2026-10-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_niolvxg6ypn2aqxj
GET https://markdownregistry.com/api/v1/resolve?ref=nicholyx/ai-skills/mcp-builder
GET https://markdownregistry.com/api/v1/blob/0f4592dcb53cf2b5d6b7febee6b4152018b565551a1c29e3c612f57b218ab295

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from nicholyx/ai-skills

agent-browser SKILL.md skill
nicholyx/ai-skills · .agents/skills/agent-browser/SKILL.md · Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages…
git:20260516.dd241a9 · audit A · 6 stars
architecture-designer SKILL.md skill
nicholyx/ai-skills · .agents/skills/architecture-designer/SKILL.md · Use when designing new high-level system architecture, reviewing existing designs, or making architectural decisions…
v1.1.1 · audit A · 6 stars
architecture-patterns SKILL.md skill
nicholyx/ai-skills · .agents/skills/architecture-patterns/SKILL.md · Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven…
git:20260516.dd241a9 · audit A · 6 stars
browser-use SKILL.md skill
nicholyx/ai-skills · .agents/skills/browser-use/SKILL.md · Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs…
git:20260516.dd241a9 · audit A · 6 stars
deep-research SKILL.md skill
nicholyx/ai-skills · .agents/skills/deep-research/SKILL.md · Use when the user needs multi-source research with citation tracking, evidence persistence, and structured report…
git:20260516.dd241a9 · audit A · 6 stars
docx SKILL.md skill
nicholyx/ai-skills · .agents/skills/docx/SKILL.md · Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers…
git:20260516.4d9ab13 · audit A · 6 stars
enhance-prompt SKILL.md skill
nicholyx/ai-skills · .agents/skills/enhance-prompt/SKILL.md · Transforms vague UI ideas into polished, Stitch-optimized prompts. Enhances specificity, adds UI/UX keywords, injects…
git:20260516.4d9ab13 · audit A · 6 stars
AGENTS.md@.agents/skills/extension-dev-skill AGENTS.md file
nicholyx/ai-skills · .agents/skills/extension-dev-skill/AGENTS.md
git:20260516.9c51e17 · audit A · 6 stars
extension-dev-skill SKILL.md skill
nicholyx/ai-skills · .agents/skills/extension-dev-skill/SKILL.md · AI Skill for building EasyEDA Pro extension plugins. Used when users need to create, modify, or debug EasyEDA Pro…
v2.0.0 · audit A · 6 stars
find-skills SKILL.md skill
nicholyx/ai-skills · .agents/skills/find-skills/SKILL.md · Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is…
git:20260516.4d9ab13 · audit A · 6 stars
frontend-design SKILL.md skill
nicholyx/ai-skills · .agents/skills/frontend-design/SKILL.md · Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to…
git:20260516.4d9ab13 · audit A · 6 stars
gh-cli SKILL.md skill
nicholyx/ai-skills · .agents/skills/gh-cli/SKILL.md · GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists…
git:20260516.4d9ab13 · audit A · 6 stars

Every file in nicholyx/ai-skills

Other files named mcp-builder

mcp-builder SKILL.md skill
anthropics/skills · skills/mcp-builder/SKILL.md · Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external…
git:20251201.ef74077 · audit A · 182,395 stars
mcp-builder SKILL.md skill
jnmetacode/superpowers-zh · skills/mcp-builder/SKILL.md · 在构建 MCP 服务器或 MCP 工具时使用 —— 系统化的生产级 MCP 构建方法论,覆盖工具设计、错误处理、传输层选择与测试,让 AI 助手连接外部能力
v1.0.0 · audit A · 8,348 stars
mcp-builder SKILL.md skill
thinkinaixyz/deepchat · resources/skills/mcp-builder/SKILL.md · Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external…
git:20260113.8fd50e4 · audit A · 6,371 stars
mcp-builder SKILL.md skill
davepoon/buildwithclaude · plugins/all-skills/skills/mcp-builder/SKILL.md · Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external…
git:20260104.903b22f · audit A · 3,660 stars
mcp-builder SKILL.md skill
platonai/browser4 · browser4-agentic/src/main/resources/skills/mcp-builder/SKILL.md · Guide for creating advanced-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external…
git:20260526.099a5a1 · audit A · 1,164 stars
mcp-builder SKILL.md skill
keyuchen21/agentic-engineering-handbook · tutorials/agent-loop/skills/mcp-builder/SKILL.md · Build MCP (Model Context Protocol) servers that give Claude new capabilities. Use when user wants to create an MCP…
git:20260613.5c7b9b8 · audit A · 558 stars
mcp-builder SKILL.md skill
kocoro-lab/kocoro · internal/skills/bundled/skills/mcp-builder/SKILL.md · Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external…
git:20260313.0cda0f4 · audit A · 415 stars
mcp-builder SKILL.md skill
enuno/unifi-mcp-server · .agents/skills/mcp-builder/SKILL.md · Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external…
git:20260812.34020a0 · audit A · 303 stars

Browse by kind, by grade A, or by owner.