mcp-builder
mcp-builder covers the essentials of building Model Context Protocol servers, from project structure and transport selection to tool and resource design. It walks through input validation, error handling, multimodal support, and configuration patterns for both local and remote deployments. Follow the included checklist to ensure your server is well-documented, secure, and ready for production use.
mcp-builder teaches you to construct MCP servers with sound architecture, tool patterns, and security practices.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-26
mcp-builder teaches you to construct MCP servers with sound architecture, tool patterns, and security practices. mcp-builder covers the essentials of building Model Context Protocol servers, from project structure and transport selection to tool and resource design. It walks through input validation, error handling, multimodal support, and configuration patterns for both local and remote deployments. Follow the included checklist to ensure your server is well-documented, secure, and ready for production use.
Use it when
- mcp-builder emphasizes designing MCP tools by defining clear input schemas with proper validation, using consistent naming conventions.
- mcp-builder covers MCP server configuration for Claude Desktop by explaining transport setup, authentication patterns including OAuth.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
vudovn/ag-kit/mcp-builder · repository language: TypeScript
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I build MCP servers with proper architecture?
mcp-builder teaches you to construct Model Context Protocol servers by starting with project structure, selecting the right transport (stdio for local, HTTP for remote), and designing tools and resources following best practices. The skill covers tool naming conventions, input schema validation, error handling, and multimodal content support. It includes a production-readiness checklist to ensure your server is well-documented, secure, and properly configured for deployment.
What are MCP tool design best practices?
mcp-builder emphasizes designing MCP tools by defining clear input schemas with proper validation, using consistent naming conventions, and structuring resources with meaningful URI patterns. Best practices include implementing robust error handling, supporting multimodal content where applicable, and documenting tool behavior thoroughly. The skill guides you through patterns that make tools predictable and maintainable for AI clients like Claude.
How do I configure MCP servers for Claude Desktop?
mcp-builder covers MCP server configuration for Claude Desktop by explaining transport setup, authentication patterns including OAuth, and local vs. remote deployment options. You'll learn how to structure your server configuration, validate inputs, and handle errors gracefully. The skill includes practical guidance on testing strategies and a checklist to verify your server meets production requirements before connecting it to Claude Desktop.
What should I know about MCP input schema validation?
mcp-builder teaches MCP input schema validation as a core security and reliability practice. You'll learn to define structured schemas that validate tool parameters, implement proper error handling for invalid inputs, and follow validation patterns that prevent malformed requests. The skill emphasizes validation's role in maintaining server stability and ensuring AI clients receive clear feedback when inputs don't meet requirements.
How do I implement MCP security and error handling?
mcp-builder covers MCP security principles including input validation, proper error handling, and authentication setup (OAuth patterns included). The skill teaches you to design servers that fail safely, return meaningful error messages, and protect against common vulnerabilities. Error handling guidance includes distinguishing between client errors and server issues, logging appropriately, and ensuring your server remains stable under unexpected conditions.
What transport options exist for Model Context Protocol servers?
mcp-builder explains MCP transport choices: stdio for local server-to-client communication (ideal for Claude Desktop integration) and HTTP for remote deployments. The skill helps you select the right transport based on your architecture needs, configure it correctly, and understand the trade-offs. Both transports are covered with practical setup guidance and best practices for production deployment.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
MCP Builder
> Principles for building MCP servers.
1. MCP Overview
What is MCP?
Model Context Protocol - standard for connecting AI systems with external tools and data sources.
Core Concepts
| Concept | Purpose |
|---|---|
| Tools | Functions AI can call |
| Resources | Data AI can read |
| Prompts | Pre-defined prompt templates |
2. Server Architecture
Project Structure
my-mcp-server/
├── src/
│ └── index.ts # Main entry — McpServer from @modelcontextprotocol/sdk
├── package.json # dep: @modelcontextprotocol/sdk
└── tsconfig.json
> TypeScript SDK: @modelcontextprotocol/sdk (McpServer). Python SDK: mcp (pip install "mcp[cli]", FastMCP bundled in mcp.server.fastmcp).
Transport Types
| Type | Use |
|---|---|
| stdio | Local, CLI-based |
(truncated - see the full file via the links below)
File tree — 1 file
.agents/skills/mcp-builder/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Build and deploy MCP servers with proper architecture and tool design”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
A reference guide to building production-ready MCP servers with patterns for transport selection, OAuth authentication, tool composition, and security hardening. Covers 14 decision rules across server setup, advanced features, client integration, and ecosystem discovery, grounded in the latest stable specification.
Learn to develop Model Context Protocol servers across TypeScript, Python, and C# with support for tools, resources, and prompts. This guide covers Streamable HTTP transport configuration, OAuth authentication, and migration from deprecated SSE endpoints.
mcp-builder walks you through the full lifecycle of creating MCP (Model Context Protocol) servers that bridge LLMs and external services. It covers research and planning, implementation in TypeScript or Python, code review practices, and building evaluations to verify your server works effectively with real agents.
Mcp Builder covers the core principles for creating Model Context Protocol servers that connect AI systems to external tools and data. It walks through server architecture, transport options, tool design patterns, resource management, and security practices you'll need to implement. The skill includes configuration guidance, testing strategies, and a practical checklist for production-ready MCP development.
Learn to construct MCP servers using the Node/TypeScript SDK, implementing tools for model invocation, resources for data access, and prompt templates. This skill covers registration patterns, transport selection between stdio for local clients and Streamable HTTP for remote, and validation best practices with Zod.
mcp guides you through building or consuming Model Context Protocol servers and clients in .NET using the official C# SDK. It covers package selection, transport configuration (stdio for local processes, HTTP for remote endpoints), and capability negotiation patterns. Use this skill when you need protocol interoperability; reach for other tools if you only need model abstraction or agent orchestration without the MCP wire protocol.
More skills server-management (MIT)