MCP Census developer portal

The MCP Census developer resources for agents and CI: API keys, REST, MCP, OpenAPI, auth, and watch webhooks. Public sandbox is the live API under the free daily cap.

Product · The MCP Census · mcpcensus.com

Quickstart

1. Optional: mint a key at /account (GitHub or email). Header: x-api-key.
2. Agents: add the MCP server https://api.mcpcensus.com/mcp (see prompt.md).
3. REST: GET https://api.mcpcensus.com/v1/search?q=github then POST /v1/preflight with one exact canonical name.
4. Stop on BLOCK. Ask a human on REVIEW. Never install from a Census result alone.

Sandbox

There is no separate staging host. The public MCP Census API is the sandbox.

• Anonymous: 10 unique lookups/day per IP.
• Free account key: 100 unique lookups/day.
• Unmetered: GET /v1/stats, GET /v1/recent, GET /v1/coverage, GET /v1/policies.

curl -s https://api.mcpcensus.com/v1/stats
curl -s "https://api.mcpcensus.com/v1/search?q=github"
curl -s https://api.mcpcensus.com/v1/policies

Auth

API keys live on the account at mcpcensus.com/account. Send x-api-key. Anonymous calls work until the daily cap. Lost keys are emailed to the account address from the API page — the key is never shown in HTML.

MCP server

Endpoint: https://api.mcpcensus.com/mcp (streamable HTTP). Tools: census_search, census_lookup, census_preflight, census_policy_list, census_stats, census_recent, census_coverage, and the watch trio. Full list: llms.txt.

Webhooks

Watch one server: POST https://api.mcpcensus.com/v1/watch (API key). Events fire only on observed transitions: remote down/up, health, verification legs, security. Headers: X-Census-Event, X-Census-Signature, X-Census-Watch-Id. Docs: /api#watch.

Agent files

• /llms.txt — agent map, including when to use The MCP Census
• /agent-instructions.md — when-to-use + call pattern
• /agent-setup/prompt.md — install commands per host
• /openapi.json — OpenAPI
• /bot — crawler identity

Contact: info@mcpcensus.com. Product name: The MCP Census. Domain: mcpcensus.com.