For agent builders
Give your agent public records it can cite.
Wire source-linked records across healthcare, federal procurement, sanctions and watchlists, enforcement, and corporate and securities filings into your agent. Drop the hosted Fonteum MCP server into Claude Desktop, Cursor, or any LangGraph / OpenAI / Google ADK pipeline, and preserve the returned source, as-of date, snapshot digest, re-check URL, and limitations exactly as supplied. Nullable fields stay null.
Quickstart
Pick a path. Every one runs against the live demo key.
curl, TypeScript, and Python run with the fnt_DEMO_PUBLIC_V1 sample key. For account-specific limits, set FONTEUM_API_KEY after you Request API access. The MCP config is labeled for use after package publication. Agents can also read the machine-readable LLM index.
curl https://api.fonteum.com/v1/npi/1234567893 \
-H "Authorization: Bearer fnt_DEMO_PUBLIC_V1" \
-H "Accept: application/json"No signup. The read-only demo key fnt_DEMO_PUBLIC_V1 is limited to 20 requests/minute and 100 requests/day per trusted source IP.
// No SDK yet — raw fetch. SDK ships in Q3.
const r = await fetch("https://api.fonteum.com/v1/npi/1234567893", {
headers: { "Authorization": "Bearer fnt_DEMO_PUBLIC_V1", "Accept": "application/json" },
});
const provider = await r.json();
console.log(provider.organization_name, provider._snapshot, provider._doi);The demo response includes its available provenance fields. Read provider._snapshot for the recorded snapshot date and provider._doi when that dataset publishes a DOI.
import requests
r = requests.get(
"https://api.fonteum.com/v1/npi/1234567893",
headers={"Authorization": "Bearer fnt_DEMO_PUBLIC_V1", "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.
{
"_comment": "Future stdio config for @fonteum/mcp@0.5.0, pending operator publication. npm currently serves 0.4.0; do not run this config until 0.5.0 is published.",
"mcpServers": {
"fonteum": {
"command": "npx",
"args": [
"-y",
"@fonteum/mcp@0.5.0"
],
"env": {
"FONTEUM_API_KEY": "${FONTEUM_API_KEY}"
}
}
}
}Drop this into Claude Desktop, Cursor, Cline, or Continue. The @fonteum/mcp reads the issued key from FONTEUM_API_KEY — see the MCP server section below for the nine-tool contract.
What you get back
One flat record with nullable provenance metadata.
The highlighted underscore-prefixed fields are the provenance contract: source, snapshot pin, methodology version, confidence, coverage window, persistent-identifier slot, and integrity-reference slot. Availability varies by source and response; no fact-to-signature relationship should be inferred from a separate snapshot attestation.
{
"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": null,
"exclusion_coverage_status": "indeterminate",
"exclusion_determination": "indeterminate",
"exclusion_coverage_message": "Synthetic demo fixture — no live exclusion clearance is issued.",
"quality_score_composite": 0.94,
"open_payments_total_2024": 12450,
"_source": "Synthetic demo fixture — not a live source record",
"_source_url": null,
"_dataset_id": "synthetic-demo-npi",
"_snapshot": null,
"_methodology": "synthetic-demo-v1",
"_last_checked": null,
"_confidence": null,
"_data_availability": "synthetic_demo_fixture; exclusion_coverage_indeterminate",
"_pipeline_version": null,
"_doi": null,
"_license": "Synthetic example; no source-record license asserted",
"_coverage_period_start": null,
"_coverage_period_end": null,
"_slsa_provenance_url": null
}Public-record source areas
One product, multiple public-record domains.
Fonteum maintains an active production source registry, whose status does not establish loaded, complete, fresh, or displayable coverage. The generated catalog is a separate list of catalog entries. Responses carry nullable source and observation context according to the route and underlying evidence.
Healthcare
Provider, facility, quality, ownership, and program-integrity records from public healthcare sources.
Federal procurement
Entity registration, award, exclusion, and ownership records for federal contractors.
Sanctions and watchlists
Dated records from U.S., EU, UK, and UN public sanctions and watchlist sources.
Enforcement and integrity
Public enforcement, exclusion, and program-integrity records with available source and observation-date context.
Corporate and securities
Public corporate-register and securities-filing records where Fonteum publishes a documented source surface.
Use the source catalog and each record’s metadata to understand coverage and limitations for the specific fact you need.
MCP server (Model Context Protocol)
The hosted v1.1.0 Streamable HTTP endpoint works today. The @fonteum/mcp@0.5.0 stdio source is not yet published; it is ready in-repo for operator publication and will work with Claude Desktop, Cursor, Cline, Continue, and other MCP-compatible clients after it is published. npm currently serves 0.4.0.
Hosted MCP v1.1.0 · @fonteum/mcp@0.5.0 pending operator publication · nine read-only tools
# Run only after the operator publishes @fonteum/mcp@0.5.0.
# npm currently serves @fonteum/mcp@0.4.0.
npm install -g @fonteum/mcp@0.5.0{
"_comment": "Future stdio config for @fonteum/mcp@0.5.0, pending operator publication. npm currently serves 0.4.0; do not run this config until 0.5.0 is published.",
"mcpServers": {
"fonteum": {
"command": "npx",
"args": [
"-y",
"@fonteum/mcp@0.5.0"
],
"env": {
"FONTEUM_API_KEY": "${FONTEUM_API_KEY}"
}
}
}
}Nine read-only tools
- fonteum_lookup_npiLook up a US healthcare provider by 10-digit NPI in CMS NPPES and return the available provider record plus exclusion and program-integrity context. Returns dated source context; source_file and snapshot_digest are nullable when no single retained snapshot represents the response. Use for NPI lookup, provider identity, taxonomy, practice-location, or provider due-diligence questions.
- fonteum_lookup_contractorLook up a US federal contractor by UEI or CAGE in available SAM.gov, USASpending, FAPIIS, and FAR 4.18 records. Returns dated source context; source_file and snapshot_digest are nullable when no single retained snapshot represents the response. Use for contractor identity, registration, award, responsibility, or ownership due diligence.
- fonteum_search_providersSearch US healthcare providers in loaded CMS NPPES specialty caches by vertical and state, with optional county context. Returns dated source context and up to 100 records; source_file and snapshot_digest may be null. Use for provider discovery by specialty and geography.
- fonteum_check_exclusionCheck whether a US healthcare provider by NPI appears in available exclusion or integrity sources: OIG LEIE, SAM.gov exclusions, available state Medicaid lists, OIG Corporate Integrity Agreements, and CMS Civil Money Penalties. Returns dated source context and fail-closed coverage; source_file and snapshot_digest may be null for the multi-source result. Use for exclusion screening, provider or vendor due diligence, or any ‘is this NPI excluded?’ question.
- fonteum_search_sanctionsSearch a person or organization name across available sanctions and watchlist data from OFAC, the EU, the UK, and the UN, plus named exclusion sources held by Fonteum. Returns dated matches with source context; source_file and snapshot_digest may be null for the multi-source result. Use for sanctions screening, entity due diligence, or any ‘is this entity sanctioned?’ question.
- fonteum_lookup_contractor_historyLook up a US federal contractor record as of a requested date using UEI or CAGE. Retained history is currently limited to USASpending award rows; other fields may be current, absent, or nullable. Returns dated source context. Use for historical award research or contractor change questions.
- fonteum_recheck_snapshotRecheck a Fonteum snapshot by snapshot id and return its as_of_date, snapshot_digest, public verifiable_url, and source_file only when explicit retained-artifact metadata is available. Without an id, returns chain status without treating the chain head as a snapshot digest. Use for snapshot integrity checks, citation support, or reproducing a retained source file.
- fonteum_list_sourcesList Fonteum’s public-record source catalog with available authority, vertical, cadence, official URL, and separately dated platform coverage. Catalog presence does not prove loaded, fresh, or complete coverage. Use for source discovery, coverage questions, or choosing a dataset before a lookup.
- fonteum_get_dataset_infoGet Fonteum API and MCP methodology, provenance-field definitions, generated source catalog, and separately dated platform coverage. Field population varies by source and response. Use for interpreting Fonteum outputs, citation fields, dataset limitations, or integration planning.
Every tool is annotated readOnlyHint: true. Successes and errors include source_file, as_of_date, snapshot_digest, and verifiable_url at the top level; the first three stay null when evidence is unavailable or composite.
- Open
~/Library/Application Support/Claude/claude_desktop_config.json(macOS) or%APPDATA%\Claude\claude_desktop_config.json(Windows). - After @fonteum/mcp@0.5.0 is published, paste the mcp.json config above and supply an issued
FONTEUM_API_KEYfor protected REST bridges. - 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
Add federal-data citations to your agent in 60 seconds.
Drop our MCP server into your agent or call the API with fnt_DEMO_PUBLIC_V1. The read-only sample is limited to 20 requests/minute and 100 requests/day per trusted source IP.