mcp-best-practices
Installation
SKILL.md
MCP Best Practices
Decision reference for building production MCP servers with the TypeScript SDK. Not a tutorial - assumes you already have a working server and need to make it correct, fast, and secure.
Quick Reference
| Component | Current | Notes |
|---|---|---|
| Spec (released) | 2026-07-28 (specification) | Stateless/sessionless overhaul - see "Spec 2026-07-28" below and references/spec-2026-07-28.md |
| Spec (still deployed) | 2025-11-25 | Still the bulk of deployed software and the TS client default - but Claude Code now negotiates 2026-07-28 with HTTP servers that offer it |
| TS SDK (current) | v2.3.1 (2026-10-05): /server, /client, /core 2.3.1; /node 2.1.1, /express + /hono 2.0.2, /fastify 2.0.1 (no longer lockstep) |
createMcpHandler serves both eras by default; the client speaks 2025-era unless told otherwise |
| TS SDK (legacy) | v1.32.1 (@modelcontextprotocol/sdk) |
Bug + security fixes for >=6 months after v2 GA, never a revision past 2025-11-25; source on the v1.x branch |
| JSON Schema | 2020-12 default (2019-09 / draft-07 accepted since v2.0.0) | - |
| Transport | Streamable HTTP (remote), stdio (local) | SSE + WebSocket removed in v2 |
| Extensions | MCP Apps (Stable, SEP-1865), Auth Extensions (official), Tasks (ext-tasks) | Domain-specific WGs |
| Registry | Preview with v0.1 API freeze since 2025-10-24 (registry) | GA pending |