Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

MedPrice AI

✓ Brand-named GitHub · github.com/medprice-ai

by medprice-aiversion 0.0.1i★ 0iRuns in the cloudOfficial site ↗
Registry nameio.github.medprice-ai/mcp-medprice-ai

How to install

What it does

Hosted MCP server exposing US hospital procedure cost data to AI assistants

  • Connects Runs in the cloud
  • Account or key No key needed
  • Category Clinics & health

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score20/100

Quality: Passed 4/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install MedPrice AI. Follow https://mcp.popnx.com/i/medprice-ai-mcp-medprice-ai.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 4/5 checks · What you ask goes through the maker’s server (mcp.medprice.ai) · ✓ Commands checked Nov 20, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameMedPrice AI
    Remote MCP server URL · Addresshttps://mcp.medprice.ai/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsMedPrice AI

  4. Try it

    Use MedPrice AI and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using MedPrice AI or shows a MedPrice AI tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameMedPrice AI
    Connection · Addresshttps://mcp.medprice.ai/mcp
  3. Pick MedPrice AI in a chat

    Start a new chat and pick MedPrice AI from your plugins before typing

  4. Try it

    Use MedPrice AI and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using MedPrice AI or shows a MedPrice AI tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user medprice-ai https://mcp.medprice.ai/mcp
  3. Type /mcp in Claude Code

    You should see MedPrice AI listed as connected

  4. Try it

    Use MedPrice AI and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using MedPrice AI or shows a MedPrice AI tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use MedPrice AI and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using MedPrice AI or shows a MedPrice AI tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use MedPrice AI and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using MedPrice AI or shows a MedPrice AI tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://mcp.medprice.ai/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use MedPrice AI💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user medprice-ai https://mcp.medprice.ai/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "medprice-ai": {
      "url": "https://mcp.medprice.ai/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "medprice-ai": {
      "type": "http",
      "url": "https://mcp.medprice.ai/mcp"
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Licencei
No licence stated
Connection
Runs in the cloud
Transport
streamable-http
Latest versioni
0.0.1
Published to registryi
Jun 20, 2026
Code last changedi
Nov 14, 2026
Last checked
Nov 16, 2026
Maker
medprice-ai
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 16, 2026. The maker wrote them, not us; we show them as plain text.

  • get_hospital_chargemaster_cost

    Looks up one hospital's cost stats (min/max/avg/median/std_dev and sample counts) for a code_type/code: a single all-terms figure, or one entry per requested methodology. Served from the hospital-prices serving snapshot, which pools exactly (exact medians), so figures can differ

  • batch_get_hospital_chargemaster_cost

    Looks up cost stats for several (code_type, code) pairs at one hospital (identified by hospital_id) in a single call - the batch counterpart to get_hospital_chargemaster_cost. Use this instead of calling get_hospital_chargemaster_cost once per code when pricing a fixed set of cod

  • list_hospitals

    Returns the hospitals supported by the medprice.ai API, with their hospital_id (opaque handle), EIN, name, structured_locations (addresses with geocoded coordinates where available), last_updated_on, and revision history (with per-revision has_payer_data, revision_id, and added_a

  • list_hospital_code_costs

    Returns cost stats for every hospital with a matching chargemaster entry for a code_type/code. Use this instead of calling get_hospital_chargemaster_cost once per hospital when comparing prices for the same procedure across hospitals (e.g. "which hospital has the cheapest MS-DRG

  • get_code_price_distribution

    Returns the distribution of every hospital's price for a code_type/code, computed server-side: min/p10/q1/median/q3/p90/max, standard deviation, a histogram, and the real hospital nearest each percentile. Use this instead of paging through list_hospital_code_costs when you want t

  • get_hospital_provider_code_costs

    Returns one hospital's own charges for a (code_type, code), one entry per row of the group_by grouping (default: per billing class, methodology and setting; never blended unless GROUP_BY_ALL), plus an all_terms figure over all of them regardless of grouping. Unlike get_hospital_c

  • batch_get_hospital_provider_code_costs

    Batch counterpart to get_hospital_provider_code_costs: one hospital's provider charges for 1 to 100 codes in a single call, results in request order. A code the hospital doesn't charge is an entry with no costs, not an error. Backed by the hospital-prices serving snapshot; fails

  • list_hospital_provider_codes

    Lists the codes one hospital reports on its latest (or a given) revision, as list_codes does, each with that hospital's own all-terms sample counts. Paginated; supports query, sort and code_type like list_codes. Backed by the hospital-prices serving snapshot; fails with UNAVAILAB

  • list_code_provider_hospitals

    Each hospital's charges for a (code_type, code), one row per hospital and group of the group_by grouping (default: per billing class, methodology and setting; GROUP_BY_ALL gives one row per hospital), paginated. The billing-class-aware counterpart to list_hospital_code_costs, goo

  • get_code_provider_price_distribution

    Distribution (min/p10/q1/median/q3/p90/max, std dev, histogram, nearest hospital per percentile) of one figure per hospital for a code, never blending billing classes. The filter must name every term the group_by grouping keeps (all three of billing_class, methodology and setting

  • get_code_provider_terms_summary

    Which billing classes, methodologies and settings hospitals file a (code_type, code) under, and how many hospitals each group has, so a caller can offer the choices before calling list_code_provider_hospitals or get_code_provider_price_distribution. group_by sets what each entry

  • list_code_payers

    Every insurer (payer) with a negotiated rate for a (code_type, code), one summary per payer and billing class/methodology/setting, across hospitals, most hospitals first: hospital_count, n, min/avg/median-of-hospital-averages/max rate and the price terms. Billing classes, methodo

  • get_hospital_code_payer_rates

    Every plan rate (per payer and plan, with price terms) one hospital files for a (code_type, code), cheapest average first. Pass revision_id (from list_hospitals) to answer for a past filing. NOT_FOUND when the hospital has no payer rates at all; an empty rates list when it has so

  • list_code_payer_hospitals

    One payer's rate for a (code_type, code) at each hospital, one row per hospital and billing class/methodology/setting, paginated, rolled up across the payer's plans there. Good for 'which hospital is cheapest for Aetna members'. Defaults/caps page_size at 500; includes total_coun

  • get_code_payer_price_distribution

    Distribution (min/p10/q1/median/q3/p90/max, std dev, histogram, nearest hospital per percentile) of one payer's rate for a (code_type, code) across hospitals, one figure per hospital; the payer-specific counterpart to get_code_provider_price_distribution. The filter must name eve

  • get_code_payers_price_distribution

    Distribution of a code's price across payers, one figure per payer (how the payers compare), the third view beside get_code_provider_price_distribution (over hospitals) and get_code_payer_price_distribution (over one payer's hospitals). The filter must name every term the group_b

  • list_payers

    Every insurer (payer) in the snapshot, independent of any code, most hospitals first, with display_name, hospital_count, code_count and payer_rate_rows. About 70, so unpaginated. Use the payer_slug with get_payer, list_payer_plans, list_payer_hospitals and the code-level payer to

  • get_payer

    One payer's header: display name and counts, plus its top codes (grouped like the provider RPCs; the filter may name only terms the grouping keeps) and the states it appears in. state narrows only the payer's counts: top_codes stay network-wide. NOT_FOUND when no hospital in the

  • list_payer_plans

    The plans a payer is filed under, most hospitals first, paginated: plan_slug, plan name, hospital_count, code_count, payer_rate_rows and filed_rate_count. Use plan_slug with get_code_payer_price_distribution. Includes total_count. Backed by the hospital-prices serving snapshot; f

  • list_hospital_plans

    The payers and plans one hospital files negotiated rates under, across all its codes, most codes first, paginated, with code_count, payer_rate_rows and filed_rate_count. Includes total_count. Backed by the hospital-prices serving snapshot; fails with UNAVAILABLE until the server

  • list_hospital_payers

    A hospital's payers rolled up from its plans, most plans first: display_name, plan_count, payer_rate_rows and filed_rate_count. Unpaginated. Backed by the hospital-prices serving snapshot; fails with UNAVAILABLE until the server has opened one.

  • list_payer_hospitals

    The hospitals that file a payer across all codes, optionally in one state, paginated: plan_count, payer_rate_rows and filed_rate_count per hospital. Includes total_count. For one payer's rates for a specific code use list_code_payer_hospitals. Backed by the hospital-prices servin

  • list_code_types

    Returns every distinct code_type (e.g. CPT, MS-DRG) with catalogued cost data, along with each type's distinct code count and total hospital reports. Unpaginated. Use this to discover which code systems have data before drilling into list_codes.

  • list_codes

    Returns every distinct code catalogued under a given code_type, paginated, with each code's raw chargemaster description and the number of hospitals reporting it. Use this to discover which codes exist under a code system (e.g. all CPT codes) before looking up prices with get_hos

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account medprice-ai, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 6 days ago

  • ✕ Fail

    Has a licence

    No licence file found in the repo

  • ✓ Pass

    Endpoint responds

    Responded in 197 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 24 tool descriptions and found no hidden instructions to the AI

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/medprice-ai-mcp-medprice-ai.svg)](https://mcp.popnx.com/en/servers/medprice-ai-mcp-medprice-ai)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Clinics & healthi

  • More stars than 0% of the other 1198 servers in this category
  • Published to the registry more recently than 13% of the other 1198 servers in this category
  • Basic checks equal to or better than 56% of the other 1198 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is MedPrice AI safe?

It passed 4 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed 6 days ago, and the latest version (0.0.1) reached the registry 5 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: Medplum MCP, Mirobody, Codescene MCP Server, Marrow, WHOOP — MissingMCP

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Medplum MCP

Securely access and manage FHIR healthcare data stored in Medplum.

by medplumWidely used★ 2.8KUpdated 4 months ago

Runs in the cloud✓ service owner · medplum.com

Mirobody

Lab results to LOINC codes and UCUM units, symptoms and diagnoses to ICPC-3. Offline, no API key.

by thetahealthGrowing↓ 725/wk★ 1.6KUpdated yesterday

Runs on your computer✓ thetahealth.ai

Codescene MCP Server

An MCP server that provides CodeScene Code Health analysis tools.

by codescene-ossGrowing↓ 3.8K/wk★ 85Updated 8 months ago

Runs on your computer✓ service owner · codescene.com

Marrow

Marrow Health: your Apple Health data over MCP, from the free iOS app. Reads, and writes on demand.

by skeletonarmytechEarly↓ 62/wk★ 5Updated 29 days ago

Runs on your computer✓ skeletonarmy.tech
Compared with similar ones
This one
MedPrice AI
Medplum MCPMirobodyCodescene MCP ServerMarrowWHOOP — MissingMCP
Runs whereRuns in the cloud, nothing to installRuns in the cloud, nothing to installInstalls on your computerInstalls on your computerInstalls on your computerRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks4/54/43/32/33/32/4
License–Apache-2.0Apache-2.0NOASSERTIONMITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

mcp-medprice-ai

A hosted MCP server exposing US hospital chargemaster cost data to AI assistants.

  • MCP endpoint: https://mcp.medprice.ai/mcp
  • gRPC backend: api.medprice.ai:443

Install in Claude Code

claude mcp add --transport http mcp-medprice-ai https://mcp.medprice.ai/mcp

To share with everyone in a project, add --scope project (writes to .mcp.json). To make it available across all your projects, use --scope user.

Usage

The server exposes five tools:

  • `list_hospitals` — returns the supported hospitals with their hospital_id, EIN, name, structured_locations (addresses with geocoded coordinates where available), last_updated_on, and revision history (each revision's date, revision_id, and whether it has payer-specific rate data).
  • `get_hospital_chargemaster_cost` — looks up cost stats for a billing code at a single hospital.
  • `list_hospital_code_costs` — looks up cost stats for a billing code across every hospital that has a matching chargemaster entry, paginated. Use this instead of calling get_hospital_chargemaster_cost once per hospital when comparing prices for the same procedure across hospitals.
  • `get_code_price_distribution` — returns the distribution of every hospital's price for a billing code (percentiles, histogram, and the real hospital at each percentile), computed server-side. Use instead of paging through list_hospital_code_costs for "is this price high?" questions.
  • `list_code_types` — lists every distinct billing code type (e.g. CPT, MS-DRG) with catalogued cost data, along with each type's distinct code count and total hospital reports.
  • `list_codes` — lists every distinct code under a given code type, paginated, with a raw chargemaster description and reporting-hospital count per code. Use this to discover which codes exist under a code system before pricing them.

The typical flow is to call list_hospitals first to discover available hospitals and their IDs, then call get_hospital_chargemaster_cost with the desired hospital_id — or call list_hospital_code_costs directly when the question is about a code across hospitals rather than one specific hospital. Once installed, you can just ask your assistant something like:

What's the fee schedule cost of MS-DRG 652 at Medical City Alliance?

The assistant will call list_hospitals to find the hospital's ID, then call get_hospital_chargemaster_cost with:

{

"hospital_id": "3f9a1c2b8e4d5f6a7b8c9d0e1f2a3b4c", "code_type": "MS-DRG", "code": "652", "methodologies": ["fee schedule"] }

and returns:

{

"hospital": "MEDICAL CITY ALLIANCE", "found": true, "hospital_id": "3f9a1c2b8e4d5f6a7b8c9d0e1f2a3b4c", "results": [ { "methodology": "fee schedule", "found": true, "cost": { "code_type": "MS-DRG", "code": "652", "min": "26851.11", "max": "190885.00", "avg": "34387.70", "median": "28084.07", "std_dev": "13735.94" }, "description": { "hospital_name": "MEDICAL CITY ALLIANCE", "location": "3101 N Tarrant Pkwy, Fort Worth, TX, 76177", "code_description": "KIDNEY TRANSPLANT", "methodology_note": "fee schedule" } } ] }

Tool reference
list_hospitals
  • `page_size` (optional) — maximum number of hospitals to return. Defaults to 500 (the entire current registry in one call), capped at 500.
  • `page_token` (optional) — opaque token from a previous response's next_page_token, for pagination. If next_page_token is non-empty, keep calling with it until it's empty rather than assuming one page is the full list.

Each hospital's revisions array now includes a revision_id per revision (in addition to revision_date and has_payer_data) — pass it as get_hospital_chargemaster_cost's revision_id to price that specific past revision instead of the hospital's latest one.

Data source. get_hospital_chargemaster_cost, batch_get_hospital_chargemaster_cost, list_hospital_code_costs and get_code_price_distribution are served from the hospital-prices serving snapshot (ProviderCodeCostService), with their input and output schemas unchanged. The snapshot pools exactly (exact medians), so figures can differ slightly from earlier results. Each figure is still one all-terms (or one per-methodology) number that combines facility and professional charges; use the *provider* tools (get_hospital_provider_code_costs etc.) for a per-billing-class breakdown. Differences: methodology_note is always empty; MIN/MAX are the charges' own extremes (no longer widened by the filing's per-item minimum/maximum); page_tokens issued before the change are invalid.

get_hospital_chargemaster_cost
  • `hospital_id` (required) — opaque hospital identifier from list_hospitals.
  • `code_type` (required) — code system, e.g. APR-DRG, CDM, CPT, HCPCS, MS-DRG, RC. Hospitals may also support additional proprietary code types.
  • `code` (required) — the billing/chargemaster code.
  • `methodologies` (optional) — array of case rate, fee schedule, other, percent of total billed charges, per diem. One result per entry, in request order, each with its own found/cost/description. Omit or pass an empty array to get a single aggregate result across all methodologies.
  • `revision_id` (optional) — a revision_id from list_hospitals, to price that specific past revision instead of the hospital's latest one.

Returns hospital, found (true if at least one entry in results was found), hospital_id, and results — one entry per requested methodology (or one aggregate entry when methodologies is omitted), each shaped like { methodology, found, cost, description }.

list_hospital_code_costs

Like get_hospital_chargemaster_cost, but returns one result per hospital that has a matching chargemaster entry for the code, instead of requiring a hospital_id up front — useful for "which hospital is cheapest for X" questions without a list_hospitals + N × get_hospital_chargemaster_cost round trip.

  • `code_type` (required) — same as above.
  • `code` (required) — same as above.
  • `methodology` (optional) — single methodology string, same options as above. Unlike get_hospital_chargemaster_cost, this filter stays singular — it still only aggregates or narrows to one methodology, it doesn't fan out to multiple results entries per hospital.
  • `page_size` (optional) — maximum number of results to return. Defaults to 500 (every matching hospital in one call at the current registry size), capped at 500.
  • `page_token` (optional) — opaque token from a previous response's next_page_token, for pagination. If next_page_token is non-empty, keep calling with it until it's empty rather than assuming one page is the full list.

Returns results (each hospital shaped like a get_hospital_chargemaster_cost response — hospital, found, hospital_id, and a results array with exactly one entry given the singular methodology filter) and next_page_token. Only hospitals with a matching entry (their latest revision) are included — there are no found: false entries.

get_code_price_distribution

Distribution of one per-hospital price figure across every hospital reporting the code, computed server-side in one call.

  • `code_type` (required), `code` (required) — same as above.
  • `methodology` (optional) — same options as list_hospital_code_costs; omit to aggregate across all.
  • `min_sample_count` (optional) — same semantics as list_hospital_code_costs.
  • `bin_count` (optional) — histogram bars; defaults to 16, max 200.
  • `reference_price` (optional) — when positive, hospitals_below_reference counts hospitals priced strictly below it.
  • `statistic` (optional) — PRICE_STATISTIC_AVERAGE (default), PRICE_STATISTIC_MEDIAN, PRICE_STATISTIC_MIN or PRICE_STATISTIC_MAX: the per-hospital figure being distributed.

Returns hospital_count, min/p10/q1/median/q3/p90/max, std_dev, histogram (histogram_lo, histogram_hi, histogram_bins, overflow_count), a *_hospital point (hospital_id, hospital_name, location, price) for each percentile, and hospitals_below_reference. hospital_count 0 means no hospital reports a price.

list_code_types

No arguments. Returns code_types, one entry per distinct code type present in the catalog (most code-rich first), each with code_type, code_count (distinct codes catalogued under that type), and total_hospital_reports (sum of hospital_count across every code under that type — not a distinct-hospital count). Unpaginated.

Use this to discover which code systems have data before drilling into list_codes.

list_codes
  • `code_type` (required) — code system to list codes for, e.g. CPT. From list_code_types.
  • `page_size` (optional) — maximum number of results to return. Defaults to 500, capped at 500.
  • `page_token` (optional) — opaque token from a previous response's next_page_token, for pagination. If next_page_token is non-empty, keep calling with it until it's empty rather than assuming one page is the full list.

Returns codes (each with code, raw_description — raw chargemaster text, not necessarily a human-readable procedure name — and hospital_count, distinct hospitals reporting that code on their latest revision), next_page_token, and total_count (total matching codes across all pages). Use this to discover which codes exist under a code system before pricing them with get_hospital_chargemaster_cost or list_hospital_code_costs.

Development

Run locally against the production gRPC backend
GRPC_HOST=api.medprice.ai:443 npx tsx src/index.ts
Run locally against a custom gRPC backend
GRPC_HOST=<host:port> npx tsx src/index.ts
Run as HTTP server
TRANSPORT=http GRPC_HOST=api.medprice.ai:443 npx tsx src/index.ts

All MCP requests go to POST /mcp. PORT defaults to 3000.

Test gRPC connectivity
GRPC_HOST=api.medprice.ai:443 npx tsx src/test.ts

Docker

Build
docker build -t mcp-medprice-ai .
Run
docker run --rm -p 3000:3000 \

-e GRPC_HOST=api.medprice.ai:443 \ mcp-medprice-ai

TRANSPORT=http and PORT=3000 are set by default in the image. Override PORT if needed:

docker run --rm -p 8080:8080 \

-e GRPC_HOST=api.medprice.ai:443 \ -e PORT=8080 \ mcp-medprice-ai