meta-agent-tools

Search the index of OKF bundles: free text over name, tagline, description and origin; filter by provenance (github|domain), repository, version, language, license, root type or concept count; search root concept text. Paginate with limit/offset. Only `live` bundles. Free text matches the name, the tagline, the description and the origin identifier (`owner/repo:path` or the bundle URL). No `total` on purpose: `GET /api/okf/stats` has it.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text over name, tagline, description and origin identifier."
    },
    "origin": {
      "type": "string",
      "description": "Provenance: found by the GitHub sweep, or submitted by a domain.",
      "enum": [
        "github",
        "domain"
      ]
    },
    "repo": {
      "type": "string",
      "description": "Only bundles of one repository, `owner/repo` (case-insensitive)."
    },
    "version": {
      "type": "string",
      "description": "Only bundles declaring one of these `okf_version` values; comma-separated, up to 5."
    },
    "language": {
      "type": "string",
      "description": "Only bundles whose repository language is one of these; comma-separated, up to 5 (GitHub bundles)."
    },
    "concept": {
      "type": "string",
      "description": "Text in the indexed root content, including listed concept names and summaries (first 1000 characters); up to 80 characters."
    },
    "concepts": {
      "type": "string",
      "description": "Number of entries listed by the root. Up to 5 comma-separated bands: 0,1-5,6-20,21-100,101+."
    },
    "type": {
      "type": "string",
      "description": "Type declared by the root, not the types of every concept. Up to 5 comma-separated values, 40 characters each."
    },
    "license": {
      "type": "string",
      "description": "Repository license. Up to 5 comma-separated values, 40 characters each."
    },
    "sort": {
      "type": "string",
      "description": "Result order: arrival, last content change, name or repository stars.",
      "enum": [
        "recent",
        "updated",
        "name",
        "stars"
      ],
      "default": "recent"
    },
    "limit": {
      "type": "integer",
      "description": "Bundles per page, at most 100.",
      "default": 24
    },
    "offset": {
      "type": "integer",
      "description": "How many bundles to skip. Use `next_offset` from the previous response; the list ends at 1000.",
      "default": 0
    }
  }
}

One bundle's card: root index.md URL, version, concept count, provenance and repository signal. `live` and `low` (example or fixture bundles kept out of the search) both answer here.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Bundle id, the `id` of every item in the list."
    }
  },
  "required": [
    "id"
  ]
}

Size of the index by provenance and when it last changed.

{
  "type": "object",
  "properties": {}
}

Does this site publish a feed? Answers with every feed known for a domain — the question a reader or an agent actually asks. Find feeds by text, format, language and availability. Filter and text search run in the SAME full-text query: values inside one parameter are OR'd, different parameters are AND'd. Without `q` the order is by newest in the index (`recentes`) and `next_cursor` is a keyset — follow `next` to walk everything. With `q` the order is relevance and paging is by `offset`. We index and link; the feeds belong to whoever publishes them.

{
  "type": "object",
  "properties": {
    "dominio": {
      "type": "string",
      "description": "Domain, with no scheme: example.com"
    },
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    },
    "retry_key": {
      "type": "string",
      "description": "Optional retry key, up to 80 ASCII characters; same read for five minutes."
    }
  },
  "required": [
    "dominio"
  ]
}

What has this feed published? The posts of one feed as our queue read them — title, date, author, summary, categories and enclosure, without the body. Find the feed first (feed_find or feed_search); this takes an id from this index, never a URL. Up to 40 posts, in the order the feed publishes them, WITHOUT the body — the body of one post comes from `/items/:ord`. It is OUR copy, read on our own schedule — not the live feed and not a proxy: the only thing this endpoint accepts is an id from this index, never a URL. `lido_em` says when we read it. Empty list when the feed has not been read yet.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Feed id, prefix fd_."
    },
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    },
    "retry_key": {
      "type": "string",
      "description": "Optional retry key, up to 80 ASCII characters; same read for five minutes."
    }
  },
  "required": [
    "id"
  ]
}

