Med Bill Check

Official5 tools

by GoodTurnStudio · JavaScript

Is your US medical bill fair? Compares charges with Medicare rates and drafts a dispute letter.

io.github.GoodTurnStudio/medbillcheck — MCP Server

The io.github.GoodTurnStudio/medbillcheck MCP server helps assess whether a US medical bill is fair. It compares medical charges against Medicare rates and drafts a dispute letter based on the comparison.

🛠️ Key Features

Compares US medical bill charges with Medicare rates
Drafts a dispute letter

🚀 Use Cases

Reviewing charges on medical bills
Preparing a dispute letter for potential billing issues

⚡ Developer Benefits

Provides bill-vs-Medicare rate comparison outputs
Generates dispute letter drafts for review and use

Captured live from the server via tools/list.

check_price

Compare a charge with Medicare's rate for one service. For when someone asks whether a charge is high or what Medicare pays, for example "I was charged $450 for a 99213 office visit in Texas, is that too high?" or "what does Medicare pay for an MRI of the knee?". Takes the billing code if they have it, otherwise the service in plain words as q. Returns Medicare's 2026 rate for the state (or the city's own pricing area when city is given) in medicare_2026, the amount providers typically billed in 2024, and how many times the Medicare rate the charge is. For care in a hospital, hospital_facility_2026 gives Medicare's national rate for the hospital's own facility fee and comparison.compared_with says what the charge was set against. Dental work has no Medicare rate and returns 404 with a pointer to a free dental cost source.

Parameters7

code	string	optional	Five-character CPT or HCPCS code from the bill, like 99213, 73721 or G0121.
q	string	optional	The service in plain words, used when there is no code, like "knee MRI" or "ER visit".
state	string	optional	US state name or two-letter code, like Texas or TX. Med Bill Check is for US bills; a UK place gets a short answer pointing to UK sources.
charged	number	optional	The amount on the bill in US dollars, like 450.
setting	string	optional	Setting: office (clinic, office, imaging center) or facility (hospital or surgery center). Leave out to use the usual setting.
city	string	optional	City, for states where Medicare pays big cities differently, like Houston, Chicago, Miami or Los Angeles. Other places use the rest-of-state rate.
billed_by	string	optional	Whose bill the charge is on when the service was in a hospital: hospital (the hospital's own facility charge) or doctor (the doctor's or physician group's bill). Leave out if not known: the charge is then compared with both together.

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Five-character CPT or HCPCS code from the bill, like 99213, 73721 or G0121."
    },
    "q": {
      "type": "string",
      "description": "The service in plain words, used when there is no code, like \"knee MRI\" or \"ER visit\"."
    },
    "state": {
      "type": "string",
      "description": "US state name or two-letter code, like Texas or TX. Med Bill Check is for US bills; a UK place gets a short answer pointing to UK sources."
    },
    "charged": {
      "type": "number",
      "minimum": 1,
      "maximum": 5000000,
      "description": "The amount on the bill in US dollars, like 450."
    },
    "setting": {
      "type": "string",
      "enum": [
        "office",
        "facility"
      ],
      "description": "Setting: office (clinic, office, imaging center) or facility (hospital or surgery center). Leave out to use the usual setting."
    },
    "city": {
      "type": "string",
      "description": "City, for states where Medicare pays big cities differently, like Houston, Chicago, Miami or Los Angeles. Other places use the rest-of-state rate."
    },
    "billed_by": {
      "type": "string",
      "enum": [
        "hospital",
        "doctor"
      ],
      "description": "Whose bill the charge is on when the service was in a hospital: hospital (the hospital's own facility charge) or doctor (the doctor's or physician group's bill). Leave out if not known: the charge is then compared with both together."
    }
  },
  "required": [],
  "additionalProperties": false
}

search_services

Find billing codes and Medicare rates by plain words. For when someone describes a service but has no code, or asks what a code means, for example "what's the code for a colonoscopy?", "how much does Medicare pay for a chest x-ray in Ohio?" or "what is code 99214?". Returns up to eight matching codes with Medicare's typical allowed and billed amounts.

