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 search the graph, resolve a provider, check exclusion status, read dataset methodology, 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 at https://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-key header 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 at https://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 expose the same five tools, read the same federal graph, and return the same provenance contract — enforced by a CI parity gate so the two surfaces cannot drift. 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 five tools are read-only.

fonteum_search_provider

Search healthcare providers by vertical + state (with an optional county filter), name, or specialty/taxonomy. Returns up to 100 records (default 25).

• Input: { "vertical": "dermatologists", "state": "TX", "limit": 5 }

// fonteum_search_provider { "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", … }
}

fonteum_get_provider

Resolve a single healthcare provider by NPI (10-digit, Luhn-checked) across all federal sources. Returns the joined record — specialty, taxonomy, location — with per-field provenance.

• Input: { "npi": "1003000118" }

// fonteum_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, … }
}

fonteum_check_exclusion

Unified "excluded anywhere" check by NPI across the federal OIG List of Excluded Individuals/Entities (LEIE) and stat

... View full README on GitHub