# describe — documentation

> Global reputation for humans, AI agents and robots — on every chain we read

This host is the documentation hub: a frozen, citable copy of the OpenAPI schema plus every connection guide, in Markdown and in HTML.
The service itself lives at https://api.describe.net and the site at https://describe.net.

Payment is the authentication: no accounts, no API keys, no OAuth. Free
routes need no headers; a metered route answers HTTP 402 with a signable
challenge (EIP-3009, USDC) and asking for it costs nothing.

Not an identity service. Not an oracle: it returns evidence with its
`policy_version`, never a verdict. Index totals are never written on this
host — they are read live from https://api.describe.net/health.

## This host

- [OpenAPI 3.1 schema](https://docs.describe.net/openapi.json): The schema this build documented, frozen. Same bytes under [openapi-2.0.0.json](https://docs.describe.net/openapi-2.0.0.json), which is the URL to cite.
- [build.json](https://docs.describe.net/build.json): The stamp — when the snapshot was taken, which build produced the schema (`spec_build_sha`) and which commit the guides came from (`guides_source`). The two can differ, and when they do, this file is what says so.
- [llms-full.txt](https://docs.describe.net/llms-full.txt): Every guide below concatenated into one file, for the agent that prefers one fetch to several.
- [This portal as Markdown](https://docs.describe.net/index.md): Same content as the HTML portal, no chrome.
- [Swagger UI](https://docs.describe.net/swagger.html) · [ReDoc](https://docs.describe.net/redoc.html): The same schema, rendered. Both need JavaScript; both carry the whole route table as plain HTML above the app, so neither is blank without it.

## Guides

Verbatim copies of the files published on the main site; the HTML next to each one is rendered from the same bytes. For the two that are agent skills, the published digest lives at https://describe.net/.well-known/agent-skills/index.json and it indexes the copy on the apex.

- [The API for agents](https://docs.describe.net/guides/api.md): Markdown, verbatim from `site/api.md`. Rendered: https://docs.describe.net/guides/api.html
- [How to authenticate: paying is the credential](https://docs.describe.net/guides/auth.md): Markdown, verbatim from `site/auth.md`. Rendered: https://docs.describe.net/guides/auth.html
- [The describe agent skill](https://docs.describe.net/guides/skill.md): Markdown, verbatim from `site/skill.md`. Rendered: https://docs.describe.net/guides/skill.html
- [Agent workflows](https://docs.describe.net/guides/workflows.md): Markdown, verbatim from `site/workflows.md`. Rendered: https://docs.describe.net/guides/workflows.html
- [The embeddable reputation badge](https://docs.describe.net/guides/badge.md): Markdown, verbatim from `site/badge.md`. Rendered: https://docs.describe.net/guides/badge.html
- [The agent-to-agent gate](https://docs.describe.net/guides/a2a.md): Markdown, verbatim from `site/a2a.md`. Rendered: https://docs.describe.net/guides/a2a.html
- [The MCP server, and the thesis](https://docs.describe.net/guides/mcp.md): Markdown, verbatim from `mcp/README.md`. Rendered: https://docs.describe.net/guides/mcp.html

## Live

Everything above is a dated snapshot. These are not:

- [Health](https://api.describe.net/health): Index size and how far each chain has been scanned. The only authority on any total.
- [Pricing](https://api.describe.net/pricing): Every tier, its price and the reason for it. Authoritative over any table published anywhere, including this host.
- [Live OpenAPI](https://api.describe.net/openapi.json): What production serves right now, which may be ahead of or behind the frozen copy here.
- [MCP endpoint](https://api.describe.net/mcp): Streamable HTTP, stateless.
- [A2A endpoint](https://api.describe.net/a2a): JSON-RPC `message/send`.

## Optional

- [The map of the main site](https://describe.net/llms.txt): describe.net itself — the manifesto, the explorer, the metrics cube.
- [API catalog, RFC 9727](https://describe.net/.well-known/api-catalog): The linkset. This host publishes no `/.well-known/` of its own on purpose: the catalog's anchor is the API, not whichever host serves the document.
- [Agent skills index](https://describe.net/.well-known/agent-skills/index.json)

Snapshot: built 2026-08-30T22:43:49Z · API 2.0.0 · spec b5eb83903e36f20cdf21166ef8e2fba77a5a846b · guides git:b5eb83903e36