Hospital Price Compare
hospital_price_compareSide-by-side prices for one service at up to 10 named hospitals (by CMS Certification Number, CCN, from hospital_price_search or hospital_price_coverage). Same fields and same labelling as hospital_price_search: gross charge vs self-pay cash vs payer-negotiated rates, dollar_available on every negotiated rate, and for each hospital that has no price a stated reason (not held and why / code absent / payer not listed). Use for "compare MS-DRG 470 at these three hospitals for Blue Cross".
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ccns": [
"140208",
"140179",
"140054"
],
"code": "90853",
"payer": "blue cross",
"rates_per_hospital": 2
},
"name": "hospital_price_compare"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ccns | Yes | CMS Certification Numbers (6 characters, e.g. "330101"), 1-10. | |
| code | Yes | The service code: a CPT/HCPCS code from the CMS 70 shoppable services (e.g. "70450" head CT, "45378" colonoscopy, "99213"-style E&M codes only where on that list) or an MS-DRG number (e.g. "470" major joint replacement). | |
| plan | No | Case-insensitive substring of the plan name. | |
| payer | No | Case-insensitive substring of the payer name. | |
| setting | No | Restrict to inpatient or outpatient pricing. | |
| code_type | No | Optional. Inferred when omitted: 1-3 digits is an MS-DRG, a 5-character code is CPT/HCPCS. | |
| rates_per_hospital | No | Negotiated rows per hospital (1-25, default 25). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | Code | |
| hint | No | How to narrow or fix the request | |
| found | No | Whether at least one priced result was found | |
| priced | No | Hospitals with a price | |
| reason | No | Machine-readable reason when found is false | |
| source | No | Publisher and dataset | |
| message | No | Plain-language explanation of the reason | |
| coverage | No | Which states and how many hospitals the store holds | |
| code_type | No | MS-DRG or CPT/HCPCS | |
| hospitals | No | Hospitals with their prices or absence reasons | |
| requested | No | CCNs requested | |
| data_as_of | No | File last-updated date, or the store cycle | |
| licence_note | No | Reuse-licence caveat |