What I learned writing my first MCP server.

The protocol is small. The interesting design decisions are not.

The shape that surprised me most was not the transport or schema. It was the human layer around the tool: descriptions, affordances, permissions, and the tiny contracts that teach an agent when not to touch something.