
Knowledge-search tool illustration showing input JSON, tool structure and local results; not a recording of an MCP connection.
Project screenshotsAbout this Skill
Design and implement MCP servers with discoverable tools, clear schemas and task-based evaluations. Python/FastMCP or TypeScript/MCP SDK; service credentials only when the target integration needs them.
Why we picked it
Useful for turning an API or service into tools an agent can discover and use. It covers research, implementation, review and evaluation, including concise results, pagination and actionable errors.
What it helps with
- Expose a service API through MCP.
- Design a searchable knowledge tool.
- Evaluate an MCP server's usability.
How this skill works
1. Research the target service and tool boundaries
Study the protocol and service API, then define tool names, input schemas and bounded result formats.
2. Implement a Python or TypeScript MCP server
Implement the server using the appropriate Python or TypeScript SDK and explicit error handling.
3. Review tool contracts and construct evaluation tasks
Inspect the server and evaluate whether tool calls help an agent complete realistic tasks.
An example task
Try this brief: “Design an MCP tool that searches a fictional local project knowledge base.”
The preview is an original SkillHey illustration of this task. Its content is fictional and is not an official Anthropic screenshot or an agent benchmark.
Second example
Try this brief: “Design a paginated MCP search result with a clear cursor and bounded page size.”
Install this skill or its official plugin
For this skill alone, copy its complete directory into the project Skills root using the command above. The final entry is .claude/skills/mcp-builder/SKILL.md. Keep references, scripts and assets with it.
| Command | What it helps with |
|---|---|
/plugin marketplace add anthropics/skills | Register the official Claude Code marketplace. |
/plugin install example-skills@anthropic-agent-skills | Install the official plugin. This may include other skills; see its manifest. |
Official repository and plugin manifestClaude Code skill installation documentation
Dependencies and license
Python/FastMCP or TypeScript/MCP SDK; service credentials only when the target integration needs them.
The recipe is free to access; running an agent or external service may have its own costs.
Review this skill’s LICENSE.txt before redistributing its files.
Official mcp-builder instructionsOfficial repository and plugin manifest
Before you use it
- Python/FastMCP or TypeScript/MCP SDK; service credentials only when the target integration needs them.
Supported agents
Frequently asked questions
Is this a separate skill?
Yes. mcp-builder has its own SKILL.md and directory. It also belongs to the Anthropic Official Skills topic.
Official sources
Based on official documentation, with practical scenarios suggested by SkillHey.



