Field notes on AI-native SaaS.
How to ship MCP servers, embed in-product AI assistants, and monetize AI usage — written by the team building the platform.
- MCP education
How do you turn a REST or GraphQL API into an MCP server? What 220 generated tools taught me
The direct answer, then the parts the mapping doesn't tell you: OpenAPI and GraphQL to MCP tool code, the non-null relation that zeroed out a whole query, GraphQL's HTTP 200 failures, and a description pipeline that failed silently for weeks.
Sep 21, 2026 · 8 min - MCP education
AI agents need different docs: writing MCP tool descriptions that don't hallucinate
Agents can't ask follow-ups — your MCP tool descriptions are their entire world. Seven rules (verb accuracy, enums verbatim, ID provenance, concrete return shapes) and the AI pipeline that scales them to 84 tools.
Jul 11, 2026 · 5 min - MCP education
GraphQL to MCP: introspection, nullability landmines, and lean selection sets
Turning a GraphQL API into MCP tools: query/mutation→tool mapping, why greedy selection sets explode on non-nullable fields, per-customer credential forwarding, and verb-accurate descriptions.
Jul 11, 2026 · 6 min - MCP education
OpenAPI to MCP: the practical conversion guide
How to convert an OpenAPI spec into MCP tools that agents actually use well: operation→tool mapping, curation, read/write flags, agent-grade descriptions, and the gotchas that survive spec review.
Jul 11, 2026 · 6 min