Read one post whole: the body in Markdown (`conteudo`) and the author's formatting as safe HTML (`conteudo_html`), plus the link to the original. `ord` comes from feed_posts; 0 is the newest. Two bodies for the same post, both produced when we READ the feed, never at request time: `conteudo_html` keeps the author's formatting through an allowlist (only known tags and attributes survive; script, style, iframe and event handlers are dropped with their content), and `conteudo` is the same text as Markdown — the shape an agent usually wants. Neither can carry script. 404 when the feed or the position is unknown.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Feed id, prefix fd_."
    },
    "ord": {
      "type": "integer",
      "description": "Position of the post in the feed; 0 is the newest."
    },
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    },
    "retry_key": {
      "type": "string",
      "description": "Optional retry key, up to 80 ASCII characters; same read for five minutes."
    }
  },
  "required": [
    "id",
    "ord"
  ]
}

Search the feed index by text and filters: format, audio/video, community, namespace and year of the newest item. Find feeds by text, format, language and availability. Filter and text search run in the SAME full-text query: values inside one parameter are OR'd, different parameters are AND'd. Without `q` the order is by newest in the index (`recentes`) and `next_cursor` is a keyset — follow `next` to walk everything. With `q` the order is relevance and paging is by `offset`. We index and link; the feeds belong to whoever publishes them.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text over name, description and domain."
    },
    "tipo": {
      "type": "string",
      "description": "rss2, rss1, atom, json (comma-separated = OR).",
      "enum": [
        "rss2",
        "rss1",
        "atom",
        "json",
        "rss"
      ]
    },
    "midia": {
      "type": "string",
      "description": "audio, video.",
      "enum": [
        "audio",
        "video"
      ]
    },
    "comunidade": {
      "type": "string",
      "description": "fediverse, indieweb, mastodon, friendica, wordpress, funkwhale.",
      "enum": [
        "fediverse",
        "indieweb",
        "mastodon",
        "friendica",
        "wordpress",
        "funkwhale",
        "blogroll"
      ]
    },
    "recurso": {
      "type": "string",
      "description": "content, itunes, podcast, media, slash, wfw, georss.",
      "enum": [
        "content",
        "itunes",
        "podcast",
        "media",
        "slash",
        "wfw",
        "georss"
      ]
    },
    "origem": {
      "type": "string",
      "description": "index, blogroll, bridge.",
      "enum": [
        "index",
        "blogroll",
        "bridge"
      ]
    },
    "limit": {
      "type": "integer",
      "description": "Feeds per page, 1-50.",
      "default": 20
    },
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    },
    "retry_key": {
      "type": "string",
      "description": "Optional retry key, up to 80 ASCII characters; same read for five minutes."
    }
  }
}

Does this MCP server still answer, with which access, and is its repository alive? What independent MCP indexes measured about one listing of this catalog, each credited with its license. Take the id from list_listings. A signal belongs to a listing only when it is the SAME object: the name in the official MCP registry, the exact remote endpoint URL or the GitHub `owner/repo`, in that order. A shared domain never matches — two servers on one host are different products. Up to 20 signals, one per index and record.

{
  "type": "object",
  "properties": {
    "listing": {
      "type": "string",
      "description": "Listing id from list_listings."
    },
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    },
    "retry_key": {
      "type": "string",
      "description": "Optional retry key, up to 80 ASCII characters; same read for five minutes."
    }
  },
  "required": [
    "listing"
  ]
}

Browse what independent MCP indexes measured, including servers this catalog does not list yet (casou=0). Newest change first. `casou=0` is what the indexes know and the catalog does not — the list to look at before submitting a server. Filters are AND'd.

{
  "type": "object",
  "properties": {
    "fonte": {
      "type": "string",
      "description": "One index: wellknown, agent_tools, nerq, truespar, neuronto, paygent, hultra.",
      "enum": [
        "wellknown",
        "agent_tools",
        "nerq",
        "truespar",
        "neuronto",
        "paygent",
        "hultra"
      ]
    },
    "estado": {
      "type": "string",
      "description": "vivo, fora, parado, abandonado, apagado, desconhecido.",
      "enum": [
        "vivo",
        "fora",
        "parado",
        "abandonado",
        "apagado",
        "desconhecido"
      ]
    },
    "casou": {
      "type": "string",
      "description": "1 matched to a listing, 0 not in the catalog.",
      "enum": [
        "0",
        "1"
      ]
    },
    "q": {
      "type": "string",
      "description": "Substring of name, URL or repository."
    },
    "limit": {
      "type": "integer",
      "description": "Signals per page, 1-50.",
      "default": 20
    },
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    },
    "retry_key": {
      "type": "string",
      "description": "Optional retry key, up to 80 ASCII characters; same read for five minutes."
    }
  }
}