Parameters2

q	string	required	Plain words or a code, like "hernia repair" or 99214.
state	string	optional	US state name or two-letter code.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Plain words or a code, like \"hernia repair\" or 99214."
    },
    "state": {
      "type": "string",
      "description": "US state name or two-letter code."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

check_whole_bill

Check several lines of an itemized bill at once. For when someone reads out or pastes several lines from an itemized bill, for example "my ER bill has 99284 for $2,500, 85025 twice for $120 and 36415 three times, does anything look off?". Takes the lines as code, optional x and units, then the amount. Returns each line against Medicare's rate, totals, and questions_to_ask: repeated codes, units above Medicare's automated daily limit, the highest visit levels, hospital clinic facility fees and charges far above what providers typically bill. Lines of a hospital bill (any bill with an ER visit on it, or setting=facility) are compared with Medicare's hospital outpatient rate plus the doctor's part; each such line says compared_with.

Parameters5

lines	string	required	Up to 15 bill lines separated by commas: code, then x and units if more than one, then the amount. Example: 99284:2500, 85025x2:120, 36415:45.
state	string	optional	US state name or two-letter code.
city	string	optional	City, for big cities with their own Medicare rates.
setting	string	optional	Setting: office or facility. Leave out if not known.
billed_by	string	optional	Whose bill the charge is on when the service was in a hospital: hospital (the hospital's own facility charge) or doctor (the doctor's or physician group's bill). Leave out if not known: the charge is then compared with both together.

Raw schema

{
  "type": "object",
  "properties": {
    "lines": {
      "type": "string",
      "description": "Up to 15 bill lines separated by commas: code, then x and units if more than one, then the amount. Example: 99284:2500, 85025x2:120, 36415:45."
    },
    "state": {
      "type": "string",
      "description": "US state name or two-letter code."
    },
    "city": {
      "type": "string",
      "description": "City, for big cities with their own Medicare rates."
    },
    "setting": {
      "type": "string",
      "enum": [
        "office",
        "facility"
      ],
      "description": "Setting: office or facility. Leave out if not known."
    },
    "billed_by": {
      "type": "string",
      "enum": [
        "hospital",
        "doctor"
      ],
      "description": "Whose bill the charge is on when the service was in a hospital: hospital (the hospital's own facility charge) or doctor (the doctor's or physician group's bill). Leave out if not known: the charge is then compared with both together."
    }
  },
  "required": [
    "lines"
  ],
  "additionalProperties": false
}

look_up_hospital

Whether a hospital is nonprofit, for financial assistance. For requests like "is St. Luke's in Boise a nonprofit?" or "does this hospital have to offer charity care?". Returns how Medicare lists the hospital's ownership (nonprofit, government, for-profit), its city and main phone number, and what that means for financial assistance. Nonprofit hospitals must have a financial assistance policy.

Parameters3

name	string	required	Hospital name as on the bill, like St. Luke's Regional Medical Center.
state	string	optional	US state name or two-letter code. Recommended, since many hospitals share names.
city	string	optional	City, to pick between hospitals with the same name.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Hospital name as on the bill, like St. Luke's Regional Medical Center."
    },
    "state": {
      "type": "string",
      "description": "US state name or two-letter code. Recommended, since many hospitals share names."
    },
    "city": {
      "type": "string",
      "description": "City, to pick between hospitals with the same name."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

draft_bill_letter

Draft a letter to a billing office for the user to send. For requests like "help me dispute this bill", "write a letter asking for an itemized bill", "can I ask for a discount?" or "how do I apply for charity care?". Returns a letter as plain text with [brackets] for anything not given, tips, and the user's No Surprises Act and Good Faith Estimate rights with official CMS links. It never sends anything.

Parameters13

type	string	required	Type: itemized (ask for an itemized bill), dispute (ask for a charge to be reviewed), discount (prompt-pay or self-pay discount), or assistance (financial assistance or charity care).
name	string	optional	Patient or account holder name.
provider	string	optional	Hospital, clinic or provider name.
account	string	optional	Account or invoice number on the bill.
date	string	optional	Date of service.
service	string	optional	The service in plain words.
code	string	optional	Billing code of the charge. With amount, a dispute letter adds Medicare's benchmark (for a hospital charge, the hospital outpatient rate as well as the doctor's part).
amount	number	optional	Amount charged or balance due, in US dollars.
state	string	optional	US state, used for the benchmark in a dispute letter.
reason	string	optional	A sentence on what the user wants checked, for a dispute letter.
insured	string	optional	Set to no if paying without insurance (self-pay), for a discount letter.
setting	string	optional	Setting: office or facility (hospital or surgery center), for the benchmark in a dispute letter. ER visits and hospital clinic visits count as facility anyway.
billed_by	string	optional	Whose bill the charge is on when the service was in a hospital: hospital (the hospital's own facility charge) or doctor (the doctor's or physician group's bill). Leave out if not known: the charge is then compared with both together.

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "itemized",
        "dispute",
        "discount",
        "assistance"
      ],
      "description": "Type: itemized (ask for an itemized bill), dispute (ask for a charge to be reviewed), discount (prompt-pay or self-pay discount), or assistance (financial assistance or charity care)."
    },
    "name": {
      "type": "string",
      "description": "Patient or account holder name."
    },
    "provider": {
      "type": "string",
      "description": "Hospital, clinic or provider name."
    },
    "account": {
      "type": "string",
      "description": "Account or invoice number on the bill."
    },
    "date": {
      "type": "string",
      "description": "Date of service."
    },
    "service": {
      "type": "string",
      "description": "The service in plain words."
    },
    "code": {
      "type": "string",
      "description": "Billing code of the charge. With amount, a dispute letter adds Medicare's benchmark (for a hospital charge, the hospital outpatient rate as well as the doctor's part)."
    },
    "amount": {
      "type": "number",
      "minimum": 1,
      "maximum": 5000000,
      "description": "Amount charged or balance due, in US dollars."
    },
    "state": {
      "type": "string",
      "description": "US state, used for the benchmark in a dispute letter."
    },
    "reason": {
      "type": "string",
      "description": "A sentence on what the user wants checked, for a dispute letter."
    },
    "insured": {
      "type": "string",
      "enum": [
        "yes",
        "no"
      ],
      "description": "Set to no if paying without insurance (self-pay), for a discount letter."
    },
    "setting": {
      "type": "string",
      "enum": [
        "office",
        "facility"
      ],
      "description": "Setting: office or facility (hospital or surgery center), for the benchmark in a dispute letter. ER visits and hospital clinic visits count as facility anyway."
    },
    "billed_by": {
      "type": "string",
      "enum": [
        "hospital",
        "doctor"
      ],
      "description": "Whose bill the charge is on when the service was in a hospital: hospital (the hospital's own facility charge) or doctor (the doctor's or physician group's bill). Leave out if not known: the charge is then compared with both together."
    }
  },
  "required": [
    "type"
  ],
  "additionalProperties": false
}

