Results carry nullable source, as-of, snapshot-digest, and re-check context, with coverage and limitations where available. Preserve null values rather than inferring missing evidence. The active production source registry is not a statement that every family has loaded, complete, fresh, or displayable records.
01 · CONNECT
One live hosted endpoint.
Use hosted MCP 1.1.0 at the Streamable HTTP endpoint https://fonteum.com/api/mcp. The matching @fonteum/mcp@0.5.0 stdio source is not published yet; it is pending operator publication. npm currently serves 0.4.0. The configuration below is for use only after publication. Hosted access is anonymous and rate-limited. The future package uses a Bearer credential for its protected REST bridges.
{
"_status": "Future stdio config — @fonteum/mcp@0.5.0 is pending operator publication; npm currently serves 0.4.0",
"mcpServers": {
"fonteum": {
"command": "npx",
"args": ["-y", "@fonteum/mcp@0.5.0"],
"env": { "FONTEUM_API_KEY": "${FONTEUM_API_KEY}" }
}
}
}Discovery document: https://fonteum.com/.well-known/mcp.json
02 · NINE READ-ONLY TOOLS
Use the canonical tool inventory.
The live hosted server and future stdio package contract expose the same nine tools with readOnlyHint: true. No tool mutates records, and a returned fact is not a clearance or a verdict.
fonteum_lookup_npi— Look 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_contractor— Look 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_providers— Search 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_exclusion— Check 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_sanctions— Search 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_history— Look 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_snapshot— Recheck 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_sources— List 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_info— Get 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.
03 · AGENT GUIDANCE
Keep the source context with the answer.
A public-record result is bounded by the issuer's publication scope and the coverage represented in the response. All four source-context keys are always present; source_file, as_of_date, and snapshot_digest can be null. Preserve those limitations and re-confirm material matches with the issuing authority.
Use Fonteum's hosted MCP endpoint (https://fonteum.com/api/mcp) for public-record grounding. For each returned fact, retain source_file, as_of_date, snapshot_digest, and verifiable_url exactly as returned; do not fill null values. Do not treat a missing, stale, or indeterminate result as a clearance, risk score, or endorsement. Treat a snapshot_digest as snapshot-level evidence, never as a signature over each returned fact. Re-check material matches with the issuing authority.
04 · DISCOVERY
Read the published contract before integrating.
- /openapi.json — public REST reference.
- /.well-known/agent.json — agent discovery card.
- /.well-known/mcp.json — hosted MCP discovery.
- /llms.txt — machine-readable product and source catalog.