Find A2A agents — agents that publish an AgentCard — by text, health, protocol version, registry, skill tag or publisher. Each row carries the key for a2a_agent and the license of every registry that lists it. Collected from public A2A registries and served as it comes — no review queue hides a record; quality is the order, never visibility. One row per agent, merged across the registries that list it: `fontes` says which, and `creditos` carries each one's license, which travels with the data. Values inside one parameter are OR'd, different parameters are AND'd. Cached for 60 seconds. A MAT catalog read, served by the index host `https://api.agentalog.com`; this host forwards the call there.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Substring of the name, description, key, publisher or the card's skills, in any letter case (`%` and `_` are taken literally); up to 80 characters."
    },
    "saude": {
      "type": "string",
      "description": "Health the registries measured: `sim` answered, `nao` did not, `sem_medida` never measured. Comma-separated values are OR'd (up to 12, each up to 200 characters).",
      "enum": [
        "sim",
        "nao",
        "sem_medida"
      ]
    },
    "protocolo": {
      "type": "string",
      "description": "A2A protocol version as normalized (`0.3`, `1.0`…); `/api/a2a/facets` lists the ones present. Comma-separated values are OR'd (up to 12, each up to 200 characters)."
    },
    "fonte": {
      "type": "string",
      "description": "Only agents listed by this registry. Comma-separated values are OR'd (up to 12, each up to 200 characters).",
      "enum": [
        "a2a_registry",
        "a2a_global",
        "agenstry"
      ]
    },
    "tag": {
      "type": "string",
      "description": "Exact tag of the card's skills, case-sensitive; `/api/a2a/facets` lists the 40 most used. Comma-separated values are OR'd (up to 12, each up to 200 characters)."
    },
    "publicador": {
      "type": "string",
      "description": "Exact publisher, as `publicador` shows it. Comma-separated values are OR'd (up to 12, each up to 200 characters)."
    },
    "skills": {
      "type": "string",
      "description": "`1` keeps only agents whose card lists at least one skill.",
      "enum": [
        "1"
      ]
    },
    "limit": {
      "type": "integer",
      "description": "Items per page, 1–50; more is capped at 50, anything else means 20.",
      "default": 20
    },
    "offset": {
      "type": "integer",
      "description": "Offset, capped at 20000 (a larger value reads as 20000). Prefer `_links.next`.",
      "default": 0
    },
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    },
    "retry_key": {
      "type": "string",
      "description": "Optional retry key, up to 80 ASCII characters; same read for five minutes."
    }
  }
}

Read one A2A agent: every skill its card declares, capabilities, protocol version, health, documentation and the registries that list it, with their licenses. Take the key from a2a_agent_search. The same row as the list plus what the card declares: every skill, the `capabilities` object, the protocol version as written, the documentation and icon URLs, and when we first saw it. Cached for 60 seconds; a MAT catalog read, like the list.

{
  "type": "object",
  "properties": {
    "chave": {
      "type": "string",
      "description": "Agent key (`chave`) from a2a_agent_search, usually the card's domain."
    },
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    },
    "retry_key": {
      "type": "string",
      "description": "Optional retry key, up to 80 ASCII characters; same read for five minutes."
    }
  },
  "required": [
    "chave"
  ]
}

Self-describing index: the whole API surface, with quota and quickstart.

{
  "type": "object",
  "properties": {}
}

Liveness and the commit deployed right now — it is how the smoke waits for its own deploy.

{
  "type": "object",
  "properties": {}
}

Creates a guest mr_… Asks for no e-mail. Publishing a listing is what requires an account (or a payment). At most 20 new guests per network per hour; a browser that already has one gets it back from the `mr_guest` cookie.