README.md4 KBView on GitHub

goodturn-mcp

Remote MCP servers for 25 free, read-only everyday helpers by Good Turn Studio: money, health, jobs, travel, shopping, halal checks, football and scripture reading. One Cloudflare Worker turns each product's public OpenAPI spec into an MCP server, so any assistant that speaks MCP (Claude, ChatGPT, Alexa+, Cursor, VS Code and others) can use them.

One server per product: https://goodturn-mcp.pages.dev/<slug>/mcp
All products in one: https://goodturn-mcp.pages.dev/all/mcp (tool names start with the product slug)
Streamable HTTP, stateless JSON, MCP 2025-11-25 (and 2025-06-18, 2025-03-26), no sign-in
Every tool is read-only, with a title and annotations (readOnlyHint: true, destructiveHint: false, idempotentHint: true)
Nothing about the user is stored. Privacy: https://goodturn-mcp.pages.dev/privacy

Products

Product	Slug	What it does
Mizan	`mizan`	Shariah screening of US stocks under four standards, halal alternatives, purification, zakat
Halal or Not	`halalornot`	Halal checks for food, ingredients, medicines, stocks, funds and crypto
Fare Deals	`faredeals`	Cheap flights from any city, and the cheapest days to fly
Cheapest Price	`cheapestprice`	The lowest current price for a product, checked live
Spin My Day	`spinmyday`	A whole day out in any city, matched to weather, mood and diet
Cancel My Sub	`cancelmysub`	How to cancel US and UK subscriptions, and what a card charge is
Lower My Bill	`lowermybill`	Call scripts and low-cost plans to lower household bills
Price Drop Back	`pricedropback`	Store price-adjustment rules, deadlines and a claim message
Find My Money	`findmymoney`	Official unclaimed money searches in the US and UK
Supplement Check	`supplementcheck`	Supplement labels and doses against official upper limits
Plate Pal	`platepal`	Calories and nutrition for foods, chain meals and barcodes
Plan My Workout	`planmyworkout`	Workout plans and how to do any exercise
Med Bill Check	`medbillcheck`	US medical bills against Medicare rates, with dispute letters
Appeal My Claim	`appealmyclaim`	US health insurance denials, rights, deadlines and appeal letters
Job Spotter	`jobspotter`	Current US and UK job listings
Sync My Cycle	`syncmycycle`	Likely cycle phase today, with food and workout ideas
Wardrobe Connect	`wardrobeconnect`	Clothes that match a description or a picture
Form Guide	`formguide`	Football form, fixtures, results and tables
Books Like This	`bookslikethis`	Books like one you enjoyed, and screen adaptations
Talmud Scroller	`talmud`	Daily Talmud with Daf Yomi, and tractates in English
Scroll the Gurbani	`gurbani`	Daily Gurbani with English, any Ang or shabad
Gita Scroller	`gita`	Daily Bhagavad Gita verses with English
Scroll the Lore	`lore`	Greek and Norse myth, Homer, Hesiod and the Poetic Edda
Stoic Scroller	`stoics`	Marcus Aurelius, Epictetus and Seneca
Bible Swipe	`bible`	Daily Bible readings and any passage

