---
title: "agents.json: definition and example | Agent MCP Directory"
description: "agents.json: An OpenAPI-based file at /.well-known/agents.json describing flows of API calls for agents. Defined with a sourced example."
canonical: https://agentmcpdirectory.com/glossary/agents-json
site: "Agent MCP Directory"
last_updated: 2026-11-04
section: "Glossary"
---

# agents.json: definition and example | Agent MCP Directory

> agents.json: An OpenAPI-based file at /.well-known/agents.json describing flows of API calls for agents. Defined with a sourced example.

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

# agents.json

agents.json: An OpenAPI-based file at /.well-known/agents.json describing flows of API calls for agents. Example: The current version is 0.1.0 under MIT. Next in the glossary is AI gateway: A proxy in front of model APIs that adds caching, rate limits, logs and billing across providers.

## Definition

An OpenAPI-based file at /.well-known/agents.json describing flows of API calls for agents.

## Example, with source

The current version is 0.1.0 under MIT. ([github.com](https://github.com/wild-card-ai/agents-json), read 4 November 2026)

## Where it appears on this site

-   [agents.json](https://agentmcpdirectory.com/standards/agents-json/)
-   [OpenAPI as an agent surface](https://agentmcpdirectory.com/standards/openapi-as-agent-surface/)

## Neighbouring terms

-   [Agentic AI Foundation (AAIF)](https://agentmcpdirectory.com/glossary/agentic-ai-foundation/): The Linux Foundation-directed foundation that hosts MCP, A2A, goose and AGENTS.md.
-   [AI gateway](https://agentmcpdirectory.com/glossary/ai-gateway/): A proxy in front of model APIs that adds caching, rate limits, logs and billing across providers.
-   [Client ID Metadata Document (CIMD)](https://agentmcpdirectory.com/glossary/client-id-metadata-document/): A JSON file on the client's domain whose HTTPS URL is used as the OAuth client\_id, the recommended MCP registration method.

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/glossary/agents-json/index.md)

## Sources

-   [Source for the agents.json example](https://github.com/wild-card-ai/agents-json), read 4 November 2026

Last reviewed 4 November 2026