# describe — documentation

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

Every door of the service, with its guide. Index totals are never printed
here: they are served live and free at `GET https://api.describe.net/health`.

API base: `https://api.describe.net`

Not an identity service. Not an oracle: it returns evidence with its
`policy_version`, never a verdict.

## REST API

Free tier answers with no headers and no account; metered routes answer HTTP 402 until paid. Payment is the authentication.

- [OpenAPI 3.1 schema (this build)](https://docs.describe.net/openapi.json)
- [OpenAPI 3.1 schema (live)](https://api.describe.net/openapi.json)
- [Swagger UI (static, this build)](https://docs.describe.net/swagger.html)
- [ReDoc (static, this build)](https://docs.describe.net/redoc.html)
- [Swagger UI (live)](https://api.describe.net/docs)
- [Guide: the API for agents](https://docs.describe.net/guides/api.html)
- [Live prices](https://api.describe.net/pricing)
- [Live index coverage — the only place totals live](https://api.describe.net/health)

## x402 — how to pay

No accounts, no API keys. A metered call answers 402 with a signable challenge; replay the identical request with the X-PAYMENT header. Pay only the treasury published out of band.

- [Guide: how to authenticate](https://docs.describe.net/guides/auth.html)
- [A live, payable 402 as documentation](https://api.describe.net/api)
- [Machine-readable price table](https://api.describe.net/pricing)

## MCP server

The same index as tools inside your MCP client. Two transports, one code: remote Streamable HTTP and local stdio.

- [Remote endpoint](https://api.describe.net/mcp)
- [Server card](https://describe.net/.well-known/mcp/server-card.json)
- [Guide: the MCP server and the thesis](https://docs.describe.net/guides/mcp.html)

## A2A

Agent-to-agent: message/send over JSON-RPC serves the free preview of a wallet.

- [Agent card](https://describe.net/.well-known/agent-card.json)
- [Endpoint (POST)](https://api.describe.net/a2a)
- [Guide: agent-to-agent](https://docs.describe.net/guides/a2a.html)

## Badge

A reputation badge per wallet, embeddable as an SVG that reads the live index.

- [Badge page — how to embed](https://describe.net/badge.html)
- [A live badge (SVG)](https://api.describe.net/badge/0x715dc035ffb97dd7bb4095c6670138ba05bb4e6d.svg)
- [Guide: the reputation badge](https://docs.describe.net/guides/badge.html)

## For agents

The machine-readable doors of THIS host, one hop each. What this service is not: not an identity service, and not an oracle — it returns evidence with its policy_version, never a verdict.

- [llms.txt — the map of this host](https://docs.describe.net/llms.txt)
- [llms-full.txt — every guide in one fetch](https://docs.describe.net/llms-full.txt)
- [This page as Markdown](https://docs.describe.net/index.md)
- [build.json — the two provenances of this snapshot](https://docs.describe.net/build.json)
- [Agent skill (umbrella)](https://docs.describe.net/guides/skill.html)
- [Agent workflows](https://docs.describe.net/guides/workflows.html)
- [llms.txt of the main site](https://describe.net/llms.txt)
- [Agent skills index (published digests)](https://describe.net/.well-known/agent-skills/index.json)
- [API catalog (RFC 9727)](https://describe.net/.well-known/api-catalog)
- [About](https://describe.net/about.html)
- [Privacy](https://describe.net/privacy.html)
- [Contact](https://describe.net/contact.html)

## This snapshot

- API version: `2.0.0` (OpenAPI `3.1.0`, 20 paths)
- Built: `2026-08-30T22:43:49Z`
- Schema source: `https://api.describe.net/openapi.json`
- Schema build: `b5eb83903e36f20cdf21166ef8e2fba77a5a846b`
- Guides commit: `git:b5eb83903e36`
- The stamp itself: https://docs.describe.net/build.json