# OKF Index

> The search index of Open Knowledge Format (OKF) bundles — markdown trees with YAML
> frontmatter that an agent reads whole. Bundles come from a sweep of public GitHub
> repositories and from domains that submit theirs (IndexNow protocol). Free, no account.

## Discovery

- [API index](https://okfindex.com/api/)
- [llms.txt](https://okfindex.com/llms.txt)
- [llms-full.txt](https://okfindex.com/llms-full.txt)
- [OpenAPI](https://okfindex.com/openapi.json)
- [MCP](https://okfindex.com/mcp)
- [OKF bundle of this index](https://okfindex.com/okf/index.md)

## Main endpoints

- `GET /agent.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` — 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` — 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` — 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` — MCP Streamable HTTP — as tools deste catálogo, despachadas neste mesmo Worker. (auth: none)
- `GET /api/bundles` — Paginated search of the index: every live OKF bundle, from GitHub and from live domains. (auth: none)
- `GET /api/bundles/:id` — One bundle's card, by id. (auth: none)
- `GET /api/stats` — Size of the index by provenance, and when it last changed. (auth: none)
- `POST /api/ping` — Submits OKF bundles from a domain you control, using the IndexNow protocol. (auth: none)

## How a bundle gets in

- **Public GitHub**: the sweep finds every `index.md` whose frontmatter carries `okf_version`. Nothing to do.
- **Your own domain**: `POST /api/ping` with `host`, `key` and `urlList`; a key file at
  `https://<host>/<key>.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.

Nothing to pay: the index is free and needs no account.

Numbers in force: https://okfindex.com/api/