For agent builders

Add federal-data citations to your agent in 60 seconds

Cryptographically signed, snapshot-pinned, methodology-versioned responses from five US federal healthcare sources. Drop our MCP server into Claude Desktop, Cursor, or any LangGraph / OpenAI / Google ADK pipeline.

Download mcp.json →

EARLY PILOT PARTNERS

Quickstart

Pick a path. Every one runs against the live demo key.

curl, TypeScript, Python, or a drop-in MCP config. All four use the pk_dx_sample demo key — no signup, no card.

curl

curl https://api.fonteum.com/v1/npi/1234567893 \
  -H "X-Fonteum-Key: pk_dx_sample" \
  -H "Accept: application/json"

No signup. The demo key pk_dx_sample is rate-limited to 100 requests/hour per IP, read-only.

quickstart.ts

// No SDK yet — raw fetch. SDK ships in Q3.
const r = await fetch("https://api.fonteum.com/v1/npi/1234567893", {
  headers: { "X-Fonteum-Key": "pk_dx_sample", "Accept": "application/json" },
});
const provider = await r.json();
console.log(provider.organization_name, provider._snapshot, provider._doi);

Every record carries the 14 provenance fields. Read provider._snapshot for the snapshot pin and provider._doi for the dataset citation.

quickstart.py

import requests
r = requests.get(
    "https://api.fonteum.com/v1/npi/1234567893",
    headers={"X-Fonteum-Key": "pk_dx_sample", "Accept": "application/json"},
)
provider = r.json()
print(provider["organization_name"], provider["_snapshot"], provider["_doi"])

Same flat shape across every language. The underscore-prefixed keys are the provenance contract.

mcp.json

{
  "mcpServers": {
    "fonteum": {
      "command": "npx",
      "args": [
        "-y",
        "@fonteum/mcp"
      ],
      "env": {
        "FONTEUM_API_KEY": "pk_dx_sample"
      }
    }
  }
}

Drop this into Claude Desktop, Cursor, Cline, or Continue. The @fonteum/mcp server is source-available in-repo today and publishes to npm in Q3 2026 — see the MCP server section below for the install path.

What you get back

One flat record. Fourteen provenance fields on every response.

The highlighted underscore-prefixed fields are the provenance contract: source, snapshot pin, methodology version, confidence, coverage window, DOI, and the signed build attestation. Every field your agent cites is traceable to a federal source release.

GET /v1/npi/1234567893

{
  "npi": "1234567893",
  "type": "organization",
  "organization_name": "EXAMPLE MEDICAL CENTER",
  "address": {
    "line1": "100 EXAMPLE ST",
    "city": "AUSTIN",
    "state": "TX",
    "postal_code": "78701"
  },
  "is_enrolled_medicare": true,
  "is_excluded_oig": false,
  "quality_score_composite": 0.94,
  "open_payments_total_2024": 12450,
  "_source": "NPPES + PECOS + LEIE + CareCompare + OpenPayments",
  "_source_url": "https://download.cms.gov/nppes/...",
  "_dataset_id": "nppes-2026-05",
  "_snapshot": "2026-05-26T00:00:00Z",
  "_methodology": "v1.2",
  "_last_checked": "2026-05-29T12:14:33Z",
  "_confidence": 0.97,
  "_data_availability": "full",
  "_pipeline_version": "git:57c5cfca",
  "_doi": "10.5072/fonteum/snapshot-2026-05-26",
  "_license": "CC-BY-4.0 (federal source) + Fonteum Composite Terms",
  "_coverage_period_start": "2026-05-01",
  "_coverage_period_end": "2026-05-26",
  "_slsa_provenance_url": "https://slsa.fonteum.com/2026-05-26/nppes.intoto.jsonl"
}

The sources you can query

Five US federal healthcare sources, joined on one identity.

Resolve a provider once and read across all five. Every value returns with its source release and snapshot pin attached.

NPPES

The CMS National Plan and Provider Enumeration System — the national provider registry. Name, address, taxonomy, and enumeration status for every NPI.

OIG LEIE

Office of Inspector General exclusion list. Refreshed monthly. Tells you if a provider is barred from federal healthcare programs.

CMS PECOS

Medicare enrollment. Enrollment status, reassignments, and the Provider Enrollment, Chain, and Ownership System record.

CMS Care Compare

Facility quality measures across nursing homes, home health, hospice, dialysis, and ambulatory surgical centers.

CMS Open Payments

Sunshine Act industry payments. Annual physician and teaching-hospital payment disclosures.

Plus HRSA HPSA shortage areas and BLS / BEA labor-market context for per-capita denominators. Seventeen-plus federal source families in the graph; the five above are exposed on the demo key.

MCP server (Anthropic Model Context Protocol)

One-line install. Works with Claude Desktop, Cursor, Cline, Continue, and any MCP-compatible client.

Source-available in-repo today (packages/mcp) · npm publish targeted Q3 2026

install

npm install -g @fonteum/mcp

mcp.json

{
  "mcpServers": {
    "fonteum": {
      "command": "npx",
      "args": [
        "-y",
        "@fonteum/mcp"
      ],
      "env": {
        "FONTEUM_API_KEY": "pk_dx_sample"
      }
    }
  }
}

Seven tools

fonteum_resolve_npiResolve a provider by NPI across all five federal sources in one call.
fonteum_resolve_ccnResolve a facility by CMS Certification Number (CCN).
fonteum_search_providersSearch the provider graph by name, taxonomy, or location.
fonteum_get_quality_scoreRead the composite quality score for a provider or facility.
fonteum_check_leieCheck OIG LEIE exclusion status for an NPI.
fonteum_get_open_paymentsRead Open Payments industry-payment totals for a physician.
fonteum_get_pipeline_provenanceRead the 14-tuple provenance contract for any returned record.

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).
Paste the mcp.json config above.
Restart Claude Desktop.
Ask: Look up NPI 1234567893 with Fonteum.

Pilot access

Need production rate limits, custom datasets, or signed enterprise terms? Request pilot access → pilot@fonteum.com

READY TO SHIP