{
  "type": "object",
  "properties": {}
}

Public mosaic of live MCP servers, skills, plugins and OKF knowledge bundles. `live` listings first and the `low` tail (few stars or no clear license) after them in every order — `low=0` leaves the tail out. To walk everything, follow `next`: without `q` it is a cursor (`next_cursor`, keyset on the order's index) and has no ceiling; every listing also has an HTML page at `/l/:id` and the shards of `/sitemap-listings.xml` list them all. `q` runs on a full-text index (FTS5, bm25) kept in the same transaction as every text write. With `q` and `low=0`, `low_count` says how many `low` listings the filter left out — LIKE with a cap of 200. The query is mapped onto kind/topic/transport filters unless `interpret=0`.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text over the name, the tagline, the description, the origin identifier and the README excerpt: every word (up to six, 2+ letters, accents ignored) must match; ranked by bm25 with the name weighing most (10), then tagline (5), identifier (3), description (2), README excerpt (1); ties by stars. Kind, topic and transport words become filters. The `low` tail is in the same index."
    },
    "kind": {
      "type": "string",
      "description": "Which kind of resource to fetch.",
      "enum": [
        "mcp",
        "skill",
        "plugin"
      ]
    },
    "category": {
      "type": "string",
      "description": "Category declared by whoever published."
    },
    "sort": {
      "type": "string",
      "description": "Result order. Without it, a query is ranked by relevance — bm25 over the full-text index (name 10, tagline 5, identifier 3, description 2, README excerpt 1) multiplied by 1 + 0.05·ln(1 + stars) + 0.1 if pushed in the last 180 days + 0.1 if a README was collected; ties by stars — and a plain listing by arrival.",
      "enum": [
        "relevancia",
        "recent",
        "stars",
        "likes",
        "visits",
        "nome"
      ],
      "default": "relevancia when q is set, recent otherwise"
    },
    "low": {
      "type": "string",
      "description": "`0` leaves the `low` tail out; by default it comes after the `live` listings in every order.",
      "enum": [
        "0"
      ]
    },
    "interpret": {
      "type": "string",
      "description": "`0` disables query understanding and searches the raw string.",
      "enum": [
        "0"
      ]
    },
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    },
    "retry_key": {
      "type": "string",
      "description": "Optional retry key, up to 80 ASCII characters; same read for five minutes."
    }
  }
}

MCP subregistry (GET /v0.1/servers). Only live kind=mcp. Only `kind=mcp` and only `live`. It is the route a generic MCP client knows how to read without knowing this product. `GET /v0/servers` is an alias of the same resource, kept for whoever already pointed there — this is the canonical URL.

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string",
      "description": "Free text over the server's name and description."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque cursor of the next page, from `metadata.next_cursor`."
    },
    "limit": {
      "type": "number",
      "description": "Servers per page.",
      "default": 30
    },
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    },
    "retry_key": {
      "type": "string",
      "description": "Optional retry key, up to 80 ASCII characters; same read for five minutes."
    }
  }
}

One listing's page. The owner sees their own even when pending or hidden.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Listing ID, from `Anuncio.id`."
    },
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    },
    "retry_key": {
      "type": "string",
      "description": "Optional retry key, up to 80 ASCII characters; same read for five minutes."
    }
  },
  "required": [
    "id"
  ]
}

README collected for a listing (R2). Only when get_listing carries readme_api; 404 when none was stored. The text lives in R2 (`mural-coleta`). This call does not write and does not fetch GitHub. Same visibility as the listing page. Call it only when the listing page carries `readme_api`: a page without it has no README collected, and this route answers 404.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Listing ID, from `Anuncio.id`."
    },
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    },
    "retry_key": {
      "type": "string",
      "description": "Optional retry key, up to 80 ASCII characters; same read for five minutes."
    }
  },
  "required": [
    "id"
  ]
}

