mcpindex Ledger API
The Ledger API from mcpindex — 1 operation(s) for ledger.
The Ledger API from mcpindex — 1 operation(s) for ledger.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mcpindex-ai:mcpindex-ai-ledger-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: mcpindex.ai public Ledger API
version: 1.0.0
description: Public read API for mcpindex.ai, the drift-monitored MCP server index with an advisory trust screen. Verdicts are advisory (REVIEW when screened, else UNVERIFIED fail-closed; ALLOW/DENY reserved, not produced) - a contract screen, not a safety guarantee. No authentication required. A hosted remote MCP endpoint with the same capabilities is at https://mcpindex.ai/api/mcp (Streamable HTTP).
contact:
name: mcpindex
url: https://mcpindex.ai
servers:
- url: https://mcpindex.ai
tags:
- name: Ledger
paths:
/api/v1/ledger:
get:
operationId: driftLedger
summary: 'Public drift ledger: contract changes the crawler observed, paged'
description: 'Contract diffs listed by fingerprint (keyed hashes of public registry names under a published key; recomputable, not anonymous) - a contract-diff record, not a safety verdict. Schema mcpindex.drift.ledger/4. One section per request: events (tool contract changes), context_events (server instructions and prompt metadata) or fleet_events (publisher-wide changes, counted once). When ledger_schema is mcpindex.drift.ledger/3, events omits tools whose only change was part of a publisher-wide change; look those up with /api/v1/drift/any. events and context_events pages hold up to 1,000 rows, newest first; fleet_events pages are packed by size. With no parameters this returns page 0 of events. To read a whole section, request ?section= and follow next_cursor until it is null. A cursor stays in the generation it was issued for, so every page of one walk comes from the same hourly publish; a superseded generation stays readable for at least an hour after the next publish, then its cursors answer 410. The /3 single-response dump is retired.'
parameters:
- name: section
in: query
schema:
type: string
enum:
- events
- context_events
- fleet_events
default: events
description: Which list to page through. With a cursor it may be omitted; a value that differs from the cursor's section is 400.
- name: cursor
in: query
schema:
type: string
description: Opaque. Pass next_cursor from the previous page exactly as returned. A malformed cursor is 400.
responses:
'200':
description: One page of one section.
content:
application/json:
schema:
type: object
required:
- schema
- generated_at
- generation
- ledger_schema
- framing
- stat
- counts
- section
- page
- pages
- items
- next_cursor
properties:
schema:
type: string
const: mcpindex.drift.ledger/4
generated_at:
type: string
description: When the latest index was published. The same on every page.
generation:
type: string
description: The generation the items belong to. A cursor keeps it, so every page of one walk carries the same value.
ledger_schema:
type: string
enum:
- mcpindex.drift.ledger/2
- mcpindex.drift.ledger/3
description: The row semantics the drain built. Under /3, publisher-wide changes are counted once in fleet_events.
framing:
type: string
stat:
type: object
description: Headline counts from the latest published generation.
counts:
type: object
additionalProperties:
type: integer
description: Row counts from the latest published generation.
section:
type: string
enum:
- events
- context_events
- fleet_events
page:
type: integer
description: Zero-based page number.
pages:
type: integer
description: Page count for this section in this generation.
items:
type: array
items:
type: object
description: 'Rows of the requested section, validated: malformed event and context rows are dropped and free fields bounded, so a page can hold fewer rows than counts suggests.'
next_cursor:
type:
- string
- 'null'
description: Pass as ?cursor= for the next page; null on the last page.
'400':
description: invalid_section, invalid_cursor or section_cursor_mismatch.
'410':
description: 'cursor_expired: that generation''s pages are gone. restart is the path that starts the section again.'
content:
application/json:
schema:
type: object
properties:
error:
type: string
const: cursor_expired
restart:
type: string
'429':
description: Rate limited; see retry-after.
'503':
description: The ledger is not published right now (missing, stale or malformed). No rows are served.
tags:
- Ledger