Realdentalcosts MCP Server

realdentalcosts-mcp

A price-transparency data source for your AI assistant. Most dental-cost numbers floating around the web are guesses, ad copy, or averages nobody can trace back to a source. This server hands your assistant a structured, citable dataset instead: 12 common dental procedures with national figures and, for 8 of them, figures for all 51 US states (including DC), plus a line-by-line treatment-plan checker built only on sourced, dated figures.

Data comes from the Real Dental Costs US Dental Cost Index 2026: every figure carries its source, its period and whether it is observed or estimated (details and licensing below).

Correction notice (October 25, 2026). On realdentalcosts.com, the state implant series was requalified as an editorial estimate (edition 2026.1, not collected prices; state ranking validated against ASQ360, Spearman 0.945, levels not verified), and the city implant prices and clinic counts were withdrawn: they were written in an AI-assisted session and never collected. Record: https://realdentalcosts.com/en/data-corrections/. This server applies the correction: the implant series is labelled estimated, the city tool is removed and no city figure or clinic count is served.

Quick Start

No installation needed — run directly with npx.

The npm package is still version 0.2.0 (4 tools). The remote server (https://mcp.realdentalcosts.com/mcp) and the Docker image below carry all 13 tools.

Claude Desktop / Claude Code

Add to your MCP config (claude_desktop_config.json or .mcp.json):

{
  "mcpServers": {
    "realdentalcosts": {
      "command": "npx",
      "args": ["-y", "realdentalcosts-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "realdentalcosts": {
      "command": "npx",
      "args": ["-y", "realdentalcosts-mcp"]
    }
  }
}

Restart your client after saving. The server runs entirely offline over stdio — no API key, no network calls, no telemetry.

Run with Docker

The image tresor4k/realdentalcosts-mcp (linux/amd64, linux/arm64, non-root user) runs the same stdio server with the data bundled:

{
  "mcpServers": {
    "realdentalcosts": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "tresor4k/realdentalcosts-mcp:latest"]
    }
  }
}

Tools

dental_cost_by_state

Low/average/high cash price for a procedure in one US state, benchmarked against the national average and the state's dental cost index. For crown, veneer, braces and dentures it returns no_source_at_this_level, the study link and the national band (see Data & methodology).

procedure: "implant"   state: "CA"
→ California: $4,780 – $5,733 – $7,290 (editorial estimate, edition 2026.1, not collected prices; modelled band)
  National average: $3,760 – $4,507 – $5,733
  +27.2% vs. national average · Restorative Cost Index 127

Treatment-plan tools

Every figure carries its source_url and period (or effective_date); a missing cell returns status: "no_source_at_this_level" with the next level up, never a number. Medicaid amounts are paid per claim line (T-MSIS), not a consumer price.

• benchmark_treatment_plan — state, lines[{code|procedure, qty?, quoted_usd?}] (1-10), coverage? (category only). Per line: state cash band (observed / estimated badges), Medicaid paid p25/median/p75, official fee schedule with its schedule_scope, position of the quote; plus the state's adult Medicaid rule. Codes outside the 61 published CDT codes return not_covered.
• medicaid_adult_dental_rules — level, program summary, annual cap, ortho and implant policy with quotes, share of dentists billing Medicaid, fee schedule.
• medicaid_paid_by_code — code, state?: national figures and 2018-2024 series, state cell, rank and official fee.
• low_cost_dental_options — state, county?: dental schools, health centers and shortage-area designations, Mission of Mercy, charity programs, county atlas row.

The modelled out_of_pocket_estimate tool was removed. Data is synced from the published API v1 with npm run sync-data (manifest with sha256 in src/data/rdc/manifest.json). Privacy: GET /privacy on the HTTP entry point.

dental_national_average

National average across all 51 states + DC, plus the cheapest and priciest state on average.

procedure: "braces"
→ National average: $2,503 – $6,352 – $10,014
  Cheapest: Indiana ($4,767 avg)
  Priciest: Nevada ($8,350 avg)

All four tools accept lang: "en" | "es" (default "en") — procedure labels, disclaimers, and Medicaid coverage notes switch to Spanish, serving the US Hispanic market covered by the source site's /es/ pages.

Every response includes source, reference_url and api_url fields plus a per-procedure basis (observed / estimated / national) with a provenance note, so the numbers stay traceable back to the published data they come from.

Open JSON API (no MCP required)

The same data this MCP server exposes is also available as a free, open JSON API — static versioned endpoints, no key, CORS enabled, documented with an OpenAPI 3.1 spec:

• Docs: https://realdentalcosts.com/en/api/
• Metadata & DOIs: https://realdentalcosts.com/api/v1/index/meta.json
• All 51 state markets: https://realdentalcosts.com/api/v1/states.json
• One state: https://realdentalcosts.com/api/v1/state/tx.json
• The 12 procedures: https://realdentalcosts.com/api/v1/procedures.json
• One procedure across states: https://realdentalcosts.com/api/v1/procedure/dental-implant.json
• OpenAPI 3.1 spec: https://realdentalcosts.com/api/v1/openapi.json

Licensing depends on the figure. Real Dental Costs' own datasets are published on Zenodo under the license stated on each record (for example the implant series, DOI 10.5281/zenodo.20531728); attribution required: link to https://realdentalcosts.com or cite the DOI. State averages for crown, veneer, braces and dentures come from the ASQ360/CareCredit Average Procedural Cost Study 2023-2024: they remain the property of their publisher, are not covered by Real Dental Costs' license, and must be cited to that study. They are cited on realdentalcosts.com pages but not licensed for redistribution, so this server does not publish them, as in the site's API v1.

Data & methodology

Data is derived from the US Dental Cost Index 2026, an open dataset published by Real Dental Costs:

• Dataset concept DOI: 10.5281/zenodo.20531728
• Full index: https://realdentalcosts.com/en/us-dental-cost-index/
• Interactive state comparison: https://realdentalcosts.com/en/compare/
• Methodology: https://realdentalcosts.com/en/methodology/

Every procedure carries a basis field. observed state averages are measured prices (crown/veneer/braces/dentures = ASQ360/CareCredit Average Procedural Cost Study 2023-2024, per-state figures not published here), with the low/high band around them modelled from national ratios. The implant series is estimated: an editorial estimate, edition 2026.1, not collected prices (state ranking validated against ASQ360, levels not verified). Other estimated procedures have no collected per-state price: the national figure is scaled by the state's Restorative Cost Index, which is built on that implant series and is valid only for restorative work (implant/crown/denture — it does not predict orthodontic or cosmetic prices). national (cosmetic) procedures carry no invented state variation. National averages are the arithmetic mean of all 51 states (incl. DC) — never a separately invented number.

Disclaimer

This package provides market research pricing data — not medical advice, not a quote, and not a guarantee of what any specific dentist will charge. Actual prices vary by clinic, provider, insurance plan, and case complexity. Always confirm pricing directly with a licensed dental provider before treatment.

License

MIT © tresor4k