Loa Healthcare Pricing
Search source-labeled hospital prices, CPT codes, providers, and healthcare cost estimates.
Sollte ich dies verwenden
Qualität und Sicherheit
A
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
~9,008Tokens (Tool-Definitionen)
~8.0 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (7.04% von 128k Kontext)
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"loacare-healthcare-pricing": {
"url": "https://www.loacare.com/api/mcp"
}
}
}Remote-Endpunkte
https://www.loacare.com/api/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (12)
🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢search_cpt_codes(query, specialty, category, limit)
Canonical code-lookup tool for this server. Search Loa's CPT/HCPCS index using exact codes, clinical terms, or consumer phrases. Use this first when the user does not already know the CPT code, before calling pricing tools.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search query, procedure name, medical term, or CPT code number (e.g. \"knee MRI\", \"blood work\", \"99213\")"
},
"specialty": {
"description": "Filter by medical specialty (e.g. \"cardiology\", \"dermatology\")",
"type": "string"
},
"category": {
"description": "Filter by category: \"evaluation_management\", \"laboratory\", \"radiology\", \"surgery\", \"preventive\"",
"type": "string"
},
"limit": {
"description": "Maximum number of results (default 10, max 25)",
"default": 10,
"type": "number",
"minimum": 1,
"maximum": 25
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"specialty": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"total": {
"type": "number"
},
"provenance": {
"type": "object",
"properties": {
"authority": {
"type": "string",
"enum": [
"authoritative",
"advisory",
"estimate"
]
},
"basis": {
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"additionalProperties": false
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"category": {
"type": "string"
},
"isCommon": {
"type": "boolean"
}
},
"required": [
"code",
"name",
"description",
"category",
"isCommon"
],
"additionalProperties": false
}
}
},
"required": [
"query",
"specialty",
"category",
"total",
"provenance",
"results"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢suggest_procedures(query)
Advisory helper that suggests likely CPT codes from a plain-English medical need. Uses Loa heuristics plus AI and is not authoritative or diagnostic. Use only when the user cannot name the procedure, then confirm candidates with search_cpt_codes before pricing them. Requires signing in to Loa; without sign-in, use search_cpt_codes with consumer phrases instead.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"description": "Natural language description of the medical need (e.g. \"I have a rash on my arm\", \"need imaging for my lower back pain\")"
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"specialty_browse",
"imaging_browse",
"search_results"
]
},
"interpretation": {
"type": "string"
},
"needsConfirmationWith": {
"type": "string",
"const": "search_cpt_codes"
},
"provenance": {
"type": "object",
"properties": {
"authority": {
"type": "string",
"enum": [
"authoritative",
"advisory",
"estimate"
]
},
"basis": {
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"additionalProperties": false
},
"suggestedCodes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"friendlyName": {
"type": "string"
},
"technicalName": {
"type": "string"
},
"whyRelevant": {
"type": "string"
},
"relevance": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
}
},
"required": [
"code",
"friendlyName",
"technicalName",
"whyRelevant",
"relevance"
],
"additionalProperties": false
}
}
},
"required": [
"type",
"interpretation",
"needsConfirmationWith",
"provenance",
"suggestedCodes"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢search_providers(specialty, location, name, limit)
Search public CMS NPI Registry data for clinicians and healthcare organizations by specialty, name, or location. Use returned provenance to understand the registry source and scope. Use this for provider lookup, not pricing.
Eingabe-Schema
{
"type": "object",
"properties": {
"specialty": {
"description": "Medical specialty (e.g. \"Cardiology\", \"Family Medicine\")",
"type": "string"
},
"location": {
"description": "Location to search in",
"type": "object",
"properties": {
"city": {
"description": "City name",
"type": "string"
},
"state": {
"description": "State code or full name (e.g. \"CA\", \"California\")",
"type": "string"
},
"zip_code": {
"description": "ZIP code",
"type": "string"
}
}
},
"name": {
"description": "Provider name to search for (e.g. \"John Smith\")",
"type": "string"
},
"limit": {
"description": "Max results (default 20)",
"default": 20,
"type": "number",
"minimum": 1,
"maximum": 50
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "object",
"properties": {
"specialty": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"location": {
"type": "object",
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zip_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"city",
"state",
"zip_code"
],
"additionalProperties": false
}
},
"required": [
"specialty",
"name",
"location"
],
"additionalProperties": false
},
"providers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"npi": {
"type": "string"
},
"name": {
"type": "string"
},
"specialty": {
"type": "string"
},
"address": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"zip_code": {
"type": "string"
},
"phone": {
"type": "string"
},
"loa_link": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"action": {
"type": "string",
"enum": [
"book",
"website",
"profile"
]
},
"label": {
"type": "string"
}
},
"required": [
"url",
"action",
"label"
],
"additionalProperties": false,
"description": "Tracked Loa link. Share it when the user wants to book, contact, or learn more about this provider or hospital."
},
{
"type": "null"
}
]
}
},
"required": [
"npi",
"name",
"specialty",
"address",
"city",
"state",
"zip_code",
"phone",
"loa_link"
],
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"provenance": {
"type": "object",
"properties": {
"authority": {
"type": "string",
"enum": [
"authoritative",
"advisory",
"estimate"
]
},
"basis": {
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"additionalProperties": false
}
},
"required": [
"query",
"providers",
"total",
"provenance"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_pricing_estimate(procedure_codes, zip_code)
Quick cash-price ballpark for one or more CPT codes, using the median cash price across hospitals in the state (from zip_code) or nationally. priceRange is the typical range (25th to 75th percentile of hospitals). Codes without enough data return insufficient_data and are listed in missingCodes; the total is null unless every code has data. Never fill gaps with your own estimate. For insurer rates or hospital-specific prices, use get_market_pricing or get_hospital_pricing.
Eingabe-Schema
{
"type": "object",
"properties": {
"procedure_codes": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string"
},
"description": "CPT procedure codes to price (e.g. [\"99213\", \"85025\"])"
},
"zip_code": {
"description": "ZIP code used to pick the state (omit for national figures)",
"type": "string"
}
},
"required": [
"procedure_codes"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"estimatedCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"procedures": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"description": {
"type": "string"
},
"estimatedCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"priceRange": {
"anyOf": [
{
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
}
},
"required": [
"min",
"max"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"pricingMethod": {
"type": "string",
"enum": [
"observed_market_median",
"insufficient_data"
]
},
"scope": {
"anyOf": [
{
"type": "string",
"enum": [
"state",
"national"
]
},
{
"type": "null"
}
]
},
"data_points": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"hospital_count": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"code",
"description",
"estimatedCost",
"priceRange",
"pricingMethod",
"scope",
"data_points",
"hospital_count"
],
"additionalProperties": false
}
},
"zipCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"missingCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"authority": {
"type": "string",
"enum": [
"authoritative",
"advisory",
"estimate"
]
},
"basis": {
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"additionalProperties": false
},
"disclaimer": {
"type": "string"
}
},
"required": [
"estimatedCost",
"procedures",
"zipCode",
"state",
"missingCodes",
"limitations",
"provenance",
"disclaimer"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_market_pricing(cpt_codes, state, zip_code)
Preferred benchmark pricing tool. Returns hospital-level market statistics for CPT codes from Loa's published hospital price-transparency data: cash/self-pay prices, list prices (gross charges before discounts), overall insurer-negotiated rates, and rates for the most common insurers. Each hospital counts once. Lead with the median and the p25-p75 range rather than min or max. Figures are statewide or national, never local to a ZIP code. When status is insufficient_data, say Loa doesn't have enough data instead of estimating, and always relay the limitations. Negotiated rates are not out-of-pocket costs.
Eingabe-Schema
{
"type": "object",
"properties": {
"cpt_codes": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string"
},
"description": "CPT codes to look up (e.g. [\"99213\", \"93000\"])"
},
"state": {
"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.",
"type": "string"
},
"zip_code": {
"description": "ZIP code, used only to pick the state when state is omitted",
"type": "string"
}
},
"required": [
"cpt_codes"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"pricing": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cpt_code": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"ok",
"insufficient_data"
]
},
"scope": {
"anyOf": [
{
"type": "string",
"enum": [
"state",
"national"
]
},
{
"type": "null"
}
]
},
"cash_price": {
"anyOf": [
{
"type": "object",
"properties": {
"median": {
"type": "number"
},
"average": {
"type": "number"
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"p25": {
"type": "number"
},
"p75": {
"type": "number"
},
"data_points": {
"type": "number",
"description": "Price records behind this figure"
},
"hospital_count": {
"type": "number",
"description": "Hospitals behind this figure; each counts once"
},
"source": {
"type": "string",
"enum": [
"state",
"national"
]
}
},
"required": [
"median",
"average",
"min",
"max",
"p25",
"p75",
"data_points",
"hospital_count",
"source"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"list_price": {
"anyOf": [
{
"type": "object",
"properties": {
"median": {
"type": "number"
},
"average": {
"type": "number"
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"p25": {
"type": "number"
},
"p75": {
"type": "number"
},
"data_points": {
"type": "number",
"description": "Price records behind this figure"
},
"hospital_count": {
"type": "number",
"description": "Hospitals behind this figure; each counts once"
},
"source": {
"type": "string",
"enum": [
"state",
"national"
]
}
},
"required": [
"median",
"average",
"min",
"max",
"p25",
"p75",
"data_points",
"hospital_count",
"source"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"insurance_price": {
"anyOf": [
{
"type": "object",
"properties": {
"median": {
"type": "number"
},
"average": {
"type": "number"
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"p25": {
"type": "number"
},
"p75": {
"type": "number"
},
"data_points": {
"type": "number",
"description": "Price records behind this figure"
},
"hospital_count": {
"type": "number",
"description": "Hospitals behind this figure; each counts once"
},
"source": {
"type": "string",
"enum": [
"state",
"national"
]
}
},
"required": [
"median",
"average",
"min",
"max",
"p25",
"p75",
"data_points",
"hospital_count",
"source"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"insurance_by_payer": {
"type": "array",
"items": {
"type": "object",
"properties": {
"payer": {
"type": "string"
},
"median": {
"type": "number"
},
"p25": {
"type": "number"
},
"p75": {
"type": "number"
},
"data_points": {
"type": "number"
},
"hospital_count": {
"type": "number"
}
},
"required": [
"payer",
"median",
"p25",
"p75",
"data_points",
"hospital_count"
],
"additionalProperties": false
}
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"cash_data_points": {
"type": "number"
},
"insurance_data_points": {
"type": "number"
},
"states_covered": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"source_dates": {
"anyOf": [
{
"type": "object",
"properties": {
"earliest": {
"type": "string"
},
"latest": {
"type": "string"
}
},
"required": [
"earliest",
"latest"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Extraction dates of the underlying hospital files (YYYY-MM-DD)"
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"cpt_code",
"status",
"scope",
"cash_price",
"list_price",
"insurance_price",
"insurance_by_payer",
"confidence",
"cash_data_points",
"insurance_data_points",
"states_covered",
"source_dates",
"limitations"
],
"additionalProperties": false
}
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provenance": {
"type": "object",
"properties": {
"authority": {
"type": "string",
"enum": [
"authoritative",
"advisory",
"estimate"
]
},
"basis": {
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"additionalProperties": false
}
},
"required": [
"pricing",
"state",
"provenance"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢search_hospitals(state, city, zip_code, name, limit)
Search Loa's hospital directory by name or location and return hospital IDs plus address details. Use the returned hospital_ids with get_hospital_pricing to fetch source-labeled Published MRF and reviewed overlay prices.
Eingabe-Schema
{
"type": "object",
"properties": {
"state": {
"description": "Two-letter state code or full state name, e.g. \"CA\" or \"New York\".",
"type": "string"
},
"city": {
"description": "City name",
"type": "string"
},
"zip_code": {
"description": "ZIP code",
"type": "string"
},
"name": {
"description": "Hospital name to search for",
"type": "string"
},
"limit": {
"description": "Max results (default 20)",
"default": 20,
"type": "number",
"minimum": 1,
"maximum": 50
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "object",
"properties": {
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zip_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"state",
"city",
"zip_code",
"name"
],
"additionalProperties": false
},
"hospitals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"hospital_id": {
"type": "string"
},
"name": {
"type": "string"
},
"address": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"zip_code": {
"type": "string"
},
"phone": {
"type": "string"
},
"website": {
"type": "string"
},
"loa_link": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"action": {
"type": "string",
"enum": [
"book",
"website",
"profile"
]
},
"label": {
"type": "string"
}
},
"required": [
"url",
"action",
"label"
],
"additionalProperties": false,
"description": "Tracked Loa link. Share it when the user wants to book, contact, or learn more about this provider or hospital."
},
{
"type": "null"
}
]
}
},
"required": [
"hospital_id",
"name",
"address",
"city",
"state",
"zip_code",
"phone",
"website",
"loa_link"
],
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"provenance": {
"type": "object",
"properties": {
"authority": {
"type": "string",
"enum": [
"authoritative",
"advisory",
"estimate"
]
},
"basis": {
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"additionalProperties": false
}
},
"required": [
"query",
"hospitals",
"total",
"provenance"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_hospital_pricing(hospital_ids, cpt_codes)
Hospital-specific pricing tool for source-labeled Loa runtime data. Returns source-labeled Published MRF prices and Loa Verified Provider Price overlays for CPT codes. cash_price is the cash/self-pay price, list_price is the gross charge before discounts (most patients pay less), and insurance_prices are payer-negotiated rates for the named plan, not out-of-pocket costs. Any of these can be null when the hospital did not publish that price. Use this when comparing named hospitals or checking a quoted hospital price against available source rows.
Eingabe-Schema
{
"type": "object",
"properties": {
"hospital_ids": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string"
},
"description": "Hospital IDs from search_hospitals results"
},
"cpt_codes": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string"
},
"description": "CPT procedure codes to look up pricing for"
}
},
"required": [
"hospital_ids",
"cpt_codes"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"pricing": {
"type": "array",
"items": {
"type": "object",
"properties": {
"hospital_id": {
"type": "string"
},
"hospital_name": {
"type": "string"
},
"hospital_location": {
"type": "string"
},
"cpt_code": {
"type": "string"
},
"cpt_description": {
"type": "string"
},
"cash_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"cash_source_labels": {
"type": "array",
"items": {
"type": "string"
}
},
"list_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"insurance_prices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"payer": {
"type": "string"
},
"plan": {
"type": "string"
},
"price": {
"type": "number"
},
"source_label": {
"type": "string"
}
},
"required": [
"payer",
"plan",
"price",
"source_label"
],
"additionalProperties": false
}
},
"source_labels": {
"type": "array",
"items": {
"type": "string"
}
},
"record_count": {
"type": "number"
},
"loa_link": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"action": {
"type": "string",
"enum": [
"book",
"website",
"profile"
]
},
"label": {
"type": "string"
}
},
"required": [
"url",
"action",
"label"
],
"additionalProperties": false,
"description": "Tracked Loa link. Share it when the user wants to book, contact, or learn more about this provider or hospital."
},
{
"type": "null"
}
]
}
},
"required": [
"hospital_id",
"hospital_name",
"hospital_location",
"cpt_code",
"cpt_description",
"cash_price",
"cash_source_labels",
"list_price",
"insurance_prices",
"source_labels",
"record_count",
"loa_link"
],
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"hospitals_found": {
"type": "number"
},
"services_found": {
"type": "number"
},
"provenance": {
"type": "object",
"properties": {
"authority": {
"type": "string",
"enum": [
"authoritative",
"advisory",
"estimate"
]
},
"basis": {
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"additionalProperties": false
}
},
"required": [
"pricing",
"total",
"hospitals_found",
"services_found",
"provenance"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢search_entities(query, entity_type, state, limit)
Search Loa runtime hospital and provider entity pages by name or state. Use this before get_entity_prices when the user names a hospital or provider but does not know the exact Loa slug.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"description": "Hospital or provider name to search for.",
"type": "string"
},
"entity_type": {
"description": "Optional filter for hospital or provider entities.",
"type": "string",
"enum": [
"hospital",
"provider"
]
},
"state": {
"description": "Two-letter state code or full state name, e.g. CA or New York.",
"type": "string"
},
"limit": {
"description": "Maximum number of results, default 20, max 50.",
"default": 20,
"type": "number",
"minimum": 1,
"maximum": 50
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "object",
"properties": {
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"query",
"entity_type",
"state"
],
"additionalProperties": false
},
"total": {
"type": "number"
},
"entities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entity_type": {
"type": "string",
"enum": [
"hospital",
"provider"
]
},
"slug": {
"type": "string"
},
"canonical_name": {
"type": "string"
},
"display_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zip_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data_quality_score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"updated_at": {
"type": "string",
"description": "ISO 8601 timestamp"
},
"loa_link": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"action": {
"type": "string",
"enum": [
"book",
"website",
"profile"
]
},
"label": {
"type": "string"
}
},
"required": [
"url",
"action",
"label"
],
"additionalProperties": false,
"description": "Tracked Loa link. Share it when the user wants to book, contact, or learn more about this provider or hospital."
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"entity_type",
"slug",
"canonical_name",
"display_name",
"city",
"state",
"zip_code",
"data_quality_score",
"updated_at",
"loa_link"
],
"additionalProperties": false
}
},
"provenance": {
"type": "object",
"properties": {
"authority": {
"type": "string",
"enum": [
"authoritative",
"advisory",
"estimate"
]
},
"basis": {
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"additionalProperties": false
}
},
"required": [
"query",
"total",
"entities",
"provenance"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_entity_prices(slug, cpt_codes, limit)
Return source-labeled prices for a Loa hospital or provider entity slug using the shared resolver. Use search_entities first if the slug is unknown. Results include provenance and explicit unavailable rows for requested CPT codes with no current price.
Eingabe-Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"minLength": 1,
"description": "Exact Loa entity slug from search_entities or a Loa SEO page."
},
"cpt_codes": {
"description": "Optional CPT codes to filter. If omitted, returns current indexed prices up to the limit.",
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "string"
}
},
"limit": {
"description": "Maximum number of prices, default 50, max 100.",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 100
}
},
"required": [
"slug"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"entity": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entityType": {
"type": "string",
"enum": [
"hospital",
"provider"
]
},
"slug": {
"type": "string"
},
"canonicalName": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"entityType",
"slug",
"canonicalName",
"city",
"state"
],
"additionalProperties": false
},
"loa_link": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"action": {
"type": "string",
"enum": [
"book",
"website",
"profile"
]
},
"label": {
"type": "string"
}
},
"required": [
"url",
"action",
"label"
],
"additionalProperties": false,
"description": "Tracked Loa link. Share it when the user wants to book, contact, or learn more about this provider or hospital."
},
{
"type": "null"
}
]
},
"prices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"entityPageId": {
"type": "string"
},
"cptCode": {
"type": "string"
},
"codeType": {
"type": "string"
},
"procedureDescription": {
"type": "string"
},
"serviceCategory": {
"type": "string"
},
"priceCents": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"priceKind": {
"type": "string"
},
"label": {
"type": "string"
},
"payerName": {
"type": "string"
},
"planName": {
"type": "string"
},
"setting": {
"type": "string"
},
"billingClass": {
"type": "string"
},
"component": {
"type": "string",
"enum": [
"global",
"professional",
"facility",
"unknown"
]
},
"sourceRowId": {
"type": "string"
},
"basePriceIndexId": {
"type": "string"
},
"overlayRelationship": {
"type": "string"
},
"provenance": {
"type": "object",
"properties": {
"authority": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"sourceLabel": {
"type": "string"
},
"sourceUpdatedAt": {
"type": "string"
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"authority",
"sourceType",
"sourceLabel",
"confidence",
"caveats"
],
"additionalProperties": false
},
"comparableMrfPrice": {
"type": "object",
"properties": {
"entityPageId": {
"type": "string"
},
"cptCode": {
"type": "string"
},
"codeType": {
"type": "string"
},
"procedureDescription": {
"type": "string"
},
"serviceCategory": {
"type": "string"
},
"priceCents": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"priceKind": {
"type": "string"
},
"label": {
"type": "string"
},
"payerName": {
"type": "string"
},
"planName": {
"type": "string"
},
"setting": {
"type": "string"
},
"billingClass": {
"type": "string"
},
"component": {
"type": "string",
"enum": [
"global",
"professional",
"facility",
"unknown"
]
},
"sourceRowId": {
"type": "string"
},
"basePriceIndexId": {
"type": "string"
},
"overlayRelationship": {
"type": "string"
},
"provenance": {
"type": "object",
"properties": {
"authority": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"sourceLabel": {
"type": "string"
},
"sourceUpdatedAt": {
"type": "string"
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"authority",
"sourceType",
"sourceLabel",
"confidence",
"caveats"
],
"additionalProperties": false
}
},
"required": [
"entityPageId",
"cptCode",
"codeType",
"priceCents",
"priceKind",
"label",
"provenance"
],
"additionalProperties": false
}
},
"required": [
"entityPageId",
"cptCode",
"codeType",
"priceCents",
"priceKind",
"label",
"provenance"
],
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"provenance": {
"type": "object",
"properties": {
"authority": {
"type": "string",
"enum": [
"authoritative",
"advisory",
"estimate"
]
},
"basis": {
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"additionalProperties": false
}
},
"required": [
"entity",
"loa_link",
"prices",
"total",
"provenance"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_entity_profile(slug_or_id, entity_type)
Return one Loa hospital or provider entity profile by exact slug or entity_pages.id. Includes profile-field provenance so agents can distinguish source-file fields from Loa-reviewed overrides.
Eingabe-Schema
{
"type": "object",
"properties": {
"slug_or_id": {
"type": "string",
"minLength": 1,
"description": "Exact Loa entity slug or entity_pages.id from search_entities."
},
"entity_type": {
"description": "Optional disambiguation when slug_or_id is a slug.",
"type": "string",
"enum": [
"hospital",
"provider"
]
}
},
"required": [
"slug_or_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"entity": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entityType": {
"type": "string",
"enum": [
"hospital",
"provider"
]
},
"slug": {
"type": "string"
},
"canonicalName": {
"type": "string"
},
"displayName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zipCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"npi": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"ccn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hpfId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"dataQualityScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"updatedAt": {
"type": "string",
"description": "ISO 8601 timestamp"
},
"metadata": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"id",
"entityType",
"slug",
"canonicalName",
"displayName",
"city",
"state",
"zipCode",
"address",
"phone",
"website",
"npi",
"ccn",
"hpfId",
"dataQualityScore",
"updatedAt",
"metadata"
],
"additionalProperties": false
},
"loa_link": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"action": {
"type": "string",
"enum": [
"book",
"website",
"profile"
]
},
"label": {
"type": "string"
}
},
"required": [
"url",
"action",
"label"
],
"additionalProperties": false,
"description": "Tracked Loa link. Share it when the user wants to book, contact, or learn more about this provider or hospital."
},
"profile_provenance": {
"type": "object",
"properties": {
"authority": {
"type": "string"
},
"source_type": {
"type": "string"
},
"source_label": {
"type": "string"
},
"confidence": {
"type": "string"
},
"loa_reviewed_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"authority",
"source_type",
"source_label",
"confidence"
],
"additionalProperties": false
},
"profile_field_provenance": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "object",
"properties": {
"authority": {
"type": "string"
},
"source_type": {
"type": "string"
},
"source_label": {
"type": "string"
},
"confidence": {
"type": "string"
},
"loa_reviewed_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"authority",
"source_type",
"source_label",
"confidence"
],
"additionalProperties": false
}
},
"provenance": {
"type": "object",
"properties": {
"authority": {
"type": "string",
"enum": [
"authoritative",
"advisory",
"estimate"
]
},
"basis": {
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"additionalProperties": false
}
},
"required": [
"entity",
"loa_link",
"profile_provenance",
"profile_field_provenance",
"provenance"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢explain_price_sources(slug, cpt_codes, limit)
Explain the source labels, provenance, confidence, and caveats behind Loa prices for one hospital or provider entity. Use this when an agent needs to tell a user why prices are MRF-published, Loa-reviewed, estimated, or unavailable.
Eingabe-Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"minLength": 1,
"description": "Exact Loa entity slug from search_entities."
},
"cpt_codes": {
"description": "Optional CPT codes to explain. If omitted, explains current indexed prices.",
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "string"
}
},
"limit": {
"description": "Maximum number of prices to inspect, default 50, max 100.",
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 100
}
},
"required": [
"slug"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"entity": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entityType": {
"type": "string",
"enum": [
"hospital",
"provider"
]
},
"slug": {
"type": "string"
},
"canonicalName": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"entityType",
"slug",
"canonicalName",
"city",
"state"
],
"additionalProperties": false
},
"cpt_codes": {
"type": "array",
"items": {
"type": "string"
}
},
"price_count": {
"type": "number"
},
"comparable_mrf_price_count": {
"type": "number"
},
"source_summary": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"authority": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"confidence": {
"type": "string"
},
"count": {
"type": "number"
},
"comparableMrfPriceCount": {
"type": "number"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"label",
"authority",
"sourceType",
"confidence",
"count",
"comparableMrfPriceCount",
"caveats"
],
"additionalProperties": false
}
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"authority": {
"type": "string",
"enum": [
"authoritative",
"advisory",
"estimate"
]
},
"basis": {
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"methodology_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"additionalProperties": false
}
},
"required": [
"entity",
"cpt_codes",
"price_count",
"comparable_mrf_price_count",
"source_summary",
"caveats",
"provenance"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡submit_entity_update_request(entity_page_id, entity_slug, entity_type, submitter_email, submitter_name, ...)
Submit a profile, listing, or price correction for Loa review without requiring a provider portal. This is the only mutating provider/entity tool. It requires OAuth, captures submitter and source evidence, records linked-provider status when available, and never changes public data until Loa approves the request.
Eingabe-Schema
{
"type": "object",
"properties": {
"entity_page_id": {
"description": "Loa entity_pages.id for the provider or hospital.",
"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)$"
},
"entity_slug": {
"description": "Exact Loa entity slug if entity_page_id is not available.",
"type": "string",
"minLength": 1,
"maxLength": 160
},
"entity_type": {
"description": "Entity kind for the requested update; use unknown only when it cannot be determined.",
"default": "unknown",
"type": "string",
"enum": [
"hospital",
"provider",
"unknown"
]
},
"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_name": {
"description": "Name of the person submitting the request.",
"type": "string",
"maxLength": 200
},
"submitter_organization": {
"description": "Provider, hospital, or agent organization represented by the submitter.",
"type": "string",
"maxLength": 300
},
"submitter_role": {
"description": "Submitter role, such as billing manager or authorized agent.",
"type": "string",
"maxLength": 200
},
"submitter_phone": {
"description": "Optional callback phone number for reviewer follow-up.",
"type": "string",
"maxLength": 50
},
"source_urls": {
"description": "Optional public URLs reviewers can use to verify the submitted change.",
"default": [],
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
},
"source_notes": {
"description": "Short verification notes, source context, or callback instructions.",
"type": "string",
"maxLength": 2000
},
"attestation": {
"description": "How the submitter is connected to the submitted evidence.",
"type": "string",
"enum": [
"provider_representative",
"authorized_agent",
"public_source",
"other"
]
},
"request_type": {
"type": "string",
"enum": [
"price_update",
"profile_correction",
"new_listing",
"remove_listing",
"other"
],
"description": "Type of reviewed change being requested."
},
"proposed_changes": {
"description": "Structured profile or listing fields proposed for Loa review.",
"default": {},
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"uploaded_file_url": {
"description": "Optional public URL for an uploaded evidence file.",
"type": "string",
"format": "uri"
},
"idempotency_key": {
"description": "Optional stable retry key. Loa derives one from the payload if omitted.",
"type": "string",
"minLength": 8,
"maxLength": 200
},
"price_items": {
"description": "Optional structured price rows proposed for Loa review.",
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"cpt_code": {
"type": "string",
"minLength": 3,
"maxLength": 20
},
"code_type": {
"default": "CPT",
"type": "string",
"minLength": 1,
"maxLength": 20
},
"service_name": {
"type": "string",
"maxLength": 300
},
"price_kind": {
"default": "cash",
"type": "string",
"enum": [
"cash",
"discounted_cash",
"package_cash",
"payer_negotiated"
]
},
"proposed_price_cents": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"payer_name": {
"type": "string",
"maxLength": 300
},
"plan_name": {
"type": "string",
"maxLength": 300
},
"setting": {
"type": "string",
"maxLength": 100
},
"billing_class": {
"type": "string",
"maxLength": 100
},
"component": {
"default": "unknown",
"type": "string",
"enum": [
"global",
"professional",
"facility",
"unknown"
]
},
"included_services": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
}
},
"exclusions": {
"type": "string",
"maxLength": 1000
},
"price_notes": {
"type": "string",
"maxLength": 1000
}
},
"required": [
"cpt_code"
]
}
}
},
"required": [
"submitter_email",
"request_type"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"updateRequestId": {
"type": "string"
},
"status": {
"type": "string"
},
"entityPageId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reusedExisting": {
"type": "boolean"
}
},
"required": [
"requestId",
"updateRequestId",
"status",
"entityPageId",
"reusedExisting"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Community
Nachweis
Aktuelle Beobachtungen
verifiziertVersion nicht aufgezeichnet12 Tools
verifiziertVersion nicht aufgezeichnet12 Tools
verifiziertVersion nicht aufgezeichnet12 Tools