@xcircl/sdk

US regulated-care provider data for AI agents, clinic finders, and diligence teams. Zero-dependency TypeScript client for xcircl.com — verified provider facts cross-checked against NPPES, the FDA, and where available LegitScript and state boards; source-linked and timestamped. GLP-1 is the deepest vertical today, with more in the pipeline.

A free key (email signup, 30s → signup) returns identity fields (name, location, NPI) from public registries, plus a notice describing what a paid key adds. Provider endpoints require XCIRCL_API_KEY; missing or invalid keys return 401. Free keys include 500 provider calls/month. A paid key unlocks LegitScript / state-license / FDA compliance signals and published cash prices, each with source + verification timestamp — see plans. Field tiering, quotas and vertical binding are all enforced server-side — this client contains zero gating logic.

Install

npm install @xcircl/sdk

Use

import { XcirclClient } from '@xcircl/sdk';

const apiKey = process.env.XCIRCL_API_KEY;
if (!apiKey) throw new Error('Set XCIRCL_API_KEY first');
const xcircl = new XcirclClient({ apiKey });
// free key → identity fields; paid key → + compliance & price

const { data, notice } = await xcircl.searchProviders({
  vertical: 'glp1',
  city: 'Houston',
  state: 'TX',
});

for (const p of data) console.log(p.name, p.city, p.npi);
if (notice) console.log(notice);              // what a key would add

const compliance = await xcircl.checkCompliance(data[0].entity_id);

API surface: searchProviders, getProvider, checkCompliance, getCoverage, getSample. Errors throw XcirclApiError with .status, .message, .upgrade and .body — server messages are relayed verbatim.

Full docs, field dictionary and MCP server: github.com/xcircl/healthcare-provider-mcp.

License

MIT