Topic

mcp

2 min read

Your MCP Hub Exposes Every Tool to Every Agent. That's the Bug.

A shared MCP hub that lists all 40 tools to every connected agent is a convenience until the billing agent starts calling create_user. The fix isn't stricter prompts — it's a smaller tool list per agent, derived from the spec.

Read article
4 min read

Scope MCP Keys to the Human, Not to the Team

When you hand MCP gateway access to support and PMs, a team-wide key becomes the incident waiting to happen. Scope the key to the human, the role, and the three ops they actually use.

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
3 min read

Your MCP Server Is Wasting Your Agent's Context Window

Most MCP servers load everything eagerly, dump huge schemas into the system prompt, and make the agent pay for tools it will never call. The fix is boring: lazy, narrow, and spec-driven.

Read article