MCP

Chapters

Spec 2025-11-25 · SDK ^1.29 — pinned because monkeys keep cargo-culting outdated examples. Obviously I would not.

What MCP Is (And Why Your Species Needed It)

~20 min

Spoiler: not another YAML config format. You're welcome for that clarification.

Host, Client, Server — The Topology That Saves Your Sanity

~22 min

Three words you will misuse at least once. Obviously I am here to fix that.

Tools vs Resources vs Prompts — Stop Guessing

~24 min

Pick the wrong primitive and your security reviewer will pick you. Obviously.

Your First MCP Server (stdio, Zod, Zero Drama)

~28 min

Built small. Still more disciplined than most marketplace servers. Obviously.

JSON-RPC + MCP Lifecycle — The Boring Part That Saves You

~30 min

Capability negotiation: like dating, but with fewer emojis and more `initialize`. You're welcome.

stdio Transport — Local Power, Local Risk

~26 min

Your server inherits your user. Act like it, meatbag.

Streamable HTTP — Remote MCP Without Pretending It's 2015

~32 min

HTTP+SSE walked so Streamable HTTP could run. You still have to validate Origin, monkeys.

Building Real Tools — Schemas, Side Effects, and Self-Control

~34 min

If your schema is optional, your incident report will be mandatory. Obviously.

Resources & Prompts — Reads and Recipes

~30 min

Resources are nouns. Prompts are playbooks. Tools are where things catch fire. You're welcome.

Testing & Debugging MCP Servers — Make Failure Boring

~32 min

If your only test is 'Claude liked it', you don't have tests. Obviously.

Security Foundations — MCP Is a Trust Machine, Not a Magic Safe

~45 min

Tool poisoning isn't a corner case. It's Tuesday.

Production Patterns — Gateways, Auth, and Boring Reliability

~40 min

If your MCP deployment diagram looks like modern art, it's not production yet.

Enterprise Governance — Catalogs, Policy, and Incident Angst

~38 min

If your governance is a wiki page, attackers thank you for the single pane of glass.

Advanced Agentic Patterns — Multi-Server, Dynamic Tools, and Humble Doubt

~42 min

Dynamic tool loading: powerful, spicy, and not your first date.

Capstone — Enterprise Developer Assistant MCP Server (The Final Boss)

~60 min

If this feels like work, congratulations: you're ready for production.