# CribScore
> CribScore is the childcare API and MCP server for licensing, inspections, trust metrics, predictive risk, evidence trails, and agent-ready workflows.

## Canonical host
https://www.cribscore.co

## Human-readable docs
- https://www.cribscore.co/ - Marketing homepage and canonical public entry point.
- https://www.cribscore.co/docs - Crawlable docs hub for REST, MCP, llms.txt, and public contract details.
- https://www.cribscore.co/docs/childcare-api - Childcare API guide for facility search, facility detail, trust metrics, and decision workflows.
- https://www.cribscore.co/docs/childcare-licensing-api - Childcare licensing API guide for source-linked provider records and state coverage truth.
- https://www.cribscore.co/docs/daycare-inspection-api - Daycare inspection API guide for inspections, evidence, score history, and risk signals.
- https://www.cribscore.co/docs/remote-mcp - Remote MCP install guide for connecting agent clients to the hosted CribScore endpoint.
- https://www.cribscore.co/docs/local-mcp-install - Local npm and npx install guide for the CribScore MCP package.
- https://www.cribscore.co/docs/openapi - OpenAPI reference guide for generated clients, collections, and contract verification.
- https://www.cribscore.co/docs/python-example - Python example for facility search and trust reads against the CribScore API.
- https://www.cribscore.co/docs/typescript-example - TypeScript example for trust reads and backend integrations against the CribScore API.
- https://www.cribscore.co/docs/build-a-childcare-agent - Tutorial for building childcare agents with CribScore MCP and API surfaces.
- https://www.cribscore.co/docs/replace-state-portal-scraping - Migration guide for replacing brittle state portal scraping with CribScore.
- https://www.cribscore.co/docs/webhook-automation-recipes - Automation recipes for Slack, Teams, email relays, and no-code webhook flows.
- https://www.cribscore.co/developers - Developer onboarding with API routes, auth model, and live status.
- https://www.cribscore.co/developers#mcp-install - MCP install snippets and remote MCP onboarding section of the developer portal.
- https://www.cribscore.co/agents - Remote MCP, tools, resources, prompts, and install guidance.
- https://www.cribscore.co/trust - Public trust and readiness surface.
- https://www.cribscore.co/data-sources - Public data source methodology, source mix, freshness, and provenance explanations.
- https://www.cribscore.co/use-cases - Use-case hub for teams applying CribScore data to insurance, benefits, relocation, and agent workflows.
- https://www.cribscore.co/use-cases/insurance - Insurance use case for childcare risk screening, trust thresholds, and source-linked facility proof.
- https://www.cribscore.co/use-cases/benefits-platforms - Benefits platform use case for provider network checks, family guidance, and trustworthy childcare search.
- https://www.cribscore.co/use-cases/relocation - Relocation use case for comparing childcare availability, source freshness, and facility-level proof by market.
- https://www.cribscore.co/reports - Monthly coverage, trust, and decision-grade reports
- https://www.cribscore.co/reports/may-2026-coverage - May 2026 coverage report covering scored facility counts and unmaterialized state agency percentages.
- https://www.cribscore.co/reports/may-2026-trust-status - May 2026 trust status report covering launch-ready jurisdictions and trust-tier movement.
- https://www.cribscore.co/reports/may-2026-decision-grade - May 2026 decision-grade report covering decision-grade overlay readiness and abstention coverage.
- https://www.cribscore.co/changelog - Public changelog for API, MCP, trust, and discovery-surface releases.
- https://www.cribscore.co/states - State directory and launch/readiness coverage.
- https://www.cribscore.co/search - Public childcare facility search. URL-driven query params: zip, state, facility_type, license_status, min_score, age_months, radius, name_query, sort, page. One of zip or state is required for results.
- https://www.cribscore.co/docs/quickstart - Three install paths for CribScore: cURL one-liner, npm/MCP package, and OpenAPI spec. Pick the one that matches your stack and ship a working call in under two minutes.
- https://www.cribscore.co/docs/api - The complete REST reference for CribScore: facility search, facility detail, trust, decision memo, webhooks, and evidence — typed, source-linked, and OpenAPI-backed.
- https://www.cribscore.co/docs/api/facilities - Search, detail, compare, risk forecast, and evidence endpoints for licensed childcare facilities — source-linked, trust-tagged, and ready for underwriting + agent workflows.
- https://www.cribscore.co/docs/api/trust - Trust tier, scored facility counts, materialization, and per-state coverage — the routes that gate when CribScore data is safe to use in production workflows.
- https://www.cribscore.co/docs/api/decision - Generate an explainable shortlist memo from geography + child + budget inputs. Returns a ranked list, per-option recommendation, and a human-readable summary.
- https://www.cribscore.co/docs/api/webhooks - Subscribe to score, license, and violation events for a facility. Deliveries are signed, idempotent, and retried with exponential backoff.
- https://www.cribscore.co/docs/mcp - CribScore exposes its full surface as MCP tools — install locally with npm or connect to the hosted remote endpoint with one config block.
- https://www.cribscore.co/docs/mcp/local - Install the CribScore MCP package from npm and run it locally over stdio. Use this when you want version pinning, offline operation, or local API testing.
- https://www.cribscore.co/docs/mcp/remote - Connect your agent client to the hosted CribScore MCP endpoint with one streamable-HTTP config. Zero install, scales with you, bearer-auth.
- https://www.cribscore.co/docs/recipes - Task-shaped tutorials: build an agent, replace state portal scraping, wire webhook automation, and language-specific Python and TypeScript starters.
- https://www.cribscore.co/docs/recipes/build-an-agent - From zero to a working agent that searches providers, reads trust, compares facilities, and cites evidence — using CribScore MCP and bearer auth.
- https://www.cribscore.co/docs/recipes/replace-portal-scraping - Migrate from brittle Playwright scrapers across 50 state portals to one source-linked, trust-tagged CribScore API.
- https://www.cribscore.co/docs/recipes/webhook-automation - Wire CribScore webhook events into Slack, Microsoft Teams, email, or n8n / Zapier / Make without changing the API contract.
- https://www.cribscore.co/docs/recipes/python - Call CribScore from a Python backend with `httpx`. Searches, trust reads, decision memos, and a pre-flight trust cache — production-shaped patterns only.
- https://www.cribscore.co/docs/recipes/typescript - Call CribScore from TypeScript — Next.js server components, route handlers, and serverless functions. Native `fetch`, typed env, error-safe.