Timeline of the listing's repository: last events (abandono = no push for 12 months, sumiu, renomeado, readme_mudou, manifesto_mudou), newest first; empty when nothing changed since the series began. The listing page carries the same list as `historico`; updates may be cached for up to 15 minutes. An empty list means no change since the series began — the listing still exists. Stale means no push for 12 months. Reading this endpoint does not refresh the record.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Listing ID, from `Anuncio.id`."
    },
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    },
    "retry_key": {
      "type": "string",
      "description": "Optional retry key, up to 80 ASCII characters; same read for five minutes."
    }
  },
  "required": [
    "id"
  ]
}

302 hop to the listing's origin (counts a visit). Counts at most 1 visit per owner per day. The `X-Visit-Counted` header says whether this call counted — it is how the client knows without counting twice.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the listing to visit."
    }
  },
  "required": [
    "id"
  ]
}

Likes the listing; DELETE undoes it. Calling again does not add up: the counter counts people.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the listing to like."
    },
    "guest_token": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "guest_token"
  ]
}

Comments on a live listing. With a credential on the call, each comment of yours comes with `mine: true`.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the listing."
    }
  },
  "required": [
    "id"
  ]
}

Registers an MCP server, skill or plugin (human session free; agent without session = 402 $0.10). A person reviews it by hand; poll `status_api` (`GET /api/listings/:id/status`, no credential) to learn the decision. Two doors to the same action. Human with a session: free, 1 per day, at most 3 in the queue. Agent (with or without a guest): **402 with `accepts[]`**, $0.10 — pay and repeat. For a skill, the `SKILL.md` URL is enough; the rest is checked. **Validates before charging:** a refused body (400) and an exhausted quota (429) come BEFORE the 402, so no payment settles for a listing already known not to get in. A valid body without payment keeps receiving the 402 with the price.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "description": "What is being registered.",
      "enum": [
        "mcp",
        "skill",
        "plugin",
        "okf"
      ]
    },
    "category": {
      "type": "string",
      "description": "Category so the listing shows up under the right filter."
    },
    "name": {
      "type": "string",
      "description": "Display name; without it, taken from the source."
    },
    "tagline": {
      "type": "string",
      "description": "One line saying what it is for."
    },
    "body": {
      "type": "string",
      "description": "Long description, optional."
    },
    "url": {
      "type": "string",
      "description": "MCP endpoint, SKILL.md URL, the plugin's repository or the OKF bundle's `index.md`. For an OKF bundle on a domain you control, `POST /api/okf/ping` is free."
    }
  },
  "required": [
    "kind",
    "url"
  ]
}

Moderation state of a listing (pending / live / low / hidden / blocked) — poll it after create_listing. No credential; only the decision comes back. Every submission is born `pending` and a person approves it by hand; this is the receipt you poll after `POST /api/listings` (its response carries this URL as `status_api`). Only the decision comes back, never the unreviewed content: the id (`lst_…`, unguessable) is all it takes, and the page itself keeps its rule — owner only until it is public. Answers are cached for 60 s per point of presence: poll every few minutes, not every second.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Listing ID, from the `id` of the `POST /api/listings` response."
    }
  },
  "required": [
    "id"
  ]
}

Submits OKF bundles from a host you control (IndexNow protocol: key file proves ownership, no account, no charge). Answers 202 — the key is checked by the collector before anything is read. No account, no payment: ownership is proved by a key file on the host, exactly as IndexNow does it. Host `https://<host>/<key>.txt` containing the key (or point `keyLocation` at another path on the SAME host), then send the bundle URLs. We answer **202**: the key has not been checked yet. Verification and reading happen on our collector, never at the edge — so nothing is published, and no URL of yours is fetched, before the key matches. Re-sending a URL is how you say the bundle changed; it goes back in line to be re-read. At most 100 URLs per request and 200 per host per UTC day. The same queue is served by `POST https://okfindex.com/api/ping`, the index's own home — search, bundle cards and statistics live there.

{
  "type": "object",
  "properties": {
    "host": {
      "type": "string",
      "description": "The host that owns the bundles."
    },
    "key": {
      "type": "string",
      "description": "8 to 128 characters of [a-zA-Z0-9-]."
    },
    "keyLocation": {
      "type": "string",
      "description": "Where the key file lives. Defaults to `https://<host>/<key>.txt`; must be on `host`."
    },
    "urlList": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Bundle `index.md` URLs. https, on `host`, ending in .md. No fixed path: the spec defines no discovery convention."
    }
  },
  "required": [
    "host",
    "key",
    "urlList"
  ]
}

