Topic

AI Agents

3 min read

Your AI Agent's Exit Code Is Lying to You

An agent that exits 0 is not an agent that did the thing. It just means whatever it ran didn't blow up. Here's the cheap verification gate I stopped skipping.

Read article
4 min read

When the Spec Changes, the MCP Tool List Should Change With It

We hand-maintained a tools.json that matched our OpenAPI doc for about three weeks. Then someone renamed a parameter and the agent started sending the old name to an endpoint that no longer accepted it. The fix was not better discipline. It was letting the spec be the source of truth.

Read article
4 min read

Store the Upstream Token in the Gateway, Not in Your MCP Config

Pasting a production bearer token into ~/.cursor/mcp.json means every engineer's laptop holds a credential that can call your billing API directly. The gateway should inject it; the agent client should never see it.

Read article
4 min read

Expose Three Operations, Not the Whole OpenAPI Spec

When you convert an entire OpenAPI doc into MCP tools, the agent sees 87 endpoints including the one that deletes a tenant. Per-operation exposure is the blast-radius control you actually want.

Read article