Start here
Quickstart
Three install paths in one page — cURL, npm/MCP, and OpenAPI. Pick the transport that matches your stack and ship a working call in under two minutes.
Docs
Build with CribScore.
CribScore exposes childcare licensing, inspections, trust, evidence, and predictive risk through one REST API and one MCP server.
Agent-friendly by design: every surface ships with OpenAPI, `llms.txt`, MCP tools, and a public contract that stays in lock-step with production.
Four deep modules.
The docs collapse into four categories, each with a hub page plus deep sub-pages. Skim the inline links below or browse the full category.
REST
API Reference
Every CribScore endpoint, grouped by resource. Facilities, trust, decision memo, webhooks, and discovery — all OpenAPI-backed.
Agents
MCP
Connect Claude, Cursor, and other agent runtimes to CribScore over the Model Context Protocol — local stdio or hosted streamable-HTTP.
Tutorials
Recipes
End-to-end recipes: build a childcare agent, replace state portal scraping, wire webhook automations, and ship a Python or TypeScript starter.
Public contract
Endpoint reference.
Discoverable REST routes — every one of these is in OpenAPI, MCP, and the Postman collection. The full reference with params and examples lives on the API page.
| Method | Path | Summary |
|---|---|---|
| GET | /api/health | Public API health summary with route-health status. |
| GET | /v1/facilities | Search public childcare facilities by geography and filters. |
| GET | /v1/facilities/{id} | Canonical public facility detail with embedded facility_proof for source, freshness, trust, and abstention semantics. |
| GET | /v1/facilities/{id}/proof | Compact proof object for source URLs, freshness, trust tier, scoreability, and abstention reasons. |
| GET | /v1/facilities/compare | Compare 2-5 facilities side by side. |
| POST | /v1/decision/memo | Trust-aware shortlist and memo generation. |
| GET | /v1/trust/jurisdictions | Jurisdiction trust metrics and decision-grade overlays. |
| GET | /v1/states | State directory with trust and decision-grade metrics. |
Pick a transport
First call in under two minutes.
Three transports, one bearer token. Deep walkthroughs with auth, errors, and pagination live in /docs/quickstart.
curl -sS "https://api.cribscore.co/v1/facilities?zip_code=90003&limit=5" \
-H "Authorization: Bearer YOUR_API_KEY"# Zero-install: spawn the CribScore MCP server on demand.
npx -y @cribscore/mcp
# Or pin to a release:
npm install -g @cribscore/mcp
export MCP_API_KEY="YOUR_API_KEY"# Download the spec, then generate a typed client.
curl -sS https://api.cribscore.co/openapi.json -o cribscore.openapi.json
npx @openapitools/openapi-generator-cli generate \
-i https://api.cribscore.co/openapi.json \
-g typescript-fetch \
-o ./src/cribscore-clientResources
Distribution surfaces.
Machine-readable mirrors of everything on this page. Each surface stays in lock-step with the API on every release.