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 two tools:

• list_hospitals — returns the supported hospitals with their hospital_id, EIN, name, locations, and last_updated_on.
• get_hospital_chargemaster_cost — looks up cost stats for a billing code at a single hospital.

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. 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": "1",
  "code_type": "MS-DRG",
  "code": "652",
  "methodology": "fee schedule"
}

and returns:

{
  "hospital": "MEDICAL CITY ALLIANCE",
  "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 20, capped at 100.
• page_token (optional) — opaque token from a previous response for pagination.

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.
• methodology (optional) — one of case rate, fee schedule, other, percent of total billed charges, per diem. Omit to aggregate across all methodologies.

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