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
Installs
82
Repository
tenequm/skills
GitHub Stars
39
First Seen
Mar 25, 2026