Loa Healthcare Pricing MCP
A remote Model Context Protocol server that gives AI assistants access to U.S. healthcare pricing data sourced from hospital Machine Readable Files, public provider identity records, and Loa-reviewed provider corrections. It provides tools for searching medical procedure codes, comparing nearby hospital prices, finding healthcare providers, and submitting reviewed entity corrections.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP tool calls and provider update submissions require OAuthOAuth 2.1 is required for submit_entity_update_request
MCP endpoint (Streamable HTTP)
https://www.loacare.com/api/mcpWhat its tools do
12 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (11)
Can change data (1)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search for medical procedure codes (CPT/HCPCS) by name or code number
- Compare hospitals near a ZIP code for one procedure ranked by cash price
- Search for healthcare providers by name, specialty, or location
- Submit reviewed entity corrections with contact and source evidence
Source and maintenance
Community listingRegistry 1.0.1
- Maintenance checked
Protocol and capabilities
- Server
- loacare 1.1.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 12 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
12 advertised
search_cpt_codes — Find a procedure
Advertised read-only
Find procedures by everyday name or billing code. Follow decision: clarify important variants before pricing; never choose a clinical default.
search_cpt_codes input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "number",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Maximum number of results (default 10, max 25)"
},
"query": {
"type": "string",
"description": "Concise procedure name, medical term, or candidate CPT code; omit personal narratives and identifiers (e.g. \"knee MRI\", \"blood work\", \"99213\")"
},
"category": {
"type": "string",
"description": "Filter by category: \"evaluation_management\", \"laboratory\", \"radiology\", \"surgery\", \"preventive\""
},
"specialty": {
"type": "string",
"description": "Filter by medical specialty (e.g. \"cardiology\", \"dermatology\")"
}
}
}search_cpt_codes output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query",
"specialty",
"category",
"total",
"provenance",
"results",
"coverage",
"pricing_codes",
"availability_scope",
"related_charges",
"suggestions",
"decision"
],
"properties": {
"query": {
"type": "string"
},
"total": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name",
"description",
"category",
"isCommon",
"price_availability",
"service_role",
"pricing_note"
],
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"category": {
"type": "string"
},
"isCommon": {
"type": "boolean"
},
"description": {
"type": "string"
},
"pricing_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"service_role": {
"enum": [
"procedure",
"add_on",
"separate_charge"
],
"type": "string"
},
"price_availability": {
"enum": [
"available",
"unavailable",
"unknown"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"coverage": {
"type": "string"
},
"decision": {
"type": "object",
"required": [
"status",
"question",
"options",
"guidance"
],
"properties": {
"status": {
"enum": [
"ready",
"compare_variants",
"needs_clarification",
"no_match",
"unavailable"
],
"type": "string"
},
"options": {
"type": "array",
"items": {
"type": "string"
}
},
"guidance": {
"type": "string"
},
"question": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"specialty": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provenance": {
"type": "object",
"required": [
"authority",
"basis",
"methodology_url"
],
"properties": {
"basis": {
"type": "string"
},
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri",
"description": "Supporting source link. A CMS Hospital Price Transparency policy page is not the hospital source file; do not attribute hospital-published prices to CMS."
},
"source_scope": {
"type": "string"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"suggestions": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
},
"pricing_codes": {
"type": "array",
"items": {
"type": "string"
}
},
"related_charges": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name",
"pricing_note",
"price_availability"
],
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"pricing_note": {
"type": "string"
},
"price_availability": {
"enum": [
"available",
"unavailable",
"unknown"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"availability_scope": {
"type": "string"
}
},
"additionalProperties": false
}search_cpt_codes annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_providers — Provider Search
Advertised read-only
Find clinicians and healthcare organizations in the CMS NPI Registry by name, specialty, or location. Returns directory details, not prices.
search_providers input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"name": {
"type": "string",
"description": "Provider name to search for (e.g. \"John Smith\")"
},
"limit": {
"type": "number",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Max results (default 20)"
},
"location": {
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "City name"
},
"state": {
"type": "string",
"description": "State code or full name (e.g. \"CA\", \"California\")"
},
"zip_code": {
"type": "string",
"description": "ZIP code"
}
},
"description": "Location to search in"
},
"specialty": {
"type": "string",
"description": "Medical specialty (e.g. \"Cardiology\", \"Family Medicine\")"
}
}
}search_providers output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query",
"providers",
"total",
"provenance"
],
"properties": {
"query": {
"type": "object",
"required": [
"specialty",
"name",
"location"
],
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"location": {
"type": "object",
"required": [
"city",
"state",
"zip_code"
],
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zip_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"specialty": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"total": {
"type": "number"
},
"providers": {
"type": "array",
"items": {
"type": "object",
"required": [
"npi",
"name",
"specialty",
"address",
"city",
"state",
"zip_code",
"phone",
"loa_link"
],
"properties": {
"npi": {
"type": "string"
},
"city": {
"type": "string"
},
"name": {
"type": "string"
},
"phone": {
"type": "string"
},
"state": {
"type": "string"
},
"address": {
"type": "string"
},
"loa_link": {
"anyOf": [
{
"type": "object",
"required": [
"url",
"action",
"label"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"label": {
"type": "string",
"description": "Use this exact label as the link text; it identifies the destination."
},
"action": {
"enum": [
"book",
"request",
"website",
"profile"
],
"type": "string"
}
},
"description": "Share this returned URL with its exact label. A website action redirects to the provider website; only a profile action opens a Loa listing. Do not infer the destination from the loacare.com domain.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"zip_code": {
"type": "string"
},
"specialty": {
"type": "string"
}
},
"additionalProperties": false
}
},
"provenance": {
"type": "object",
"required": [
"authority",
"basis",
"methodology_url"
],
"properties": {
"basis": {
"type": "string"
},
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri",
"description": "Supporting source link. A CMS Hospital Price Transparency policy page is not the hospital source file; do not attribute hospital-published prices to CMS."
},
"source_scope": {
"type": "string"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}search_providers annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_pricing_estimate — Pricing Estimate
Advertised read-only
U.S. care only, for users anywhere. For non-U.S. care, explain coverage without calling this tool or substituting U.S. prices. Estimate median cash prices and typical ranges (25th–75th percentile) for CPT codes, statewide by ZIP or nationally. Report missingCodes and insufficient_data without inventing prices; totals require data for every code. Use get_market_pricing for insurer benchmarks or get_hospital_pricing for named hospitals.
get_pricing_estimate input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"procedure_codes"
],
"properties": {
"zip_code": {
"type": "string",
"description": "U.S. ZIP code used to pick the state (omit only for U.S. national figures)"
},
"procedure_codes": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"description": "CPT procedure codes to price (e.g. [\"99213\", \"85025\"])"
}
}
}get_pricing_estimate output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"estimatedCost",
"procedures",
"zipCode",
"state",
"missingCodes",
"limitations",
"provenance",
"disclaimer"
],
"properties": {
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zipCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"disclaimer": {
"type": "string"
},
"procedures": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"description",
"estimatedCost",
"priceRange",
"pricingMethod",
"scope",
"data_points",
"hospital_count"
],
"properties": {
"code": {
"type": "string"
},
"scope": {
"anyOf": [
{
"enum": [
"state",
"national"
],
"type": "string"
},
{
"type": "null"
}
]
},
"priceRange": {
"anyOf": [
{
"type": "object",
"required": [
"min",
"max"
],
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"data_points": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"description": {
"type": "string"
},
"estimatedCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pricingMethod": {
"enum": [
"observed_market_median",
"insufficient_data"
],
"type": "string"
},
"hospital_count": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"provenance": {
"type": "object",
"required": [
"authority",
"basis",
"methodology_url"
],
"properties": {
"basis": {
"type": "string"
},
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri",
"description": "Supporting source link. A CMS Hospital Price Transparency policy page is not the hospital source file; do not attribute hospital-published prices to CMS."
},
"source_scope": {
"type": "string"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"missingCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"estimatedCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}get_pricing_estimate annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_market_pricing — Market Pricing
Advertised read-only
U.S. care only, for users anywhere. For non-U.S. care, explain coverage without calling this tool or substituting U.S. prices. Benchmark statewide or national cash, list, and insurer prices; each hospital counts once. Lead with median and p25–p75, report limitations, and never fill insufficient_data gaps. These are not ZIP-local quotes or personal out-of-pocket costs.
get_market_pricing input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"cpt_codes"
],
"properties": {
"state": {
"type": "string",
"description": "State for regional pricing (e.g. \"CA\", \"New York\"). Unknown states return McpToolInvalidInput. When fewer than 5 hospitals in the state published a price, national figures are returned with a limitation."
},
"zip_code": {
"type": "string",
"description": "ZIP code, used only to pick the state when state is omitted"
},
"cpt_codes": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"description": "CPT codes to look up (e.g. [\"99213\", \"93000\"])"
}
}
}get_market_pricing output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"pricing",
"state",
"provenance"
],
"properties": {
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"pricing": {
"type": "array",
"items": {
"type": "object",
"required": [
"cpt_code",
"procedure_name",
"status",
"scope",
"cash_price",
"list_price",
"insurance_price",
"insurance_by_payer",
"confidence",
"cash_data_points",
"insurance_data_points",
"states_covered",
"source_dates",
"limitations"
],
"properties": {
"scope": {
"anyOf": [
{
"enum": [
"state",
"national"
],
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"ok",
"insufficient_data"
],
"type": "string"
},
"cpt_code": {
"type": "string"
},
"cash_price": {
"anyOf": [
{
"type": "object",
"required": [
"median",
"average",
"min",
"max",
"p25",
"p75",
"data_points",
"hospital_count",
"source"
],
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
},
"p25": {
"type": "number"
},
"p75": {
"type": "number"
},
"median": {
"type": "number"
},
"source": {
"enum": [
"state",
"national"
],
"type": "string"
},
"average": {
"type": "number"
},
"data_points": {
"type": "number",
"description": "Price records behind this figure"
},
"hospital_count": {
"type": "number",
"description": "Hospitals behind this figure; each counts once"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"confidence": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"list_price": {
"anyOf": [
{
"type": "object",
"required": [
"median",
"average",
"min",
"max",
"p25",
"p75",
"data_points",
"hospital_count",
"source"
],
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
},
"p25": {
"type": "number"
},
"p75": {
"type": "number"
},
"median": {
"type": "number"
},
"source": {
"enum": [
"state",
"national"
],
"type": "string"
},
"average": {
"type": "number"
},
"data_points": {
"type": "number",
"description": "Price records behind this figure"
},
"hospital_count": {
"type": "number",
"description": "Hospitals behind this figure; each counts once"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"source_dates": {
"anyOf": [
{
"type": "object",
"required": [
"earliest",
"latest"
],
"properties": {
"latest": {
"type": "string"
},
"earliest": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Extraction dates of the underlying hospital files (YYYY-MM-DD)"
},
"procedure_name": {
"type": "string"
},
"states_covered": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"insurance_price": {
"anyOf": [
{
"type": "object",
"required": [
"median",
"average",
"min",
"max",
"p25",
"p75",
"data_points",
"hospital_count",
"source"
],
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
},
"p25": {
"type": "number"
},
"p75": {
"type": "number"
},
"median": {
"type": "number"
},
"source": {
"enum": [
"state",
"national"
],
"type": "string"
},
"average": {
"type": "number"
},
"data_points": {
"type": "number",
"description": "Price records behind this figure"
},
"hospital_count": {
"type": "number",
"description": "Hospitals behind this figure; each counts once"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"cash_data_points": {
"type": "number"
},
"insurance_by_payer": {
"type": "array",
"items": {
"type": "object",
"required": [
"payer",
"median",
"p25",
"p75",
"data_points",
"hospital_count"
],
"properties": {
"p25": {
"type": "number"
},
"p75": {
"type": "number"
},
"payer": {
"type": "string"
},
"median": {
"type": "number"
},
"data_points": {
"type": "number"
},
"hospital_count": {
"type": "number"
}
},
"additionalProperties": false
}
},
"insurance_data_points": {
"type": "number"
}
},
"additionalProperties": false
}
},
"provenance": {
"type": "object",
"required": [
"authority",
"basis",
"methodology_url"
],
"properties": {
"basis": {
"type": "string"
},
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri",
"description": "Supporting source link. A CMS Hospital Price Transparency policy page is not the hospital source file; do not attribute hospital-published prices to CMS."
},
"source_scope": {
"type": "string"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}get_market_pricing annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_hospitals — Hospital Search
Advertised read-only
Find hospitals by name or location, with addresses, contact details, and IDs for get_hospital_pricing.
search_hospitals input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"city": {
"type": "string",
"description": "City name"
},
"name": {
"type": "string",
"description": "Hospital name to search for"
},
"limit": {
"type": "number",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Max results (default 20)"
},
"state": {
"type": "string",
"description": "Two-letter state code or full state name, e.g. \"CA\" or \"New York\"."
},
"zip_code": {
"type": "string",
"description": "ZIP code"
}
}
}search_hospitals output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query",
"hospitals",
"total",
"provenance"
],
"properties": {
"query": {
"type": "object",
"required": [
"state",
"city",
"zip_code",
"name"
],
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zip_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"total": {
"type": "number"
},
"hospitals": {
"type": "array",
"items": {
"type": "object",
"required": [
"hospital_id",
"name",
"address",
"city",
"state",
"zip_code",
"phone",
"website",
"loa_link"
],
"properties": {
"city": {
"type": "string"
},
"name": {
"type": "string"
},
"phone": {
"type": "string"
},
"state": {
"type": "string"
},
"address": {
"type": "string"
},
"website": {
"type": "string"
},
"loa_link": {
"anyOf": [
{
"type": "object",
"required": [
"url",
"action",
"label"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"label": {
"type": "string",
"description": "Use this exact label as the link text; it identifies the destination."
},
"action": {
"enum": [
"book",
"request",
"website",
"profile"
],
"type": "string"
}
},
"description": "Share this returned URL with its exact label. A website action redirects to the provider website; only a profile action opens a Loa listing. Do not infer the destination from the loacare.com domain.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"zip_code": {
"type": "string"
},
"hospital_id": {
"type": "string"
}
},
"additionalProperties": false
}
},
"provenance": {
"type": "object",
"required": [
"authority",
"basis",
"methodology_url"
],
"properties": {
"basis": {
"type": "string"
},
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri",
"description": "Supporting source link. A CMS Hospital Price Transparency policy page is not the hospital source file; do not attribute hospital-published prices to CMS."
},
"source_scope": {
"type": "string"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}search_hospitals annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_hospital_pricing — Hospital Pricing
Advertised read-only
U.S. care only, for users anywhere. For non-U.S. care, explain coverage without calling this tool or substituting U.S. prices. Get source-labeled Published MRF prices and Loa Verified Provider Price overlays for named hospitals and CPT codes. Cash is self-pay, list is the gross charge before discounts, and insurer rates are not personal out-of-pocket costs; missing prices are null.
get_hospital_pricing input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"hospital_ids",
"cpt_codes"
],
"properties": {
"cpt_codes": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"description": "CPT procedure codes to look up pricing for"
},
"hospital_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"description": "Hospital IDs from search_hospitals results"
}
}
}get_hospital_pricing output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"pricing",
"total",
"hospitals_found",
"services_found",
"provenance"
],
"properties": {
"total": {
"type": "number"
},
"pricing": {
"type": "array",
"items": {
"type": "object",
"required": [
"hospital_id",
"hospital_name",
"hospital_location",
"cpt_code",
"cpt_description",
"cash_price",
"cash_source_labels",
"cash_includes",
"list_price",
"insurance_prices",
"source_labels",
"record_count",
"loa_link"
],
"properties": {
"cpt_code": {
"type": "string"
},
"loa_link": {
"anyOf": [
{
"type": "object",
"required": [
"url",
"action",
"label"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"label": {
"type": "string",
"description": "Use this exact label as the link text; it identifies the destination."
},
"action": {
"enum": [
"book",
"request",
"website",
"profile"
],
"type": "string"
}
},
"description": "Share this returned URL with its exact label. A website action redirects to the provider website; only a profile action opens a Loa listing. Do not infer the destination from the loacare.com domain.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"cash_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"list_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"hospital_id": {
"type": "string"
},
"record_count": {
"type": "number"
},
"cash_includes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hospital_name": {
"type": "string"
},
"source_labels": {
"type": "array",
"items": {
"type": "string"
}
},
"cpt_description": {
"type": "string"
},
"insurance_prices": {
"type": "array",
"items": {
"type": "object",
"required": [
"includes",
"payer",
"plan",
"price",
"source_label"
],
"properties": {
"plan": {
"type": "string"
},
"payer": {
"type": "string"
},
"price": {
"type": "number"
},
"includes": {
"type": "string"
},
"source_label": {
"type": "string"
}
},
"additionalProperties": false
}
},
"hospital_location": {
"type": "string"
},
"cash_source_labels": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"provenance": {
"type": "object",
"required": [
"authority",
"basis",
"methodology_url"
],
"properties": {
"basis": {
"type": "string"
},
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri",
"description": "Supporting source link. A CMS Hospital Price Transparency policy page is not the hospital source file; do not attribute hospital-published prices to CMS."
},
"source_scope": {
"type": "string"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"services_found": {
"type": "number"
},
"hospitals_found": {
"type": "number"
}
},
"additionalProperties": false
}get_hospital_pricing annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}compare_local_prices — Compare Local Prices
Advertised read-only
U.S. care only, for users anywhere. For non-U.S. care, explain coverage without calling this tool or substituting U.S. prices. Compare hospitals near a ZIP by price or distance for a code from search_cpt_codes. Lead with answer: lowest cash, insurer comparison, verdict, follow-up, and search link. Its prices are single published prices; options use hospital medians. Without insurer, compare cash; with insurer, compare negotiated rates, not personal out-of-pocket costs. Preserve sources, dates, included fees, caveats, and each hospital’s city/state. Rank before limiting; missing matching prices are null and last. Do not send patient identifiers.
compare_local_prices input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"cpt_code",
"zip_code"
],
"properties": {
"sort": {
"enum": [
"price",
"distance"
],
"type": "string",
"description": "Order by price (default) or distance"
},
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Maximum hospitals to return (default 10, max 20)"
},
"insurer": {
"type": "string",
"maxLength": 60,
"description": "Insurance company name only, e.g. \"Aetna\" or \"Blue Cross\"; no member IDs"
},
"cpt_code": {
"type": "string",
"description": "One CPT or HCPCS code, e.g. \"73721\" for a knee MRI"
},
"zip_code": {
"type": "string",
"description": "5-digit US ZIP code to search around"
},
"radius_miles": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Search radius in miles (default 25, max 100)"
},
"deductible_met": {
"enum": [
"yes",
"no",
"not_sure"
],
"type": "string",
"description": "Whether the user has met this year's deductible; refines answer.verdict"
}
}
}compare_local_prices output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query",
"answer",
"insurer_match",
"options",
"price_summary",
"hospitals_with_price",
"hospitals_without_price",
"notes",
"provenance"
],
"properties": {
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"query": {
"type": "object",
"required": [
"cpt_code",
"procedure_name",
"zip_code",
"radius_miles",
"insurer",
"deductible_met",
"sort"
],
"properties": {
"sort": {
"enum": [
"price",
"distance"
],
"type": "string"
},
"insurer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"cpt_code": {
"type": "string"
},
"zip_code": {
"type": "string"
},
"radius_miles": {
"type": "number"
},
"deductible_met": {
"anyOf": [
{
"enum": [
"yes",
"no",
"not_sure"
],
"type": "string"
},
{
"type": "null"
}
]
},
"procedure_name": {
"type": "string"
}
},
"additionalProperties": false
},
"answer": {
"type": "object",
"required": [
"lowest_cash",
"lowest_insurer_rate",
"verdict",
"follow_up_question",
"loa_search_url"
],
"properties": {
"verdict": {
"anyOf": [
{
"type": "object",
"required": [
"recommendation",
"headline",
"detail"
],
"properties": {
"detail": {
"type": "string"
},
"headline": {
"type": "string"
},
"recommendation": {
"enum": [
"cash",
"insurance",
"either",
"conditional",
"ask_insurer"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"lowest_cash": {
"anyOf": [
{
"type": "object",
"required": [
"hospital_id",
"hospital_name",
"address",
"city",
"state",
"zip_code",
"phone",
"distance_miles",
"price_type",
"includes",
"setting",
"as_of",
"source_label",
"caveats",
"loa_link",
"price",
"price_basis",
"plan_name"
],
"properties": {
"city": {
"type": "string"
},
"as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"phone": {
"type": "string"
},
"price": {
"type": "number"
},
"state": {
"type": "string"
},
"address": {
"type": "string"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"setting": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"includes": {
"type": "string"
},
"loa_link": {
"anyOf": [
{
"type": "object",
"required": [
"url",
"action",
"label"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"label": {
"type": "string",
"description": "Use this exact label as the link text; it identifies the destination."
},
"action": {
"enum": [
"book",
"request",
"website",
"profile"
],
"type": "string"
}
},
"description": "Share this returned URL with its exact label. A website action redirects to the provider website; only a profile action opens a Loa listing. Do not infer the destination from the loacare.com domain.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"zip_code": {
"type": "string"
},
"plan_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price_type": {
"type": "string"
},
"hospital_id": {
"type": "string"
},
"price_basis": {
"enum": [
"cash",
"insurer_rate"
],
"type": "string"
},
"source_label": {
"type": "string"
},
"hospital_name": {
"type": "string"
},
"distance_miles": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"loa_search_url": {
"type": "string"
},
"follow_up_question": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lowest_insurer_rate": {
"anyOf": [
{
"type": "object",
"required": [
"hospital_id",
"hospital_name",
"address",
"city",
"state",
"zip_code",
"phone",
"distance_miles",
"price_type",
"includes",
"setting",
"as_of",
"source_label",
"caveats",
"loa_link",
"price",
"price_basis",
"plan_name"
],
"properties": {
"city": {
"type": "string"
},
"as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"phone": {
"type": "string"
},
"price": {
"type": "number"
},
"state": {
"type": "string"
},
"address": {
"type": "string"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"setting": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"includes": {
"type": "string"
},
"loa_link": {
"anyOf": [
{
"type": "object",
"required": [
"url",
"action",
"label"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"label": {
"type": "string",
"description": "Use this exact label as the link text; it identifies the destination."
},
"action": {
"enum": [
"book",
"request",
"website",
"profile"
],
"type": "string"
}
},
"description": "Share this returned URL with its exact label. A website action redirects to the provider website; only a profile action opens a Loa listing. Do not infer the destination from the loacare.com domain.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"zip_code": {
"type": "string"
},
"plan_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price_type": {
"type": "string"
},
"hospital_id": {
"type": "string"
},
"price_basis": {
"enum": [
"cash",
"insurer_rate"
],
"type": "string"
},
"source_label": {
"type": "string"
},
"hospital_name": {
"type": "string"
},
"distance_miles": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"hospital_id",
"hospital_name",
"address",
"city",
"state",
"zip_code",
"phone",
"distance_miles",
"price",
"price_basis",
"price_type",
"cash_price",
"cash_price_range",
"insurer_rate",
"insurer_plans",
"list_price",
"includes",
"setting",
"as_of",
"source_label",
"caveats",
"loa_link",
"rank"
],
"properties": {
"city": {
"type": "string"
},
"rank": {
"type": "number"
},
"as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"phone": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"state": {
"type": "string"
},
"address": {
"type": "string"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"setting": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"includes": {
"type": "string"
},
"loa_link": {
"anyOf": [
{
"type": "object",
"required": [
"url",
"action",
"label"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"label": {
"type": "string",
"description": "Use this exact label as the link text; it identifies the destination."
},
"action": {
"enum": [
"book",
"request",
"website",
"profile"
],
"type": "string"
}
},
"description": "Share this returned URL with its exact label. A website action redirects to the provider website; only a profile action opens a Loa listing. Do not infer the destination from the loacare.com domain.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"zip_code": {
"type": "string"
},
"cash_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"list_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"price_type": {
"type": "string"
},
"hospital_id": {
"type": "string"
},
"price_basis": {
"anyOf": [
{
"enum": [
"cash",
"insurer_rate"
],
"type": "string"
},
{
"type": "null"
}
]
},
"insurer_rate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"source_label": {
"type": "string"
},
"hospital_name": {
"type": "string"
},
"insurer_plans": {
"type": "array",
"items": {
"type": "string"
}
},
"distance_miles": {
"type": "number"
},
"cash_price_range": {
"anyOf": [
{
"type": "object",
"required": [
"min",
"max"
],
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"provenance": {
"type": "object",
"required": [
"authority",
"basis",
"methodology_url"
],
"properties": {
"basis": {
"type": "string"
},
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri",
"description": "Supporting source link. A CMS Hospital Price Transparency policy page is not the hospital source file; do not attribute hospital-published prices to CMS."
},
"source_scope": {
"type": "string"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"insurer_match": {
"anyOf": [
{
"type": "object",
"required": [
"input",
"matched_insurer"
],
"properties": {
"input": {
"type": "string"
},
"matched_insurer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"price_summary": {
"anyOf": [
{
"type": "object",
"required": [
"basis",
"lowest",
"median",
"highest",
"hospitals"
],
"properties": {
"basis": {
"enum": [
"cash",
"insurer_rate"
],
"type": "string"
},
"lowest": {
"type": "number"
},
"median": {
"type": "number"
},
"highest": {
"type": "number"
},
"hospitals": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"hospitals_with_price": {
"type": "number"
},
"hospitals_without_price": {
"type": "number"
}
},
"additionalProperties": false
}compare_local_prices annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_entities — Entity Search
Advertised read-only
Find Loa hospital and provider listings by name or state. Resolve the exact slug before profile, price, or source lookups.
search_entities input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "number",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Maximum number of results, default 20, max 50."
},
"query": {
"type": "string",
"description": "Hospital or provider name to search for."
},
"state": {
"type": "string",
"description": "Two-letter state code or full state name, e.g. CA or New York."
},
"entity_type": {
"enum": [
"hospital",
"provider"
],
"type": "string",
"description": "Optional filter for hospital or provider entities."
}
}
}search_entities output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query",
"total",
"entities",
"provenance"
],
"properties": {
"query": {
"type": "object",
"required": [
"query",
"entity_type",
"state"
],
"properties": {
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"total": {
"type": "number"
},
"entities": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"entity_type",
"slug",
"canonical_name",
"display_name",
"city",
"state",
"zip_code",
"data_quality_score",
"updated_at",
"loa_link"
],
"properties": {
"id": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"type": "string"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"loa_link": {
"anyOf": [
{
"type": "object",
"required": [
"url",
"action",
"label"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"label": {
"type": "string",
"description": "Use this exact label as the link text; it identifies the destination."
},
"action": {
"enum": [
"book",
"request",
"website",
"profile"
],
"type": "string"
}
},
"description": "Share this returned URL with its exact label. A website action redirects to the provider website; only a profile action opens a Loa listing. Do not infer the destination from the loacare.com domain.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"zip_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"updated_at": {
"type": "string",
"description": "ISO 8601 timestamp"
},
"entity_type": {
"enum": [
"hospital",
"provider"
],
"type": "string"
},
"display_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"canonical_name": {
"type": "string"
},
"data_quality_score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"provenance": {
"type": "object",
"required": [
"authority",
"basis",
"methodology_url"
],
"properties": {
"basis": {
"type": "string"
},
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri",
"description": "Supporting source link. A CMS Hospital Price Transparency policy page is not the hospital source file; do not attribute hospital-published prices to CMS."
},
"source_scope": {
"type": "string"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}search_entities annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_entity_prices — Entity Prices
Advertised read-only
U.S. care only, for users anywhere. For non-U.S. care, explain coverage without calling this tool or substituting U.S. prices. Get source-labeled prices by Loa listing slug; use search_entities to resolve it first. Missing CPT prices return explicit unavailable rows.
get_entity_prices input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"minLength": 1,
"description": "Exact Loa entity slug from search_entities or a Loa SEO page."
},
"limit": {
"type": "number",
"default": 50,
"maximum": 100,
"minimum": 1,
"description": "Maximum number of prices, default 50, max 100."
},
"cpt_codes": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 25,
"minItems": 1,
"description": "Optional CPT codes to filter. If omitted, returns current indexed prices up to the limit."
}
}
}get_entity_prices output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entity",
"loa_link",
"prices",
"total",
"provenance"
],
"properties": {
"total": {
"type": "number"
},
"entity": {
"type": "object",
"required": [
"id",
"entityType",
"slug",
"canonicalName",
"city",
"state"
],
"properties": {
"id": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"type": "string"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entityType": {
"enum": [
"hospital",
"provider"
],
"type": "string"
},
"canonicalName": {
"type": "string"
}
},
"additionalProperties": false
},
"prices": {
"type": "array",
"items": {
"type": "object",
"required": [
"entityPageId",
"cptCode",
"codeType",
"priceCents",
"priceKind",
"label",
"provenance"
],
"properties": {
"label": {
"type": "string"
},
"cptCode": {
"type": "string"
},
"setting": {
"type": "string"
},
"codeType": {
"type": "string"
},
"includes": {
"type": "string"
},
"planName": {
"type": "string"
},
"component": {
"enum": [
"global",
"professional",
"facility",
"unknown"
],
"type": "string"
},
"payerName": {
"type": "string"
},
"priceKind": {
"type": "string"
},
"priceCents": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"provenance": {
"type": "object",
"required": [
"authority",
"sourceType",
"sourceLabel",
"confidence",
"caveats"
],
"properties": {
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"authority": {
"type": "string"
},
"confidence": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"sourceType": {
"type": "string"
},
"sourceLabel": {
"type": "string"
},
"sourceUpdatedAt": {
"type": "string"
}
},
"additionalProperties": false
},
"sourceRowId": {
"type": "string"
},
"billingClass": {
"type": "string"
},
"entityPageId": {
"type": "string"
},
"serviceCategory": {
"type": "string"
},
"basePriceIndexId": {
"type": "string"
},
"comparableMrfPrice": {
"type": "object",
"required": [
"entityPageId",
"cptCode",
"codeType",
"priceCents",
"priceKind",
"label",
"provenance"
],
"properties": {
"label": {
"type": "string"
},
"cptCode": {
"type": "string"
},
"setting": {
"type": "string"
},
"codeType": {
"type": "string"
},
"includes": {
"type": "string"
},
"planName": {
"type": "string"
},
"component": {
"enum": [
"global",
"professional",
"facility",
"unknown"
],
"type": "string"
},
"payerName": {
"type": "string"
},
"priceKind": {
"type": "string"
},
"priceCents": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"provenance": {
"type": "object",
"required": [
"authority",
"sourceType",
"sourceLabel",
"confidence",
"caveats"
],
"properties": {
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"authority": {
"type": "string"
},
"confidence": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"sourceType": {
"type": "string"
},
"sourceLabel": {
"type": "string"
},
"sourceUpdatedAt": {
"type": "string"
}
},
"additionalProperties": false
},
"sourceRowId": {
"type": "string"
},
"billingClass": {
"type": "string"
},
"entityPageId": {
"type": "string"
},
"serviceCategory": {
"type": "string"
},
"basePriceIndexId": {
"type": "string"
},
"overlayRelationship": {
"type": "string"
},
"practiceConfirmation": {
"type": "object",
"required": [
"versionId",
"itemId",
"confirmedAt",
"details"
],
"properties": {
"itemId": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"versionId": {
"type": "string"
},
"confirmedAt": {
"type": "string"
}
},
"additionalProperties": false
},
"procedureDescription": {
"type": "string"
}
},
"additionalProperties": false
},
"overlayRelationship": {
"type": "string"
},
"practiceConfirmation": {
"type": "object",
"required": [
"versionId",
"itemId",
"confirmedAt",
"details"
],
"properties": {
"itemId": {
"type": "string"
},
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"versionId": {
"type": "string"
},
"confirmedAt": {
"type": "string"
}
},
"additionalProperties": false
},
"procedureDescription": {
"type": "string"
}
},
"additionalProperties": false
}
},
"loa_link": {
"anyOf": [
{
"type": "object",
"required": [
"url",
"action",
"label"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"label": {
"type": "string",
"description": "Use this exact label as the link text; it identifies the destination."
},
"action": {
"enum": [
"book",
"request",
"website",
"profile"
],
"type": "string"
}
},
"description": "Share this returned URL with its exact label. A website action redirects to the provider website; only a profile action opens a Loa listing. Do not infer the destination from the loacare.com domain.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"provenance": {
"type": "object",
"required": [
"authority",
"basis",
"methodology_url"
],
"properties": {
"basis": {
"type": "string"
},
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri",
"description": "Supporting source link. A CMS Hospital Price Transparency policy page is not the hospital source file; do not attribute hospital-published prices to CMS."
},
"source_scope": {
"type": "string"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}get_entity_prices annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_entity_profile — Entity Profile
Advertised read-only
Get a hospital or provider profile by exact Loa slug or ID, with field provenance. On request, offer correction_url for corrections plus optional affiliation verification, or claim_url for affiliation only. Both forms allow intake without an account; dashboard access requires verification. Use the exact loa_link.label.
get_entity_profile input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug_or_id"
],
"properties": {
"slug_or_id": {
"type": "string",
"minLength": 1,
"description": "Exact Loa entity slug or entity_pages.id from search_entities."
},
"entity_type": {
"enum": [
"hospital",
"provider"
],
"type": "string",
"description": "Optional disambiguation when slug_or_id is a slug."
}
}
}get_entity_profile output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entity",
"loa_link",
"provider_actions",
"profile_provenance",
"profile_field_provenance",
"provenance"
],
"properties": {
"entity": {
"type": "object",
"required": [
"id",
"entityType",
"slug",
"canonicalName",
"displayName",
"city",
"state",
"zipCode",
"address",
"phone",
"website",
"npi",
"ccn",
"hpfId",
"dataQualityScore",
"updatedAt",
"metadata"
],
"properties": {
"id": {
"type": "string"
},
"ccn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"npi": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"type": "string"
},
"hpfId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zipCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"metadata": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"updatedAt": {
"type": "string",
"description": "ISO 8601 timestamp"
},
"entityType": {
"enum": [
"hospital",
"provider"
],
"type": "string"
},
"displayName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"canonicalName": {
"type": "string"
},
"dataQualityScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"loa_link": {
"type": "object",
"required": [
"url",
"action",
"label"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"label": {
"type": "string",
"description": "Use this exact label as the link text; it identifies the destination."
},
"action": {
"enum": [
"book",
"request",
"website",
"profile"
],
"type": "string"
}
},
"description": "Share this returned URL with its exact label. A website action redirects to the provider website; only a profile action opens a Loa listing. Do not infer the destination from the loacare.com domain.",
"additionalProperties": false
},
"provenance": {
"type": "object",
"required": [
"authority",
"basis",
"methodology_url"
],
"properties": {
"basis": {
"type": "string"
},
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri",
"description": "Supporting source link. A CMS Hospital Price Transparency policy page is not the hospital source file; do not attribute hospital-published prices to CMS."
},
"source_scope": {
"type": "string"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"provider_actions": {
"anyOf": [
{
"type": "object",
"required": [
"correction_url",
"claim_url"
],
"properties": {
"claim_url": {
"type": "string",
"format": "uri",
"description": "Request affiliation verification only. For corrections plus verification, use correction_url instead. Submitting does not grant dashboard access."
},
"correction_url": {
"type": "string",
"format": "uri",
"description": "Suggest listing or price changes and optionally request affiliation verification in the same form. No separate claim or existing account is required."
}
},
"description": "Offer only when the user asks to correct, add prices to, or claim this listing.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"profile_provenance": {
"type": "object",
"required": [
"authority",
"source_type",
"source_label",
"confidence"
],
"properties": {
"authority": {
"type": "string"
},
"confidence": {
"type": "string"
},
"source_type": {
"type": "string"
},
"source_label": {
"type": "string"
},
"loa_reviewed_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"profile_field_provenance": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "object",
"required": [
"authority",
"source_type",
"source_label",
"confidence"
],
"properties": {
"authority": {
"type": "string"
},
"confidence": {
"type": "string"
},
"source_type": {
"type": "string"
},
"source_label": {
"type": "string"
},
"loa_reviewed_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}get_entity_profile annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}explain_price_sources — Explain Price Sources
Advertised read-only
U.S. care only, for users anywhere. For non-U.S. care, explain coverage without calling this tool or substituting U.S. prices. Explain only the returned source labels, counts, confidence, and caveats. Separate available prices from unavailable placeholders; if none are available, say so without inventing prices or source categories.
explain_price_sources input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"minLength": 1,
"description": "Exact Loa entity slug from search_entities."
},
"limit": {
"type": "number",
"default": 50,
"maximum": 100,
"minimum": 1,
"description": "Maximum number of prices to inspect, default 50, max 100."
},
"cpt_codes": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 25,
"minItems": 1,
"description": "Optional CPT codes to explain. If omitted, explains current indexed prices."
}
}
}explain_price_sources output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entity",
"cpt_codes",
"price_count",
"available_price_count",
"unavailable_price_count",
"comparable_mrf_price_count",
"source_summary",
"caveats",
"provenance"
],
"properties": {
"entity": {
"type": "object",
"required": [
"id",
"entityType",
"slug",
"canonicalName",
"city",
"state"
],
"properties": {
"id": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"type": "string"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entityType": {
"enum": [
"hospital",
"provider"
],
"type": "string"
},
"canonicalName": {
"type": "string"
}
},
"additionalProperties": false
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"cpt_codes": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"required": [
"authority",
"basis",
"methodology_url"
],
"properties": {
"basis": {
"type": "string"
},
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri",
"description": "Supporting source link. A CMS Hospital Price Transparency policy page is not the hospital source file; do not attribute hospital-published prices to CMS."
},
"source_scope": {
"type": "string"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"price_count": {
"type": "number",
"description": "Total resolver rows, including unavailable placeholders."
},
"source_summary": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"authority",
"sourceType",
"confidence",
"count",
"comparableMrfPriceCount",
"caveats"
],
"properties": {
"count": {
"type": "number"
},
"label": {
"type": "string"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"authority": {
"type": "string"
},
"confidence": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"comparableMrfPriceCount": {
"type": "number"
}
},
"additionalProperties": false
}
},
"available_price_count": {
"type": "number",
"description": "Rows with a usable price; excludes unavailable placeholders."
},
"unavailable_price_count": {
"type": "number",
"description": "Rows without a usable price; not evidence of a published or verified price."
},
"comparable_mrf_price_count": {
"type": "number"
}
},
"additionalProperties": false
}explain_price_sources annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}submit_entity_update_request — Submit Entity Update Request
Submit a pending listing or price correction for Loa review. Requires sign-in, not a claimed listing; stores business contact details and public evidence. Patient data is unsupported. Does not publish changes, verify affiliation, or grant dashboard access. Website correction and claim links come from get_entity_profile.
submit_entity_update_request input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"submitter_email",
"request_type"
],
"properties": {
"attestation": {
"enum": [
"provider_representative",
"authorized_agent",
"public_source",
"other"
],
"type": "string",
"description": "How the submitter is connected to the submitted evidence."
},
"entity_slug": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Exact Loa entity slug if entity_page_id is not available."
},
"entity_type": {
"enum": [
"hospital",
"provider",
"unknown"
],
"type": "string",
"default": "unknown",
"description": "Entity kind for the requested update; use unknown only when it cannot be determined."
},
"price_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"cpt_code"
],
"properties": {
"setting": {
"type": "string",
"maxLength": 100
},
"cpt_code": {
"type": "string",
"maxLength": 20,
"minLength": 3
},
"code_type": {
"type": "string",
"default": "CPT",
"maxLength": 20,
"minLength": 1
},
"component": {
"enum": [
"global",
"professional",
"facility",
"unknown"
],
"type": "string",
"default": "unknown"
},
"plan_name": {
"type": "string",
"maxLength": 300
},
"exclusions": {
"type": "string",
"maxLength": 1000
},
"payer_name": {
"type": "string",
"maxLength": 300
},
"price_kind": {
"enum": [
"cash",
"discounted_cash",
"package_cash",
"payer_negotiated"
],
"type": "string",
"default": "cash"
},
"price_notes": {
"type": "string",
"maxLength": 1000
},
"service_name": {
"type": "string",
"maxLength": 300
},
"billing_class": {
"type": "string",
"maxLength": 100
},
"included_services": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
}
},
"proposed_price_cents": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"default": [],
"maxItems": 100,
"description": "Optional structured price rows proposed for Loa review."
},
"source_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"default": [],
"maxItems": 10,
"description": "Optional public URLs reviewers can use to verify the submitted change."
},
"request_type": {
"enum": [
"price_update",
"profile_correction",
"new_listing",
"remove_listing",
"other"
],
"type": "string",
"description": "Type of reviewed change being requested."
},
"source_notes": {
"type": "string",
"maxLength": 2000,
"description": "Short verification notes, source context, or callback instructions."
},
"entity_page_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Loa entity_pages.id for the provider or hospital."
},
"submitter_name": {
"type": "string",
"maxLength": 200,
"description": "Name of the person submitting the request."
},
"submitter_role": {
"type": "string",
"maxLength": 200,
"description": "Submitter role, such as billing manager or authorized agent."
},
"idempotency_key": {
"type": "string",
"maxLength": 200,
"minLength": 8,
"description": "Optional stable retry key. Loa derives one from the payload if omitted."
},
"submitter_email": {
"type": "string",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Work email for the submitting representative."
},
"submitter_phone": {
"type": "string",
"maxLength": 50,
"description": "Optional callback phone number for reviewer follow-up."
},
"proposed_changes": {
"type": "object",
"default": {},
"description": "Structured profile or listing fields proposed for Loa review.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"uploaded_file_url": {
"type": "string",
"format": "uri",
"description": "Optional public URL for an uploaded evidence file."
},
"submitter_organization": {
"type": "string",
"maxLength": 300,
"description": "Provider, hospital, or agent organization represented by the submitter."
}
}
}submit_entity_update_request output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"requestId",
"updateRequestId",
"status",
"entityPageId",
"reusedExisting"
],
"properties": {
"status": {
"type": "string"
},
"requestId": {
"type": "string"
},
"entityPageId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reusedExisting": {
"type": "boolean"
},
"updateRequestId": {
"type": "string"
}
},
"additionalProperties": false
}submit_entity_update_request annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-06: 1 of 1 checks answered
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 936 ms
- 95th percentile latency
- 936 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 936 ms · metadata changed · 12 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http loa-healthcare-pricing-mcp https://www.loacare.com/api/mcpCodex
Codex configuration
codex mcp add loa-healthcare-pricing-mcp --url https://www.loacare.com/api/mcpCursor
Cursor configuration
{
"mcpServers": {
"loa-healthcare-pricing-mcp": {
"url": "https://www.loacare.com/api/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"loa-healthcare-pricing-mcp": {
"type": "streamableHttp",
"url": "https://www.loacare.com/api/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"loa-healthcare-pricing-mcp": {
"type": "http",
"url": "https://www.loacare.com/api/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http loa-healthcare-pricing-mcp https://www.loacare.com/api/mcpClaude Desktop
Claude Desktop configuration
https://www.loacare.com/api/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"loa-healthcare-pricing-mcp": {
"serverUrl": "https://www.loacare.com/api/mcp"
}
}
}Let your agent find its tools
Find servers like Loa Healthcare Pricing MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.