---
title: "agents.json: what it is | Agent MCP Directory"
description: "agents.json: An OpenAPI-based contract that describes flows (sequences of API calls) and links between actions so agents can call an API correctly."
canonical: https://agentmcpdirectory.com/standards/agents-json
site: "Agent MCP Directory"
last_updated: 2026-11-04
section: "Standards"
---

# agents.json: what it is | Agent MCP Directory

> agents.json: An OpenAPI-based contract that describes flows (sequences of API calls) and links between actions so agents can call an API correctly.

Source: https://agentmcpdirectory.com/standards/agents-json
Site: Agent MCP Directory
Last reviewed: 2026-11-04

# 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](https://github.com/wild-card-ai/agents-json), read 4 November 2026)
-   Flows are contracts of one or more API calls; links define how two actions connect. ([github.com](https://github.com/wild-card-ai/agents-json), read 4 November 2026)
-   The current version is 0.1.0 under the MIT licence. ([github.com](https://github.com/wild-card-ai/agents-json), read 4 November 2026)
-   The repository shows 75 commits on master. ([github.com](https://github.com/wild-card-ai/agents-json), 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](https://agentmcpdirectory.com/census/).

## Compared with

-   [WebMCP vs agents.json](https://agentmcpdirectory.com/compare/webmcp-vs-agents-json/)

Edition

4 November 2026

Method

[How rows are verified](https://agentmcpdirectory.com/method/)

Data

[CSV and JSON](https://agentmcpdirectory.com/data/)

Markdown

[This page as markdown](https://agentmcpdirectory.com/standards/agents-json/index.md)

## Sources

-   [agents.json specification or home](https://github.com/wild-card-ai/agents-json), read 4 November 2026

Last reviewed 4 November 2026