Topic

architecture

4 min read

Reusable JSON Schema components in OpenAPI: DRY models without $ref spaghetti

Inline every schema and your request and response models drift apart. Extract everything and the document becomes a maze of one-off references. The middle path is a small set of rules for what becomes a component, what stays inline, and how to name and compose it.

Read article
4 min read

One MCP Gateway for All Your Internal APIs: The Aggregation Pattern

Pointing an agent at forty internal MCP servers breaks tool limits and buries it in duplicated names. The pattern that works at scale is one authenticated gateway that aggregates specs, namespaces the tools, and keeps auth, logging, and rate limits in one place.

Read article
4 min read

MCP stdio vs Remote Transports: Run It Locally or Host It?

The same MCP server can run over stdio on a laptop or Streamable HTTP behind a domain, and the choice changes auth, state, latency, and who can use it. Here is a decision framework with the actual launch commands and client config for each transport.

Read article