SUTRA / FIELD NOTES
Good interfaces.
Better conversations.
Notes on API design, deliberate access,
and building tools that agents can use.
ENGINEERING & PRODUCT
API design · 5 min read
What makes an API useful to an agent?
A useful tool needs more than a reachable endpoint. Start with names, inputs, responses, and an honest description of what can go wrong.
Read articleContracts · 5 min read
One API should not mean one view for everyone.
How to define a smaller, clearer interface for an internal team, a partner, and an AI agent without treating them as the same consumer.
Read articleMCP · 5 min read
Before you connect your first MCP client.
A practical checklist for turning an API into a small, testable tool surface—and understanding what happens after the first call.
Read article3 articles