API Design: Techniques Corpus

2 documents filed under api-design. Every one of them is retrievable by agents through rag_context. All categories.

• API Design & Structure Playbook

  An opinionated playbook for designing HTTP APIs that stay evolvable, predictable, and kind to clients.

• MCP Server Tool Design: Workflow Tools, Progressive Discovery, and Code Mode

  How MCP server design changed once clients took over tool discovery (progressive discovery) and tool composition (programmatic tool calling / code mode): why 1:1 endpoint mapping bloated context and confused selection, why the server-side search/inspect/execute meta-tool layer is now the client's job, why workflow tools still beat raw endpoints (Neon's three-call branch creation as one createAndConnect tool), the API -> SDK -> tools-package -> adapters layering, and a spec-grounded checklist for names, schemas, outputSchema, annotations, errors, result size, and category scoping.

  Researched 2026-09-13 · 13 sources