
Motivations
Enabling AI agents to interact with APIs is difficult. We faced the same problem as many others building agents: altering APIs to work reliably with LLMs and executing multiple API calls successfully in a row is a trial and error process. APIs are designed for developers and not LLMs. If you’re building integrations for AI agents, you need to write boilerplate, experiment with system prompts, optimize tool definitions, and parse responses into vector stores - for each API. For example, the Gmail API has endpoints to search for threads, list the emails in a thread, and reply with an email given base64 RFC 822 content. Instead, LLMs need a clear, top-level directive that can handle all of this with one tool.
agents.json
built on OpenAPI? — OpenAPI is the gold standard for describing how API endpoints work and can be executed. Most API providers have OpenAPI specs or have APIs that can be described fully by OpenAPI. These specs alone aren’t sufficient for the age of AI agents, but provide great groundwork for API agent communication.
So we implemented agents.json
. We built this for us and we’re excited to share it with you.

Design Tenets
- Build on top of the OpenAPI standard Leverage existing standards and infrastructure where possible.
- Optimize schema for LLMs, not humans Design with AI consumption in mind.
- Enforce Statelessness Orchestration is handled by the calling agent.
- Require minimal changes to existing APIs Make adoption as seamless as possible.