mcpindex Ledger API

The Ledger API from mcpindex — 1 operation(s) for ledger.

GitHub OpenAPI

Operations 1

GET /api/v1/ledger Public drift ledger: contract changes the crawler observed, paged #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mcpindex-ai:mcpindex-ai-ledger-api"
All apis
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.

Get an API 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 Specification

mcpindex-ai-ledger-api-openapi.yml Raw ↑
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