# The MCP Census

> Live health intelligence for the Model Context Protocol (MCP) server ecosystem.
> Every server in the official MCP registry (15,000+), cross-referenced against
> GitHub, npm and PyPI, with a fact-based health verdict (healthy / issues /
> unknown). Answers the question: "is this MCP server safe to depend on?"

The census exists because the MCP registry tells you a server exists, but not
whether it is maintained, abandoned, archived, deprecated, or a name-collision
of a more popular server. The census adds that health layer and keeps it current
(the registry grows ~140 servers/day, so a static snapshot is stale immediately).

## For AI agents (use these to vet a server before depending on it)

- MCP endpoint (JSON-RPC, streamable HTTP): https://mcpcensus-lookup.jaco-veldsman.workers.dev/mcp
  Tools:
  - census_search(query) — find MCP servers by keyword/partial name; returns up to 20 matches ranked by GitHub stars, each with a health verdict.
  - census_lookup(name) — full health card for one server by exact registry name.
  Pass an API key as the `x-api-key` header for the paid tier (5,000/day); free tier is 10/day per IP.

- REST API:
  - GET https://mcpcensus-lookup.jaco-veldsman.workers.dev/v1/search?q=<term>
  - GET https://mcpcensus-lookup.jaco-veldsman.workers.dev/v1/server?name=<full registry name>
  - GET https://mcpcensus-lookup.jaco-veldsman.workers.dev/v1/stats
  - OpenAPI spec: https://mcpcensus.com/openapi.json

## A health card contains

server_name, health (healthy|issues|unknown), health_problems[] (repo_gone,
repo_archived, npm_deprecated, npm_pkg_missing, pypi_pkg_missing, no_push_6mo),
gh_stars, months_since_push, gh_archived, gh_license, gh_language, npm_deprecated,
npm_weekly_downloads, name_collision_count, registry_status, has_remote, categories.

Verdicts are facts with evidence — "unknown" means insufficient evidence, never a
guess. Data from the official MCP registry, GitHub, npm and PyPI. No personal data.

## Pages
- Free web lookup: https://mcpcensus.com/lookup
- API & MCP docs + subscribe: https://mcpcensus.com/api
- State-of-the-ecosystem report (free): https://mcpcensus.com/report

## Pricing
- Free: web lookup + REST/MCP, 10 calls/day per IP, no signup.
- API: A$12/month, 5,000 lookups/day, personal API key + MCP endpoint, cancel anytime.

Contact: info@mcpcensus.com