## Machine-readable docs
- https://www.cribscore.co/llms.txt
- https://api.cribscore.co/docs - Interactive API explorer (Scalar UI, in-browser try-it with Bearer token)
- https://api.cribscore.co/openapi.json - Public OpenAPI spec (filtered, agent-safe)
- https://api.cribscore.co/mcp - Remote MCP endpoint (JSON-RPC 2.0)
- https://www.npmjs.com/package/@cribscore/mcp - npm package (latest 0.3.0)
- https://www.cribscore.co/postman/CribScore.postman_collection.json
- https://www.cribscore.co/mcp/server.json
- https://www.cribscore.co/changelog/feed.json
- https://www.cribscore.co/changelog/rss.xml

## API base
https://api.cribscore.co/v1

## Public/self-serve routes
- GET /api/health - Public API health summary with route-health status. Includes unified `api`/`supabase`/`mcp` triad and `last_state_ingest_at` for agent dashboards. Also served byte-identically at `/health` for bare-path uptime probes.
- GET /llms.txt - Machine-readable site map mirrored from www.cribscore.co/llms.txt so MCP clients landing on the API host get the same discovery payload without a redirect hop.
- GET /v1/facilities?zip=78701&state=TX&facility_type=center&license_status=active&min_score=70&age_months=24&radius=8&sort=safety_score&page=2 - Search public childcare facilities by geography and filters. Supported query params: `zip` (or `zip_code`), `state`, `facility_type` (center|home|school_based), `license_status` (active|probationary|expired), `min_score` (0-100), `age_months` (or `child_age_months`, 0-216), `radius` (1-50, miles), `name_query`, `sort` (safety_score|distance|name), `limit` (1-100, default 24), `offset`/`page`. Omit `min_score` to match the default (no floor).
- 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. Public read mode (unauthenticated) returns a lean projection (slug, name, trust_tier, scored_facility_count, unmaterialized_state_agency_pct, last_refreshed_at); Bearer auth returns the full StateInfo payload.
- GET /v1/coverage/snapshot - Single truth coverage manifest shared by state, trust, and proof surfaces.
- GET /v1/prices - County childcare benchmark pricing.
- GET /v1/reports - List monthly coverage, trust, and decision-grade reports with publish dates and slugs.
- GET /v1/reports/{slug} - Report detail with summary metrics, sections, and source-linked figures.
- GET /v1/mcp/tool-catalog - Machine-readable MCP tool catalog with schemas, examples, and REST hints.
- GET /v1/docs - List all CribScore docs pages with slug, title, category, summary, and canonical URL — used by agent clients to discover documentation surfaces programmatically.
- GET /v1/docs/{path} - Fetch a single CribScore docs page by path (e.g. `api/facilities`) returning title, summary, sections, code samples, and related links.

## Auth
- `/v1/*` and `/mcp` use `Authorization: Bearer {api_key}`.
- Private workspace routes live under `/family` and `/v2/*` and are intentionally omitted from this discovery surface.

## Remote MCP
https://api.cribscore.co/mcp

Tools:
- `cribscore_search`
- `cribscore_search_facilities`
- `cribscore_facility`
- `cribscore_facility_proof`
- `cribscore_safety_check`
- `cribscore_compare`
- `cribscore_decision_memo`
- `cribscore_risk_forecast`
- `cribscore_trust_jurisdictions`
- `cribscore_prices`
- `cribscore_evidence_summary`
- `cribscore_list_reports`
- `cribscore_get_report`
- `cribscore_list_docs`
- `cribscore_get_doc`

Resources:
- `cribscore://coverage/states`
- `cribscore://coverage/snapshot`
- `cribscore://trust/jurisdictions`
- `cribscore://memory/active-profile`
- `cribscore://methodology/data-sources`
- `cribscore://examples/facility-payload`

Prompts:
- `compare-facilities`
- `decision-memo`
- `memory-aware-shortlist`
- `underwriting-review`
- `family-fit-shortlist`

## MCP package
- Package name: `@cribscore/mcp`
- Source: https://github.com/musa8026/CribScore/tree/main/apps/mcp
- npm: https://www.npmjs.com/package/@cribscore/mcp
- Status: published
- Registry name: `io.github.musa8026/cribscore`
- Registry metadata: https://www.cribscore.co/mcp/server.json
- Postman collection source: https://www.cribscore.co/postman/CribScore.postman_collection.json

## Notes
- `decision-grade` is an overlay on top of the launch-tier trust model.
- Public facility payloads expose canonical merge metadata and structured completeness reason codes.
- Facility, state, trust, report, and docs pages are intended citation surfaces for answer engines.