Developers

A public, read-only API plus badges, embeds, and CSV exports — all serving the same demand-side public signal the site shows. CORS-open, cached, no key required. Please be reasonable; this runs on a free tier.

JSON API

Base path /api/v1 · responses are JSON · open CORS

GET/api/v1/servers?q=&kind=&client=&sort=&page=&pageSize=

Query the catalog. sort = observed | downloads | stars | name.

GET/api/v1/servers/<id>

One server: facts, adoption count, client breakdown, and daily trend.

GET/api/v1/lists

Category leaderboards — top servers per category.

GET/api/v1/lists/<slug>

One category's full ranked list.

GET/api/v1/insights

Ecosystem totals, top adoption, kind distribution, client landscape, co-occurrence.

GET/api/export?kind=repos&server=<id>

CSV: every public repo wiring up a server.

GET/api/export?kind=stack&owner=<login>

CSV: every server a GitHub owner's repos use.

Example: curl https://axregistry.com/api/v1/servers?sort=observed&pageSize=5

Adoption badge

A live SVG of the observed-repo count — paste into any README

[![ax-ray](https://axregistry.com/badge/npm/<scope>/<name>.svg?metric=adoption)](https://axregistry.com/server/...)

The exact snippet for any server is on its page (and on the claim page).

Embeddable card

A self-contained HTML card for docs and dashboards

<iframe src="https://axregistry.com/embed/npm/<scope>/<name>?theme=dark"
  width="340" height="64" frameborder="0" style="border:0"></iframe>

Shows the live adoption count and trend sparkline. ?theme=light for light backgrounds.

CSV export

The reverse-lookup tables, downloadable

  • /api/export?kind=repos&server=<id> — repos using a server (also the Export CSV button on any repos-using view).
  • /api/export?kind=stack&owner=<login> — the MCP stack of a GitHub owner (the org profiler).
Observations, not endorsements — observed, measured, listed, never verified or safe. Methodology.