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), Node/TypeScript (MCP SDK), or C#/.NET (Microsoft MCP SDK).
83
73%
Does it follow best practices?
Impact
100%
2.50xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./.github/skills/mcp-builder/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a solid skill description with excellent trigger term coverage across multiple language ecosystems and a clear 'Use when' clause. Its main weakness is that the 'what' portion is somewhat high-level—it describes the general purpose of MCP servers rather than listing specific concrete actions the skill teaches (e.g., defining tool schemas, handling authentication, structuring server endpoints). Overall it performs well for skill selection purposes.
Suggestions
Add 2-3 more specific concrete actions to the 'what' portion, e.g., 'define tool schemas, handle authentication, structure request handlers, validate inputs' to improve specificity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (MCP servers) and a general action ('creating high-quality MCP servers that enable LLMs to interact with external services through well-designed tools'), but it doesn't list multiple specific concrete actions like 'define tool schemas, handle authentication, implement request routing, validate inputs'. | 2 / 3 |
Completeness | Clearly answers both 'what' (creating MCP servers that enable LLMs to interact with external services through well-designed tools) and 'when' (explicit 'Use when building MCP servers to integrate external APIs or services' with language-specific triggers). The 'Use when...' clause is present and explicit. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'MCP', 'Model Context Protocol', 'MCP servers', 'external APIs', 'services', 'Python', 'FastMCP', 'Node', 'TypeScript', 'MCP SDK', 'C#', '.NET', 'Microsoft MCP SDK'. Good coverage of language-specific variations and the core protocol name. | 3 / 3 |
Distinctiveness Conflict Risk | MCP server development is a very specific niche. The description targets a distinct protocol (Model Context Protocol) with specific frameworks (FastMCP, MCP SDK, Microsoft MCP SDK), making it highly unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured MCP server development guide that excels at progressive disclosure and organization, effectively serving as a hub document pointing to detailed reference files. However, it sacrifices actionability by deferring nearly all concrete code examples to reference files, leaving the main body somewhat abstract. The workflow is logically sequenced but would benefit from explicit validation checkpoints and feedback loops, and the content could be tightened by removing the duplicative Reference Files section that restates what's already covered in the workflow phases.
Suggestions
Add at least one minimal but executable code example in the main body (e.g., a basic tool registration in TypeScript or Python) to improve actionability without requiring reference file loading.
Add explicit validation checkpoints with feedback loops in Phase 3, e.g., 'If build fails: check type errors → fix → rebuild. If Inspector test fails: review tool descriptions → adjust → retest.'
Consolidate the Reference Files section with the inline references already present in the workflow phases to reduce duplication and improve conciseness—the same files are referenced twice with similar descriptions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately efficient but includes some unnecessary verbosity—e.g., the Microsoft MCP ecosystem section is extensive and partially duplicative with the referenced files. The Reference Files section at the bottom largely repeats information already presented in the workflow phases. However, it avoids explaining basic concepts Claude would already know. | 2 / 3 |
Actionability | The skill provides structured guidance with specific tool names, SDK references, and some concrete commands (e.g., `npm run build`, `npx @modelcontextprotocol/inspector`), but lacks executable code examples in the main body. Most implementation details are deferred to reference files, and inline guidance is more descriptive than copy-paste ready (e.g., 'Create shared utilities: API client with authentication' without showing how). | 2 / 3 |
Workflow Clarity | The four-phase workflow is clearly sequenced and logically organized, but validation checkpoints are weak. Phase 3 mentions 'Review and Test' but lacks explicit feedback loops (e.g., what to do if build fails, how to iterate on tool descriptions). For a process involving code generation and server deployment, the absence of explicit validate-fix-retry loops is notable. | 2 / 3 |
Progressive Disclosure | The skill excels at progressive disclosure with a clear overview structure that points to well-organized, one-level-deep reference files (python_mcp_server.md, node_mcp_server.md, microsoft_mcp_patterns.md, evaluation.md, mcp_best_practices.md). References are clearly signaled with emoji markers and brief descriptions of what each file contains. Content is appropriately split between the overview and detailed guides. | 3 / 3 |
Total | 9 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
10cfecf
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.