Iron Law

Never publish an MCP server without testing all tool schemas against the MCP spec; always validate tool descriptions are >= 10 words and parameters are fully typed.

MCP Server Development Guide

Create MCP servers that enable LLMs to interact with external services through well-designed tools.

High-Level Workflow

Phase 1: Research and Plan

• Study MCP spec from https://modelcontextprotocol.io/sitemap.xml (append .md for markdown)
• Fetch TypeScript SDK README from https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/main/README.md
• Fetch Python SDK README from https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/main/README.md
• Load design principles, agent patterns, and error taxonomy from reference files (see table below)

Phase 2: Implement