# xcircl

> The source-linked, timestamped facts layer for regulated care services, delivered as a data API.
> Every outward field carries its official source and a verification timestamp.
> Full reference (complete API docs, field schema, pricing): https://xcircl.com/llms-full.txt

## What xcircl is
- A data-infrastructure company. Not a consumer directory, not a medical provider.
- Provides an API of supply-side facts about regulated-care providers (clinics, providers, services).
- Open core: the Agent is open source (MIT) — an MCP server for Claude/ChatGPT and a TypeScript SDK. It calls the free identity tier with a free key; verified signals + price sit behind a paid key.
- Agent repository: https://github.com/xcircl/healthcare-provider-mcp

## Publication boundary (live counts)
- Tracked: 6028 active provider records (transparency view only), spanning 1,955 cities across 50 states + DC.
- Verified (published tier, the API's default delivery): 870 providers — 770 NPPES-matched, 870 FDA-screened.
- Across the tracked set: 6028 of 6028 records FDA-screened; 62 LegitScript-certified (entering the published tier as they clear verification). State-license verification is in progress.
- Tracked records stay out of delivery until they clear verification. The free tier can inspect the tracked set with ?include=tracked; each such record self-declares "publish_tier":"internal_only".
- What you can query today: (1) US-wide provider identity — NPPES, all specialties, free key (?taxonomy=<NUCC code>), rolling out state by state; (2) glp1 — the deepest-verified vertical (FDA screening, prices, compliance signals); (3) pet veterinary — live, with a license-verified subset.
- Full roadmap (incl. datasets collected but not yet imported, and queued ones): https://xcircl.com/data/coverage/ — non-live datasets return no data yet.

## Sources (outward fields)
- NPPES / NPI Registry (CMS) — provider identity
- LegitScript — healthcare-merchant certification
- State licensing boards — licensure
- FDA — warning-letter screen
- CMS Care Compare — quality data (select verticals)
- Merchant-submitted — commercial details (labelled provider-reported until verified)
We do not use third-party platform ratings as outward facts. Unknown fields are returned empty, never invented.

## Technical teardowns (engineering-honest method write-ups; every figure injected live from /api/v1/coverage/)
- How we verify provider identity: https://xcircl.com/resources/how-we-verify-provider-identity/
  Every identity field points back to an official registry with a verification date. Here is the pipeline, and exactly where the honesty lines are.
- Why an NPI is not a license: https://xcircl.com/resources/why-an-npi-is-not-a-license/
  A National Provider Identifier is an administrative number, not proof of licensure or authority to practice. The distinction, from the source, and how we handle it.
- How FDA warning-letter matching works: https://xcircl.com/resources/how-fda-warning-letter-matching-works/
  Turning "appears on an FDA warning-letter list" into a responsible data field is mostly about not getting it wrong. The pipeline, and how we handle false positives.
Index: https://xcircl.com/resources/

## Key pages
- Coverage (live, dual-boundary): https://xcircl.com/data/coverage/
- Sources: https://xcircl.com/data/sources/
- Sample data (verified-only): https://xcircl.com/data/sample/
- API docs: https://xcircl.com/developers/docs/
- OpenAPI 3.1 spec (machine-readable): https://xcircl.com/openapi.json
- Technical teardowns: https://xcircl.com/resources/
- Pricing: https://xcircl.com/pricing/

## Plans
- Free key: $0 — identity fields, 500 calls/mo, 30-second email signup at https://xcircl.com/developers/signup/. Evaluation / non-commercial use; paid fields come back locked. Every call requires a key.
- Builder: $99/mo — full fields (compliance signals + price + timestamps), one vertical, 5,000 calls/mo, credit-card self-serve.
- Developer: $750/mo — full fields, multi-vertical, 25,000 calls/mo. Founding cohort: early adopters lock $375/mo for 12 months.
- Enterprise: contact sales (phone quote).

## API
- Base: https://xcircl.com/api/v1
- OpenAPI 3.1 spec (machine-readable contract): https://xcircl.com/openapi.json
- GET /providers?vertical=&state=&city=&business_mode=&limit=&offset=  (verified-only by default; free = identity fields, key = verified signals + price; free tier may add include=tracked for the transparency view)
- GET /providers/{entity_id|slug}
- GET /coverage   (public — tracked and verified counts)
- GET /sample     (public, 50-row full-schema sample, verified-only)

## Network
- trimsomo.com and petsomo.com are public applications powered by xcircl data.