# OKF Index Search OKF via /api/bundles: concept text in the indexed root excerpt, concept count, root type, version and repository metadata. /api/okf/stats counts the same index in MAT and OKF Index. Open index_url for the original; the UI offers Formatted and RAW views. > The search index of Open Knowledge Format (OKF) bundles — markdown trees with YAML > frontmatter that an agent reads whole. Search concepts and inspect bundle details. > Submit your own bundle with the IndexNow protocol. Free, no account. **Partnership, sponsorship and advertising** Product placements on request, with a suggested price in USD per 30 days, the public numbers next to them and a proposal that reaches the person who answers. - `GET https://staging.okfindex.com/api/partners` — placements, suggested price, wallet and the proposal fields. - [Send a proposal](https://staging.okfindex.com/partners) — the same offer for people, with the form. - `GET https://staging.okfindex.com/okf/parceria.md` — the offer in markdown, to read without parsing JSON. **Public data archives** Browse addresses and procurement by location, then open the records you need. Up to 20 items per page, in formats ready for people and agents. Check coverage and the reference date before using a result. Access options are shown by each product. - [Postal codes and addresses](https://api.pontofato.com/enderecos/index.json): Find addresses by location, with coordinates and a 2022 reference date. Not a current postal-code certification. State → municipality → locality → street → addresses. [HTML](https://api.pontofato.com/enderecos/) · [llms.txt](https://api.pontofato.com/enderecos/llms.txt) · [OKF](https://api.pontofato.com/enderecos/okf/index.md) - [Public procurement](https://api.editalmd.com/licitacoes/index.json): Find public procurement by location and date. View documents and reading options in EditalMD. Procedure → state → year → month → day → municipality → purchases. [HTML](https://api.editalmd.com/licitacoes/) · [llms.txt](https://api.editalmd.com/licitacoes/llms.txt) · [OKF](https://api.editalmd.com/licitacoes/okf/index.md) **How a bundle gets in** - **Your own domain**: `POST /api/ping` with `host`, `key` and `urlList`; a key file at `https:///.txt` proves ownership. 202 means queued; the key is checked before any read. - **Bundle changed?** Send the URL again — that is the freshness channel. Not the official OKF registry, not affiliated with Google (who publishes the spec). **Quota** - Free: search, bundle cards, statistics, llms.txt, OpenAPI and MCP — no quota. - Free: submission (`POST /api/ping`) — 100 URLs per request, 200 per host per UTC day. - Paid: agent contact (`POST /api/contact`) — **$0.10** USDC via x402. The index is free and needs no account. Only agent contact is paid: **402** with `accepts[]` (x402) and `credito` (prepaid, `POST /api/credito?usd=10`, valid in every product of the house). Pay and retry with `X-PAYMENT`, or send `Authorization: Bearer cred_…`. Numbers in force: https://staging.okfindex.com/api/ ## Discovery - [API index](https://staging.okfindex.com/api/) - [llms.txt](https://staging.okfindex.com/llms.txt) - [llms-full.txt](https://staging.okfindex.com/llms-full.txt) - [OpenAPI](https://staging.okfindex.com/openapi.json) - [MCP](https://staging.okfindex.com/mcp) - [OKF bundle of this index](https://staging.okfindex.com/okf/index.md) ## Conventions - Read routes accept `GET` and also `POST`, `PUT` or `PATCH` with the same parameters as JSON or form data. - JSON is the default; `Accept: text/html` returns the same answer as HTML. - `/skill.md` is the ready-made agent skill; `/.well-known/api-catalog` (or `/discovery/resources`) lists every surface; `/mcp` also answers at `/mcp/v1`. ## Main endpoints - [`GET /api/auth/bootstrap`](/llms-full.txt?prefix=%2Fapi%2Fauth%2Fbootstrap): Prepare the browser for global sign-in. (auth: none) - [`GET /api/account/profile`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Fprofile): Read your global profile. (auth: session) - [`GET /api/account/avatar`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Favatar): Read your global profile photo. (auth: session) - [`GET /api/me`](/llms-full.txt?prefix=%2Fapi%2Fme): Read the current global account in this product. (auth: session) - [`POST /api/auth/logout`](/llms-full.txt?prefix=%2Fapi%2Fauth%2Flogout): Revoke this product session. (auth: session) - [`GET /api/account/keys`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Fkeys): List your API keys in this product. (auth: session) - [`POST /api/account/keys/create`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Fkeys%2Fcreate): Create an API key for agents and scripts. (auth: session) - [`POST /api/account/keys/revoke`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Fkeys%2Frevoke): Revoke one of your API keys. (auth: session) - [`GET /agent.json`](/llms-full.txt?prefix=%2Fagent.json): Agent card: identity, operator, documentation, the MCP endpoint and the tools it serves. Same document as `/.well-known/agent-card.json`. (auth: none) - [`GET /okf/:arquivo`](/llms-full.txt?prefix=%2Fokf%2F%3Aarquivo): OKF bundle (Open Knowledge Format v0.1): markdown with frontmatter so an agent reads the whole product without parsing HTML. (auth: none) - [`GET /.well-known/:arquivo`](/llms-full.txt?prefix=%2F.well-known%2F%3Aarquivo): Machine discovery before the home page: `api-catalog` (RFC 9727, a linkset with the API and the MCP), `security.txt` (RFC 9116), `x402` (payment manifest: network, wallet and the routes that charge) and `mcp-registry-auth` (the official MCP registry key). (auth: none) - [`GET /apis.json`](/llms-full.txt?prefix=%2Fapis.json): APIs.json (apisjson.org, 0.19): the index APIs.io harvests — the API, the MCP, OpenAPI, guide and OKF bundle in one file. Also at `/.well-known/apis.json`. (auth: none) - [`POST /mcp`](/llms-full.txt?prefix=%2Fmcp): MCP Streamable HTTP — as tools deste catálogo, despachadas neste mesmo Worker. (auth: none) - [`GET /api/bundles`](/llms-full.txt?prefix=%2Fapi%2Fbundles): Paginated search of the index: every live OKF bundle, from GitHub and from live domains. (auth: none) - [`GET /api/bundles/:id`](/llms-full.txt?prefix=%2Fapi%2Fbundles%2F%3Aid): One bundle's card, by id. (auth: none) - [`GET /api/okf/stats`](/llms-full.txt?prefix=%2Fapi%2Fokf%2Fstats): Size of the index by provenance, and when it last changed. (auth: none) - [`GET /api/stats`](/llms-full.txt?prefix=%2Fapi%2Fstats): Counts and facets for the OKF Index home. (auth: none) - [`POST /api/ping`](/llms-full.txt?prefix=%2Fapi%2Fping): Submits OKF bundles from a domain you control, using the IndexNow protocol. (auth: none) - [`GET /api/vitrine`](/llms-full.txt?prefix=%2Fapi%2Fvitrine): The product's public numbers: traffic, agents, usage and reliability, no money. (auth: none) - [`GET /api/vitrine/operador`](/llms-full.txt?prefix=%2Fapi%2Fvitrine%2Foperador): The product's full document on the operator panel — operator token only. (auth: none) - [`GET /api/vitrine/painel`](/llms-full.txt?prefix=%2Fapi%2Fvitrine%2Fpainel): The whole house panel, in the shape the gm reads — operator token only. (auth: none) - [`GET /api/vitrine/cursores`](/llms-full.txt?prefix=%2Fapi%2Fvitrine%2Fcursores): The resolved-error cursor per product (`borda`, `cli`) — operator token only. (auth: none) - [`GET /api/partners`](/llms-full.txt?prefix=%2Fapi%2Fpartners): Partnership, sponsorship and advertising: the product's placements with a suggested price, the public numbers next to them and how to propose. (auth: none) - [`POST /api/contact`](/llms-full.txt?prefix=%2Fapi%2Fcontact): Talks to the people behind the index: a human solves Turnstile, an agent pays $0.10 in x402 or prepaid credit. (auth: none) - [`POST /api/credito`](/llms-full.txt?prefix=%2Fapi%2Fcredito): Top up prepaid credit: pay once with x402 and get the token that debits on any API of the house. (auth: none) - [`GET /api/credito`](/llms-full.txt?prefix=%2Fapi%2Fcredito): Credit balance and statement — the latest movements, without returning the token. (auth: credito) - [`POST /api/pagamento/aberto`](/llms-full.txt?prefix=%2Fapi%2Fpagamento%2Faberto): The interface reports a visible payment prompt. Agents must not call this route. (auth: none) - [`GET /api/pricing`](/llms-full.txt?prefix=%2Fapi%2Fpricing): Current prices and free allowances. (auth: none) - [`GET /api/billing`](/llms-full.txt?prefix=%2Fapi%2Fbilling): Public payment and prepaid credit discovery. (auth: none)