Self-Documenting MCP Servers How to Build AI Infrastructure That Can Explain Itself — and Sustain Agency

I ran into a failure mode while building a long-lived, auto-bootstrapping MCP server: the model kept guessing about its role when expectations weren’t explicit. I ended up changing the architecture so the system explains itself to the agent at runtime (handshake + self-documentation). Wrote it up here in case it’s useful to others building agentic systems: [https://medium.com/@pstryder/self-documenting-mcp-servers-3eacbd3e8991](https://medium.com/@pstryder/self-documenting-mcp-servers-3eacbd3e8991)