x402 configuration in force and the agent prices for contact and publishing.

{
  "type": "object",
  "properties": {}
}

Write to the people behind the product: a question, or a sponsorship/partnership/advertising proposal. Free, no captcha and no payment; one message every 10 s per network (one that arrives sooner waits its turn). One route for a question and for a sponsorship, partnership or ad proposal (`tipo`, with the placements of `GET /api/partners`). No captcha, no account, no payment. One message every 10 seconds per network: one that arrives sooner waits its turn and then goes out — no error. The message reaches the team by e-mail, with `email` as the reply address.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "What to call the person writing."
    },
    "email": {
      "type": "string",
      "description": "Where to reply."
    },
    "message": {
      "type": "string",
      "description": "What you want to say."
    },
    "tipo": {
      "type": "string",
      "enum": [
        "patrocinio",
        "parceria",
        "anuncio"
      ],
      "description": "Proposal: `patrocinio`, `parceria` or `anuncio`. Turns on the fields below."
    },
    "empresa": {
      "type": "string",
      "description": "Who is proposing, when it is a company."
    },
    "site": {
      "type": "string",
      "description": "Website of who is proposing."
    },
    "orcamento": {
      "type": "string",
      "enum": [
        "ate_100",
        "100_500",
        "500_2000",
        "2000_mais",
        "a_combinar"
      ],
      "description": "`ate_100`, `100_500`, `500_2000`, `2000_mais` or `a_combinar`."
    },
    "espaco": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Placement ids from `GET /api/partners`, up to 6."
    },
    "duracao": {
      "type": "string",
      "enum": [
        "30",
        "90",
        "365"
      ],
      "description": "Exposure in days: `30`, `90` or `365`."
    },
    "pagamento": {
      "type": "string",
      "enum": [
        "usdc",
        "deposito",
        "a_combinar"
      ],
      "description": "`usdc`, `deposito` or `a_combinar`."
    }
  },
  "required": [
    "name",
    "email",
    "message"
  ]
}

Monthly data package and private purchase status, without charging. MAT-only balance; pass prefix mat_. Catalog discovery and ordinary browsing are free. GPTBot, ClaudeBot, CCBot, Meta-ExternalAgent, Amazonbot, AhrefsBot and MJ12bot share a daily allowance of 1,000 reads per crawler family; over it the answer is 429 until the next day. Billing is off for now: there is no package to buy and reads need no X-API-Pass. The MAT allowance is separate from the company, address and procurement indexes.

{
  "type": "object",
  "properties": {
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    }
  },
  "additionalProperties": false
}

Buy 1,000 basic data reads for US$1, valid for 30 days. Requires explicit payment. MAT-only balance; pass prefix mat_. Catalog discovery and ordinary browsing are free. GPTBot, ClaudeBot, CCBot, Meta-ExternalAgent, Amazonbot, AhrefsBot and MJ12bot share a daily allowance of 1,000 reads per crawler family; over it the answer is 429 until the next day. Billing is off for now: there is no package to buy and reads need no X-API-Pass. The MAT allowance is separate from the company, address and procurement indexes.

{
  "type": "object",
  "properties": {
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    },
    "credit_token": {
      "type": "string",
      "description": "Existing prepaid credit token."
    },
    "payment": {
      "type": "string",
      "description": "Signed x402 payload, after authorizing the quote."
    },
    "transaction": {
      "type": "string",
      "description": "Base transaction hash to reconcile an uncertain payment with the same pass and original payload."
    }
  },
  "required": [
    "api_pass"
  ],
  "additionalProperties": false
}

Remaining MAT read credits, without consuming credit.

{
  "type": "object",
  "properties": {
    "api_pass": {
      "type": "string",
      "description": "MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying."
    }
  },
  "required": [
    "api_pass"
  ],
  "additionalProperties": false
}

Current public prices and free allowances; no charge.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}