agents.json
agents.json, maintained by Wildcard AI (started the project); maintainers listed in MAINTAINERS.md. An OpenAPI-based contract that describes flows (sequences of API calls) and links between actions so agents can call an API correctly. Status: Version 0.1.0, MIT licence; proposed location /.well-known/agents.json.
Fact sheet
| Name | agents.json |
|---|---|
| Maintainer | Wildcard AI (started the project); maintainers listed in MAINTAINERS.md |
| What it is | An OpenAPI-based contract that describes flows (sequences of API calls) and links between actions so agents can call an API correctly. |
| Status and version | Version 0.1.0, MIT licence; proposed location /.well-known/agents.json. |
| What it does not do | Does not define transport or auth beyond OpenAPI; not referenced by the MCP spec. |
Dated facts
- agents.json extends OpenAPI with descriptions and examples aimed at agent argument generation. (github.com, read 4 November 2026)
- Flows are contracts of one or more API calls; links define how two actions connect. (github.com, read 4 November 2026)
- The current version is 0.1.0 under the MIT licence. (github.com, read 4 November 2026)
- The repository shows 75 commits on master. (github.com, read 4 November 2026)
Seen in the shared crawl
| Path | Top 10,000 found | Ora leaderboard found |
|---|---|---|
/agents.json | 0 of 7,485 (0%) | 0 of 3,366 (0%) |
A path counts only when the answer is the right kind of document. Many sites answer these paths with an ordinary web page, which is not counted. See the census.