# AFMR Discovery API

**Canonical:** https://apis.io/apis/afmr-ai/afmr-discovery-api/  
**Provider:** Agent Failure Mode Registry — https://apis.io/providers/afmr-ai/  
**Base URL:** https://afmr.ai  
**Documentation:** https://afmr.ai/

AFMR Discovery API is one of 2 APIs that [Agent Failure Mode Registry](https://apis.io/providers/afmr-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. Tagged areas include Discovery, Standards, Agent Governance, and Failure Modes. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and 2 JSON Schemas.

Read-only discovery for AFMR 1.0, the AFMR Reputation Attestation Working Draft and configuration-only Lift Evidence: 21 operations over the discovery documents (afmr.json, agent-card.json, mcp.json, resources.json, server.json, agents.json, llms.txt, status.json, changelog.json, feed.xml, sitemap.xml), the Reputation Attestation specification, JSON Schema and verifier requirements, the governance-voting contract, the endpoint-conformance registry, the evidence map and the Lift Evidence index, plus the MCP JSON-RPC and A2A SendMessage protocol endpoints. No authentication; errors are RFC 9457 application/problem+json.

## Operations (22)

| Method | Path | Summary |
|---|---|---|
| GET | `/.well-known/afmr.json` | Get the AFMR authority map and machine action path |
| GET | `/.well-known/agent-card.json` | Get the public A2A Agent Card |
| GET | `/.well-known/mcp.json` | Get the non-normative MCP discovery pointer |
| GET | `/resources.json` | Get every public machine resource and protocol endpoint |
| GET | `/server.json` | Get the official MCP Registry server manifest |
| GET | `/agents.json` | Get the consolidated A2A and MCP endpoint index |
| GET | `/llms.txt` | Get the compact agent-first orientation |
| GET | `/llms-full.txt` | Get expanded terminology, verification, lifecycle, and limit documentation |
| GET | `/status.json` | Get publication, draft, dependency, and lifecycle status |
| GET | `/changelog.json` | Get AFMR.ai public-work revisions |
| GET | `/feed.xml` | Get the Atom update feed |
| GET | `/sitemap.xml` | Get the human and machine resource sitemap |
| GET | `/evidence/index.json` | Get public evidence and source surfaces |
| GET | `/lift-evidence/index.json` | Get the empty configuration-only Lift Evidence index |
| GET | `/standards/reputation-attestation/0.1/specification` | Get the AFMR Reputation Attestation Working Draft 0.1 |
| GET | `/standards/governance-voting/1.0/contract.json` | Get the pinned Agentic Substrate ADR-022 Batch-42 governance and voting binding |
| GET | `/standards/reputation-attestation/0.1/schema.json` | Get the Working Draft 0.1 JSON Schema |
| GET | `/standards/reputation-attestation/0.1/verifier.json` | Get Working Draft verifier requirements and outcomes |
| GET | `/registries/endpoints/v0.1/index.json` | Get the intentionally empty pre-publication endpoint registry |
| POST | `/api/rpc` | Call the public read-only AFMR MCP server |
| GET | `/api/rpc` | Probe for an optional MCP SSE listening stream |
| POST | `/a2a` | Send a read-only discovery message to the AFMR A2A agent |

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/afmr-ai/refs/heads/main/openapi/afmr-ai-discovery-api-openapi.yml
- **OpenAPI** — https://afmr.ai/openapi.json
- **Documentation** — https://afmr.ai/llms-full.txt
- **APIReference** — https://afmr.ai/openapi.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/afmr-ai/refs/heads/main/overlays/afmr-ai-discovery-api-overlay.yaml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/afmr-ai/refs/heads/main/errors/afmr-ai-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/afmr-ai/refs/heads/main/data-model/afmr-ai-data-model.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/afmr-ai/refs/heads/main/json-schema/afmr-ai-reputation-attestation-0.1-schema.json
- **JSONSchema** — https://afmr.ai/standards/reputation-attestation/0.1/schema.json
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/afmr-ai/refs/heads/main/apis.yml

## Other Agent Failure Mode Registry APIs (1)

- [AFMR Discovery MCP Server](https://apis.io/apis/afmr-ai/afmr-discovery-mcp-server/)

## Tags

Discovery, Standards, Agent Governance, Failure Modes

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/afmr-ai/afmr-discovery-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/afmr-ai/.