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 keep the returned source, capture date, and limitations with each fact.
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.
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.4.0; do not run it until that version is published. The bundled read-only sample key runs the documented demo path; replace it with fnt_your_api_key after issuing an account key for production limits.",
"mcpServers": {
"fonteum": {
"command": "npx",
"args": [
"-y",
"@fonteum/mcp@0.4.0"
],
"env": {
"FONTEUM_API_KEY": "fnt_DEMO_PUBLIC_V1"
}
}
}
}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 seven-tool contract.
What you get back
One flat record. A nullable fourteen-field provenance envelope.
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; every published fact identifies its source and capture date.
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 source and capture-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.0.0 Streamable HTTP endpoint works today. The @fonteum/mcp@0.4.0 stdio source 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.
Hosted MCP v1.0.0 · @fonteum/mcp@0.4.0 not yet published · seven read-only tools
# Run only after @fonteum/mcp@0.4.0 is published to npm:
npm install -g @fonteum/mcp@0.4.0{
"_comment": "Future stdio config for @fonteum/mcp@0.4.0; do not run it until that version is published. The bundled read-only sample key runs the documented demo path; replace it with fnt_your_api_key after issuing an account key for production limits.",
"mcpServers": {
"fonteum": {
"command": "npx",
"args": [
"-y",
"@fonteum/mcp@0.4.0"
],
"env": {
"FONTEUM_API_KEY": "fnt_DEMO_PUBLIC_V1"
}
}
}
}Seven read-only tools
- fonteum_resolve_entityResolve an NPI, UEI, or CAGE identifier to its canonical public-record entity.
- fonteum_search_recordsSearch source-traced healthcare-provider records by name, specialty, or location.
- fonteum_check_exclusions_and_sanctionsCheck one NPI against deployed US exclusion and debarment sources; name screening is unavailable.
- fonteum_get_record_as_ofRead a federal-contractor record as it stood on a captured date.
- fonteum_recheckRead the attestation-chain head or one immutable signed chain link.
- fonteum_list_sourcesList the multi-vertical government-source catalog.
- fonteum_dataset_infoRead methodology and provenance metadata for one deployed dataset slug.
- Open
~/Library/Application Support/Claude/claude_desktop_config.json(macOS) or%APPDATA%\Claude\claude_desktop_config.json(Windows). - After @fonteum/mcp@0.4.0 is published, paste the mcp.json config above. Its read-only sample key runs the documented demo path; replace it with an account key for production limits.
- 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.