Fonteum Mcp Server
Fonteum MCP Server
Hosted Model Context Protocol server for the source-provenanced US federal healthcare provider data graph.
Fonteum joins the federal healthcare datasets — NPPES, OIG LEIE, CMS PECOS, CMS Care Compare, CMS Open Payments, HRSA, and more (23 source families) — into one provider graph keyed on the National Provider Identifier (NPI). This MCP server lets an LLM or agent resolve a provider, read dataset methodology, search the graph, and list the underlying sources, with every returned field tied back to its upstream source, snapshot date, and license through a fourteen-field provenance contract. No trust badges, no opaque scores — radical source transparency.
- Hosted MCP endpoint:
https://mcp.fonteum.com/api/mcp(also served from the apex athttps://fonteum.com/api/mcp— same deployment) - Discovery document:
https://fonteum.com/.well-known/mcp.json - Transport: Streamable HTTP (JSON-RPC 2.0, stateless)
- Auth: none required. Anonymous access is rate-limited per IP (30 requests /
minute). An optional
x-fonteum-mcp-keyheader lifts the limit. - Scope: healthcare-only. Read-only — no mutation tools.
- REST + FHIR + OpenAPI: the same graph is exposed as a FHIR R4 API
(
/api/fhir), a JSON REST API (/api/v1), and an OpenAPI 3.1 spec athttps://fonteum.com/openapi.json.
Quickstart
Claude Code
claude mcp add --transport http fonteum https://mcp.fonteum.com/api/mcp
Claude Desktop / Cursor / Windsurf (remote MCP)
Add the streamable-HTTP server to your client's MCP config:
{
"mcpServers": {
"fonteum": {
"type": "http",
"url": "https://mcp.fonteum.com/api/mcp"
}
}
}
Restart the client, then ask: List the federal healthcare data sources Fonteum reconciles, then look up NPI 1003000118.
Local stdio alternative
A self-contained local server that wraps the same public graph over stdio ships
as the @fonteum/mcp npm package:
claude mcp add fonteum -- npx -y @fonteum/mcp
The hosted server (this repo) and the npm package read the same federal graph and return the same provenance contract; the hosted server is the zero-install path, the npm package is the offline/self-hosted path.
Tools
Every tool result is a JSON envelope { "data": …, "provenance": { …14 keys… } }.
All four tools are read-only.
list_sources
List the 23 federal source families Fonteum reconciles every healthcare-provider field against (NPPES, OIG LEIE, CMS PECOS, CMS Care Compare, CMS Open Payments, HRSA HPSA, and more), each with its authority, tier, refresh cadence, and the official source URL.
- Input: none.
// list_sources →
{
"data": { "sources": [ { "slug": "nppes", "authority": "CMS", "refresh_cadence": "weekly", "official_url": "https://npiregistry.cms.hhs.gov/" }, … ], "total": 23 },
"provenance": { "_source": "Fonteum source registry", "_methodology": "v2026.05.0", … }
}
get_provider
Look up a single healthcare provider by NPI (10-digit, Luhn-checked). Returns the provider's specialty, taxonomy, and location with per-field provenance.
- Input:
{ "npi": "1003000118" }
// get_provider { "npi": "1003000118" } →
{
"data": { "npi": "1003000118", "specialty_display": "Dermatologists", "state": "CA", "city": "…", "snapshot_date": "2026-06-12" },
"provenance": { "_source": "CMS NPPES NPI Registry", "_source_url": "https://npiregistry.cms.hhs.gov/", "_confidence": 1.0, … }
}
search_providers
Search healthcare providers by vertical + state (with an optional county filter). Returns up to 100 records (default 25).
- Input:
{ "vertical": "dermatologists", "state": "TX", "limit": 5 }
// search_providers { "vertical": "dermatologists", "state": "TX", "limit": 5 } →
{
"data": { "vertical": "dermatologists", "state": "TX", "total_in_state": 42, "returned": 5, "hits": [ { "npi": "…", "city": "…", "taxonomy_primary": "…" }, … ] },
"provenance": { "_source": "CMS NPPES NPI Registry", … }
}
get_methodology
Return the Fonteum methodology version, the canonical /methodology URL, and the
fourteen-field provenance contract specification.
- Input: none.
// get_methodology →
{
"data": { "methodology_version": "v2026.05.0", "methodology_url": "https://fonteum.com/methodology", "provenance_contract": { "fields": [ { "position": 1, "name": "_source", "required": true }, … ] } },
"provenance": { … }
}
The fourteen-field provenance contract
Every tool response carries all fourteen keys, so any fact an agent reads can be traced to its source, snapshot, methodology, license, coverage window, and signed build attestation:
_source _source_url _dataset_id _snapshot
_methodology _last_checked _confidence _data_availability
_pipeline_version _doi _license _coverage_period_start
_coverage_period_end _slsa_provenance_url
Field naming matches the Fonteum REST audit-pack endpoint, so tooling that already consumes the REST API reads MCP responses without translation. The contract is additive-only — keys are never stripped.
Healthcare scope
This server is healthcare-only by doctrine. The verticals it resolves are:
chiropractors, dermatologists, plastic-surgeons, med-spas, weight-loss clinics,
rehab centers, hair-transplant clinics, fertility clinics, TRT clinics, and
ketamine clinics. Federal source data is US-Government-Works (public domain);
Fonteum composite terms apply to joined records (see the _license field on each
response).
License
MIT. See LICENSE.
Author & contact
Authored by Dr. Jennifer Montecillo, MD, medical reviewer, Fonteum.
Contact: mcp@fonteum.com · fonteum.com
Server Config
{
"mcpServers": {
"fonteum": {
"command": "npx",
"args": [
"-y",
"@fonteum/mcp"
]
}
}
}