How it works

build.py reads each product's live openapi.json and writes products.js: one tool per GET operation, named from its operationId, with inputs from its parameters. Descriptions are tidied into plain tool descriptions.
worker.mjs is the MCP server: initialize, tools/list and tools/call, which calls the product's own API and returns its answer. Answers with a say field carry a ready-made summary.
servers.json lists every server for the official MCP Registry (as io.github.GoodTurnStudio/<slug>). The Publish to the MCP Registry workflow logs in with GitHub OIDC and runs publish.py; publish.ps1 does the same from Windows.

Build and test

code

npm install
npm run build          # python3 build.py, then bundle to deploy/_worker.js
npm test               # every product through the worker, against the live APIs
npm run test:live      # every tool through the deployed servers with the MCP SDK client

Deploy deploy/ as a Cloudflare Pages project in advanced mode (_worker.js).

Licence

MIT for this code. Each product's API, data and answers belong to that product and are served under its own terms, linked from its page at https://goodturn-mcp.pages.dev/<slug>.

Install

Tools (5)

check_pricesearch_servicescheck_whole_billlook_up_hospitaldraft_bill_letter

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://goodturn-mcp.pages.dev/medbillcheck/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "medbillcheck": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://goodturn-mcp.pages.dev/medbillcheck/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.GoodTurnStudio/medbillcheck — MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

check_price

search_services

check_whole_bill

look_up_hospital

draft_bill_letter

goodturn-mcp

Products

How it works

Build and test

Licence

Install

Remote endpoint

Related servers