# describe.net

> **Global cross-chain reputation for trustless agents.** An ERC-8004 index across
> every chain where the registries are deployed. It does not sell a score — the chain is
> public and you can average it yourself. It sells what a score is made of: how many
> distinct counterparties wrote it, how many times each one spoke, in which facet,
> dated on-chain, each with its transaction. Read before you hire, lend, delegate or
> sign to a wallet.

Payment is the authentication: no accounts, no API keys, no OAuth. Aggregate reads
are free; a question about one named subject is metered over x402 (EIP-3009, USDC),
and the first call answers HTTP 402 with the full challenge. The only address this
service asks to be paid at is 0xe4dc963c56979E0260fc146b87eE24F18220e545.

Content negotiation is NOT available: this site is static on S3 behind CloudFront, so
`Accept: text/markdown` returns HTML. The Markdown below is published as twin files at
fixed URLs instead. The reasoning, and what the alternative would cost, is in api.md.

## Docs

- [Manifesto](https://describe.net/manifesto.md): Why this index exists and what it refuses to do — written by the people who ran a reputation network from 2012 to 2021 and measured, on its final archive, that 85.4% of its 1,768,604 descriptions were written by the subjects about themselves. Every claim carries the command that checks it. Spanish edition: [manifesto.es.md](https://describe.net/manifesto.es.md).
- [API and MCP, for agents](https://describe.net/api.md): What is sold, what it costs, the x402 flow, the five decision rules, the measured traps, and an explicit list of what is currently broken. Markdown twin of api.html.
- [auth.md](https://describe.net/auth.md): How to authenticate — there are no accounts and no tokens; paying is the credential.
- [vet-a-counterparty skill](https://describe.net/.well-known/agent-skills/vet-a-counterparty/SKILL.md): Step-by-step skill for vetting a wallet's reputation before transacting with it.

## API

- [OpenAPI 3.1](https://api.describe.net/openapi.json): Machine-readable description of every route.
- [Pricing](https://api.describe.net/pricing): Free. Every tier, its price, and the reason for that price. Authoritative over any table published anywhere, including api.md.
- [Health](https://api.describe.net/health): Free. Index size and how far each chain has been scanned. A chain absent from this list is not indexed at all — ratings written there are invisible.
- [Leaderboard](https://api.describe.net/leaderboard): Free for the first page. Wallets ranked by Bayesian-shrunk score, with distinct_raters in the same row.
- [Facet table](https://api.describe.net/stats/facets): Free. Every facet in the index with its volume and mean.
- [Manifesto, as data](https://api.describe.net/manifesto): Free. The principles with `enforced_by` — the file or route that makes each one true — plus `verifications`: every claim with the exact command that checks it. Serves no index figure and touches no database on purpose; the prose lives in the Markdown editions above.
- [Feed](https://api.describe.net/feed): Free. The newest ratings across every chain, ordered by the chain's own clock. Facts only — no third party writes free text about anyone here, so there is nothing to moderate that is not already on-chain. No `network` filter: measured, it would time out on the chains with old, sparse ratings.

## Discovery

- [API catalog](https://describe.net/.well-known/api-catalog): RFC 9727 linkset.
- [MCP server card](https://describe.net/.well-known/mcp/server-card.json): Six stdio tools. There is no hosted MCP endpoint; `remotes` is empty on purpose.
- [Agent skills index](https://describe.net/.well-known/agent-skills/index.json)

## Optional

- [Home](https://describe.net/index.html): The argument, with the index drawn to scale.
- [Explore](https://describe.net/explore.html): Browse the index.
- [Profile](https://describe.net/agent.html): One wallet, its score rendered next to its composition.