Server definition
- Hash
- sha256:e92fa3ffab64615c5bd868fc3e845109af54f5adfeaedf2e09e23e22b36aa58e
- What it is
- What a remote MCP server returned when asked what it offers: 12 tools
The blob, as servednamed by its sha256
{
"instructions": "Loa is a U.S. healthcare pricing and provider lookup server for source-labeled Loa data. Use returned data, provenance, source labels, scope, caveats, and estimate flags instead of model priors for CPT code lookup, hospital-specific prices, market pricing, and provider lookup. Do not invent codes, prices, or provider details when Loa returns none. All data is public and non-PHI except submit_entity_update_request, which creates a reviewed provider/entity update request for an authenticated submitter. It captures provider contact and source evidence, records linked-provider status when available, and requires Loa approval before public data changes. The suggest_procedures tool is advisory only and should be followed by code search or pricing lookup. When the user wants to book, contact, or learn more about a hospital or provider, share that result's loa_link.url using loa_link.label as the link text; do not construct other booking URLs. Also share the phone number when one is returned.",
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cpt_codes": {
"description": "Optional CPT codes to explain. If omitted, explains current indexed prices.",
"items": {
"type": "string"
},
"maxItems": 25,
"minItems": 1,
"type": "array"
},
"limit": {
"default": 50,
"description": "Maximum number of prices to inspect, default 50, max 100.",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"slug": {
"description": "Exact Loa entity slug from search_entities.",
"minLength": 1,
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "explain_price_sources",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"comparable_mrf_price_count": {
"type": "number"
},
"cpt_codes": {
"items": {
"type": "string"
},
"type": "array"
},
"entity": {
"additionalProperties": false,
"properties": {
"canonicalName": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entityType": {
"enum": [
"hospital",
"provider"
],
"type": "string"
},
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"entityType",
"slug",
"canonicalName",
"city",
"state"
],
"type": "object"
},
"price_count": {
"type": "number"
},
"provenance": {
"additionalProperties": false,
"properties": {
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"basis": {
"type": "string"
},
"methodology_url": {
"format": "uri",
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"type": "object"
},
"source_summary": {
"items": {
"additionalProperties": false,
"properties": {
"authority": {
"type": "string"
},
"caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"comparableMrfPriceCount": {
"type": "number"
},
"confidence": {
"type": "string"
},
"count": {
"type": "number"
},
"label": {
"type": "string"
},
"sourceType": {
"type": "string"
}
},
"required": [
"label",
"authority",
"sourceType",
"confidence",
"count",
"comparableMrfPriceCount",
"caveats"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"entity",
"cpt_codes",
"price_count",
"comparable_mrf_price_count",
"source_summary",
"caveats",
"provenance"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cpt_codes": {
"description": "Optional CPT codes to filter. If omitted, returns current indexed prices up to the limit.",
"items": {
"type": "string"
},
"maxItems": 25,
"minItems": 1,
"type": "array"
},
"limit": {
"default": 50,
"description": "Maximum number of prices, default 50, max 100.",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"slug": {
"description": "Exact Loa entity slug from search_entities or a Loa SEO page.",
"minLength": 1,
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "get_entity_prices",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"entity": {
"additionalProperties": false,
"properties": {
"canonicalName": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entityType": {
"enum": [
"hospital",
"provider"
],
"type": "string"
},
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"entityType",
"slug",
"canonicalName",
"city",
"state"
],
"type": "object"
},
"loa_link": {
"anyOf": [
{
"additionalProperties": false,
"description": "Tracked Loa link. Share it when the user wants to book, contact, or learn more about this provider or hospital.",
"properties": {
"action": {
"enum": [
"book",
"website",
"profile"
],
"type": "string"
},
"label": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"action",
"label"
],
"type": "object"
},
{
"type": "null"
}
]
},
"prices": {
"items": {
"additionalProperties": false,
"properties": {
"basePriceIndexId": {
"type": "string"
},
"billingClass": {
"type": "string"
},
"codeType": {
"type": "string"
},
"comparableMrfPrice": {
"additionalProperties": false,
"properties": {
"basePriceIndexId": {
"type": "string"
},
"billingClass": {
"type": "string"
},
"codeType": {
"type": "string"
},
"component": {
"enum": [
"global",
"professional",
"facility",
"unknown"
],
"type": "string"
},
"cptCode": {
"type": "string"
},
"entityPageId": {
"type": "string"
},
"label": {
"type": "string"
},
"overlayRelationship": {
"type": "string"
},
"payerName": {
"type": "string"
},
"planName": {
"type": "string"
},
"priceCents": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"priceKind": {
"type": "string"
},
"procedureDescription": {
"type": "string"
},
"provenance": {
"additionalProperties": false,
"properties": {
"authority": {
"type": "string"
},
"caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"confidence": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"sourceLabel": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"sourceUpdatedAt": {
"type": "string"
}
},
"required": [
"authority",
"sourceType",
"sourceLabel",
"confidence",
"caveats"
],
"type": "object"
},
"serviceCategory": {
"type": "string"
},
"setting": {
"type": "string"
},
"sourceRowId": {
"type": "string"
}
},
"required": [
"entityPageId",
"cptCode",
"codeType",
"priceCents",
"priceKind",
"label",
"provenance"
],
"type": "object"
},
"component": {
"enum": [
"global",
"professional",
"facility",
"unknown"
],
"type": "string"
},
"cptCode": {
"type": "string"
},
"entityPageId": {
"type": "string"
},
"label": {
"type": "string"
},
"overlayRelationship": {
"type": "string"
},
"payerName": {
"type": "string"
},
"planName": {
"type": "string"
},
"priceCents": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"priceKind": {
"type": "string"
},
"procedureDescription": {
"type": "string"
},
"provenance": {
"additionalProperties": false,
"properties": {
"authority": {
"type": "string"
},
"caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"confidence": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"sourceLabel": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"sourceUpdatedAt": {
"type": "string"
}
},
"required": [
"authority",
"sourceType",
"sourceLabel",
"confidence",
"caveats"
],
"type": "object"
},
"serviceCategory": {
"type": "string"
},
"setting": {
"type": "string"
},
"sourceRowId": {
"type": "string"
}
},
"required": [
"entityPageId",
"cptCode",
"codeType",
"priceCents",
"priceKind",
"label",
"provenance"
],
"type": "object"
},
"type": "array"
},
"provenance": {
"additionalProperties": false,
"properties": {
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"basis": {
"type": "string"
},
"methodology_url": {
"format": "uri",
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"type": "object"
},
"total": {
"type": "number"
}
},
"required": [
"entity",
"loa_link",
"prices",
"total",
"provenance"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"entity_type": {
"description": "Optional disambiguation when slug_or_id is a slug.",
"enum": [
"hospital",
"provider"
],
"type": "string"
},
"slug_or_id": {
"description": "Exact Loa entity slug or entity_pages.id from search_entities.",
"minLength": 1,
"type": "string"
}
},
"required": [
"slug_or_id"
],
"type": "object"
},
"name": "get_entity_profile",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"entity": {
"additionalProperties": false,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"canonicalName": {
"type": "string"
},
"ccn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"dataQualityScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"displayName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entityType": {
"enum": [
"hospital",
"provider"
],
"type": "string"
},
"hpfId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"type": "string"
},
"metadata": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"npi": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"type": "string"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"updatedAt": {
"description": "ISO 8601 timestamp",
"type": "string"
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zipCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"entityType",
"slug",
"canonicalName",
"displayName",
"city",
"state",
"zipCode",
"address",
"phone",
"website",
"npi",
"ccn",
"hpfId",
"dataQualityScore",
"updatedAt",
"metadata"
],
"type": "object"
},
"loa_link": {
"additionalProperties": false,
"description": "Tracked Loa link. Share it when the user wants to book, contact, or learn more about this provider or hospital.",
"properties": {
"action": {
"enum": [
"book",
"website",
"profile"
],
"type": "string"
},
"label": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"action",
"label"
],
"type": "object"
},
"profile_field_provenance": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"authority": {
"type": "string"
},
"confidence": {
"type": "string"
},
"loa_reviewed_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source_label": {
"type": "string"
},
"source_type": {
"type": "string"
}
},
"required": [
"authority",
"source_type",
"source_label",
"confidence"
],
"type": "object"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"profile_provenance": {
"additionalProperties": false,
"properties": {
"authority": {
"type": "string"
},
"confidence": {
"type": "string"
},
"loa_reviewed_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source_label": {
"type": "string"
},
"source_type": {
"type": "string"
}
},
"required": [
"authority",
"source_type",
"source_label",
"confidence"
],
"type": "object"
},
"provenance": {
"additionalProperties": false,
"properties": {
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"basis": {
"type": "string"
},
"methodology_url": {
"format": "uri",
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"type": "object"
}
},
"required": [
"entity",
"loa_link",
"profile_provenance",
"profile_field_provenance",
"provenance"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cpt_codes": {
"description": "CPT procedure codes to look up pricing for",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"hospital_ids": {
"description": "Hospital IDs from search_hospitals results",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
}
},
"required": [
"hospital_ids",
"cpt_codes"
],
"type": "object"
},
"name": "get_hospital_pricing",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"hospitals_found": {
"type": "number"
},
"pricing": {
"items": {
"additionalProperties": false,
"properties": {
"cash_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"cash_source_labels": {
"items": {
"type": "string"
},
"type": "array"
},
"cpt_code": {
"type": "string"
},
"cpt_description": {
"type": "string"
},
"hospital_id": {
"type": "string"
},
"hospital_location": {
"type": "string"
},
"hospital_name": {
"type": "string"
},
"insurance_prices": {
"items": {
"additionalProperties": false,
"properties": {
"payer": {
"type": "string"
},
"plan": {
"type": "string"
},
"price": {
"type": "number"
},
"source_label": {
"type": "string"
}
},
"required": [
"payer",
"plan",
"price",
"source_label"
],
"type": "object"
},
"type": "array"
},
"list_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"loa_link": {
"anyOf": [
{
"additionalProperties": false,
"description": "Tracked Loa link. Share it when the user wants to book, contact, or learn more about this provider or hospital.",
"properties": {
"action": {
"enum": [
"book",
"website",
"profile"
],
"type": "string"
},
"label": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"action",
"label"
],
"type": "object"
},
{
"type": "null"
}
]
},
"record_count": {
"type": "number"
},
"source_labels": {
"items": {
"type": "string"
},
"type": "array"
}
},
"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"
],
"type": "object"
},
"type": "array"
},
"provenance": {
"additionalProperties": false,
"properties": {
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"basis": {
"type": "string"
},
"methodology_url": {
"format": "uri",
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"type": "object"
},
"services_found": {
"type": "number"
},
"total": {
"type": "number"
}
},
"required": [
"pricing",
"total",
"hospitals_found",
"services_found",
"provenance"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cpt_codes": {
"description": "CPT codes to look up (e.g. [\"99213\", \"93000\"])",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"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"
],
"type": "object"
},
"name": "get_market_pricing",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"pricing": {
"items": {
"additionalProperties": false,
"properties": {
"cash_data_points": {
"type": "number"
},
"cash_price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"average": {
"type": "number"
},
"data_points": {
"description": "Price records behind this figure",
"type": "number"
},
"hospital_count": {
"description": "Hospitals behind this figure; each counts once",
"type": "number"
},
"max": {
"type": "number"
},
"median": {
"type": "number"
},
"min": {
"type": "number"
},
"p25": {
"type": "number"
},
"p75": {
"type": "number"
},
"source": {
"enum": [
"state",
"national"
],
"type": "string"
}
},
"required": [
"median",
"average",
"min",
"max",
"p25",
"p75",
"data_points",
"hospital_count",
"source"
],
"type": "object"
},
{
"type": "null"
}
]
},
"confidence": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"cpt_code": {
"type": "string"
},
"insurance_by_payer": {
"items": {
"additionalProperties": false,
"properties": {
"data_points": {
"type": "number"
},
"hospital_count": {
"type": "number"
},
"median": {
"type": "number"
},
"p25": {
"type": "number"
},
"p75": {
"type": "number"
},
"payer": {
"type": "string"
}
},
"required": [
"payer",
"median",
"p25",
"p75",
"data_points",
"hospital_count"
],
"type": "object"
},
"type": "array"
},
"insurance_data_points": {
"type": "number"
},
"insurance_price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"average": {
"type": "number"
},
"data_points": {
"description": "Price records behind this figure",
"type": "number"
},
"hospital_count": {
"description": "Hospitals behind this figure; each counts once",
"type": "number"
},
"max": {
"type": "number"
},
"median": {
"type": "number"
},
"min": {
"type": "number"
},
"p25": {
"type": "number"
},
"p75": {
"type": "number"
},
"source": {
"enum": [
"state",
"national"
],
"type": "string"
}
},
"required": [
"median",
"average",
"min",
"max",
"p25",
"p75",
"data_points",
"hospital_count",
"source"
],
"type": "object"
},
{
"type": "null"
}
]
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"list_price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"average": {
"type": "number"
},
"data_points": {
"description": "Price records behind this figure",
"type": "number"
},
"hospital_count": {
"description": "Hospitals behind this figure; each counts once",
"type": "number"
},
"max": {
"type": "number"
},
"median": {
"type": "number"
},
"min": {
"type": "number"
},
"p25": {
"type": "number"
},
"p75": {
"type": "number"
},
"source": {
"enum": [
"state",
"national"
],
"type": "string"
}
},
"required": [
"median",
"average",
"min",
"max",
"p25",
"p75",
"data_points",
"hospital_count",
"source"
],
"type": "object"
},
{
"type": "null"
}
]
},
"scope": {
"anyOf": [
{
"enum": [
"state",
"national"
],
"type": "string"
},
{
"type": "null"
}
]
},
"source_dates": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"earliest": {
"type": "string"
},
"latest": {
"type": "string"
}
},
"required": [
"earliest",
"latest"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Extraction dates of the underlying hospital files (YYYY-MM-DD)"
},
"states_covered": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"ok",
"insufficient_data"
],
"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"
],
"type": "object"
},
"type": "array"
},
"provenance": {
"additionalProperties": false,
"properties": {
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"basis": {
"type": "string"
},
"methodology_url": {
"format": "uri",
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"type": "object"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"pricing",
"state",
"provenance"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"procedure_codes": {
"description": "CPT procedure codes to price (e.g. [\"99213\", \"85025\"])",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"zip_code": {
"description": "ZIP code used to pick the state (omit for national figures)",
"type": "string"
}
},
"required": [
"procedure_codes"
],
"type": "object"
},
"name": "get_pricing_estimate",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"disclaimer": {
"type": "string"
},
"estimatedCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"missingCodes": {
"items": {
"type": "string"
},
"type": "array"
},
"procedures": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"data_points": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"description": {
"type": "string"
},
"estimatedCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"hospital_count": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"priceRange": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"required": [
"min",
"max"
],
"type": "object"
},
{
"type": "null"
}
]
},
"pricingMethod": {
"enum": [
"observed_market_median",
"insufficient_data"
],
"type": "string"
},
"scope": {
"anyOf": [
{
"enum": [
"state",
"national"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"code",
"description",
"estimatedCost",
"priceRange",
"pricingMethod",
"scope",
"data_points",
"hospital_count"
],
"type": "object"
},
"type": "array"
},
"provenance": {
"additionalProperties": false,
"properties": {
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"basis": {
"type": "string"
},
"methodology_url": {
"format": "uri",
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"type": "object"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zipCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"estimatedCost",
"procedures",
"zipCode",
"state",
"missingCodes",
"limitations",
"provenance",
"disclaimer"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"category": {
"description": "Filter by category: \"evaluation_management\", \"laboratory\", \"radiology\", \"surgery\", \"preventive\"",
"type": "string"
},
"limit": {
"default": 10,
"description": "Maximum number of results (default 10, max 25)",
"maximum": 25,
"minimum": 1,
"type": "number"
},
"query": {
"description": "Search query, procedure name, medical term, or CPT code number (e.g. \"knee MRI\", \"blood work\", \"99213\")",
"type": "string"
},
"specialty": {
"description": "Filter by medical specialty (e.g. \"cardiology\", \"dermatology\")",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_cpt_codes",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provenance": {
"additionalProperties": false,
"properties": {
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"basis": {
"type": "string"
},
"methodology_url": {
"format": "uri",
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"type": "object"
},
"query": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"category": {
"type": "string"
},
"code": {
"type": "string"
},
"description": {
"type": "string"
},
"isCommon": {
"type": "boolean"
},
"name": {
"type": "string"
}
},
"required": [
"code",
"name",
"description",
"category",
"isCommon"
],
"type": "object"
},
"type": "array"
},
"specialty": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"total": {
"type": "number"
}
},
"required": [
"query",
"specialty",
"category",
"total",
"provenance",
"results"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"entity_type": {
"description": "Optional filter for hospital or provider entities.",
"enum": [
"hospital",
"provider"
],
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum number of results, default 20, max 50.",
"maximum": 50,
"minimum": 1,
"type": "number"
},
"query": {
"description": "Hospital or provider name to search for.",
"type": "string"
},
"state": {
"description": "Two-letter state code or full state name, e.g. CA or New York.",
"type": "string"
}
},
"type": "object"
},
"name": "search_entities",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"entities": {
"items": {
"additionalProperties": false,
"properties": {
"canonical_name": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data_quality_score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"display_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type": {
"enum": [
"hospital",
"provider"
],
"type": "string"
},
"id": {
"type": "string"
},
"loa_link": {
"anyOf": [
{
"additionalProperties": false,
"description": "Tracked Loa link. Share it when the user wants to book, contact, or learn more about this provider or hospital.",
"properties": {
"action": {
"enum": [
"book",
"website",
"profile"
],
"type": "string"
},
"label": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"action",
"label"
],
"type": "object"
},
{
"type": "null"
}
]
},
"slug": {
"type": "string"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"updated_at": {
"description": "ISO 8601 timestamp",
"type": "string"
},
"zip_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"entity_type",
"slug",
"canonical_name",
"display_name",
"city",
"state",
"zip_code",
"data_quality_score",
"updated_at",
"loa_link"
],
"type": "object"
},
"type": "array"
},
"provenance": {
"additionalProperties": false,
"properties": {
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"basis": {
"type": "string"
},
"methodology_url": {
"format": "uri",
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"type": "object"
},
"query": {
"additionalProperties": false,
"properties": {
"entity_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"query",
"entity_type",
"state"
],
"type": "object"
},
"total": {
"type": "number"
}
},
"required": [
"query",
"total",
"entities",
"provenance"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"city": {
"description": "City name",
"type": "string"
},
"limit": {
"default": 20,
"description": "Max results (default 20)",
"maximum": 50,
"minimum": 1,
"type": "number"
},
"name": {
"description": "Hospital name to search for",
"type": "string"
},
"state": {
"description": "Two-letter state code or full state name, e.g. \"CA\" or \"New York\".",
"type": "string"
},
"zip_code": {
"description": "ZIP code",
"type": "string"
}
},
"type": "object"
},
"name": "search_hospitals",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"hospitals": {
"items": {
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"city": {
"type": "string"
},
"hospital_id": {
"type": "string"
},
"loa_link": {
"anyOf": [
{
"additionalProperties": false,
"description": "Tracked Loa link. Share it when the user wants to book, contact, or learn more about this provider or hospital.",
"properties": {
"action": {
"enum": [
"book",
"website",
"profile"
],
"type": "string"
},
"label": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"action",
"label"
],
"type": "object"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"phone": {
"type": "string"
},
"state": {
"type": "string"
},
"website": {
"type": "string"
},
"zip_code": {
"type": "string"
}
},
"required": [
"hospital_id",
"name",
"address",
"city",
"state",
"zip_code",
"phone",
"website",
"loa_link"
],
"type": "object"
},
"type": "array"
},
"provenance": {
"additionalProperties": false,
"properties": {
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"basis": {
"type": "string"
},
"methodology_url": {
"format": "uri",
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"type": "object"
},
"query": {
"additionalProperties": false,
"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"
}
]
}
},
"required": [
"state",
"city",
"zip_code",
"name"
],
"type": "object"
},
"total": {
"type": "number"
}
},
"required": [
"query",
"hospitals",
"total",
"provenance"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"default": 20,
"description": "Max results (default 20)",
"maximum": 50,
"minimum": 1,
"type": "number"
},
"location": {
"description": "Location to search in",
"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"
}
},
"type": "object"
},
"name": {
"description": "Provider name to search for (e.g. \"John Smith\")",
"type": "string"
},
"specialty": {
"description": "Medical specialty (e.g. \"Cardiology\", \"Family Medicine\")",
"type": "string"
}
},
"type": "object"
},
"name": "search_providers",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"provenance": {
"additionalProperties": false,
"properties": {
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"basis": {
"type": "string"
},
"methodology_url": {
"format": "uri",
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"type": "object"
},
"providers": {
"items": {
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"city": {
"type": "string"
},
"loa_link": {
"anyOf": [
{
"additionalProperties": false,
"description": "Tracked Loa link. Share it when the user wants to book, contact, or learn more about this provider or hospital.",
"properties": {
"action": {
"enum": [
"book",
"website",
"profile"
],
"type": "string"
},
"label": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"action",
"label"
],
"type": "object"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"npi": {
"type": "string"
},
"phone": {
"type": "string"
},
"specialty": {
"type": "string"
},
"state": {
"type": "string"
},
"zip_code": {
"type": "string"
}
},
"required": [
"npi",
"name",
"specialty",
"address",
"city",
"state",
"zip_code",
"phone",
"loa_link"
],
"type": "object"
},
"type": "array"
},
"query": {
"additionalProperties": false,
"properties": {
"location": {
"additionalProperties": false,
"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"
],
"type": "object"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"specialty": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"specialty",
"name",
"location"
],
"type": "object"
},
"total": {
"type": "number"
}
},
"required": [
"query",
"providers",
"total",
"provenance"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"attestation": {
"description": "How the submitter is connected to the submitted evidence.",
"enum": [
"provider_representative",
"authorized_agent",
"public_source",
"other"
],
"type": "string"
},
"entity_page_id": {
"description": "Loa entity_pages.id for the provider or hospital.",
"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)$",
"type": "string"
},
"entity_slug": {
"description": "Exact Loa entity slug if entity_page_id is not available.",
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"entity_type": {
"default": "unknown",
"description": "Entity kind for the requested update; use unknown only when it cannot be determined.",
"enum": [
"hospital",
"provider",
"unknown"
],
"type": "string"
},
"idempotency_key": {
"description": "Optional stable retry key. Loa derives one from the payload if omitted.",
"maxLength": 200,
"minLength": 8,
"type": "string"
},
"price_items": {
"default": [],
"description": "Optional structured price rows proposed for Loa review.",
"items": {
"properties": {
"billing_class": {
"maxLength": 100,
"type": "string"
},
"code_type": {
"default": "CPT",
"maxLength": 20,
"minLength": 1,
"type": "string"
},
"component": {
"default": "unknown",
"enum": [
"global",
"professional",
"facility",
"unknown"
],
"type": "string"
},
"cpt_code": {
"maxLength": 20,
"minLength": 3,
"type": "string"
},
"exclusions": {
"maxLength": 1000,
"type": "string"
},
"included_services": {
"items": {
"maxLength": 300,
"type": "string"
},
"type": "array"
},
"payer_name": {
"maxLength": 300,
"type": "string"
},
"plan_name": {
"maxLength": 300,
"type": "string"
},
"price_kind": {
"default": "cash",
"enum": [
"cash",
"discounted_cash",
"package_cash",
"payer_negotiated"
],
"type": "string"
},
"price_notes": {
"maxLength": 1000,
"type": "string"
},
"proposed_price_cents": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"service_name": {
"maxLength": 300,
"type": "string"
},
"setting": {
"maxLength": 100,
"type": "string"
}
},
"required": [
"cpt_code"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"proposed_changes": {
"additionalProperties": {},
"default": {},
"description": "Structured profile or listing fields proposed for Loa review.",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"request_type": {
"description": "Type of reviewed change being requested.",
"enum": [
"price_update",
"profile_correction",
"new_listing",
"remove_listing",
"other"
],
"type": "string"
},
"source_notes": {
"description": "Short verification notes, source context, or callback instructions.",
"maxLength": 2000,
"type": "string"
},
"source_urls": {
"default": [],
"description": "Optional public URLs reviewers can use to verify the submitted change.",
"items": {
"format": "uri",
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"submitter_email": {
"description": "Work email for the submitting representative.",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"type": "string"
},
"submitter_name": {
"description": "Name of the person submitting the request.",
"maxLength": 200,
"type": "string"
},
"submitter_organization": {
"description": "Provider, hospital, or agent organization represented by the submitter.",
"maxLength": 300,
"type": "string"
},
"submitter_phone": {
"description": "Optional callback phone number for reviewer follow-up.",
"maxLength": 50,
"type": "string"
},
"submitter_role": {
"description": "Submitter role, such as billing manager or authorized agent.",
"maxLength": 200,
"type": "string"
},
"uploaded_file_url": {
"description": "Optional public URL for an uploaded evidence file.",
"format": "uri",
"type": "string"
}
},
"required": [
"submitter_email",
"request_type"
],
"type": "object"
},
"name": "submit_entity_update_request",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"entityPageId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"requestId": {
"type": "string"
},
"reusedExisting": {
"type": "boolean"
},
"status": {
"type": "string"
},
"updateRequestId": {
"type": "string"
}
},
"required": [
"requestId",
"updateRequestId",
"status",
"entityPageId",
"reusedExisting"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"description": "Natural language description of the medical need (e.g. \"I have a rash on my arm\", \"need imaging for my lower back pain\")",
"minLength": 2,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "suggest_procedures",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"interpretation": {
"type": "string"
},
"needsConfirmationWith": {
"const": "search_cpt_codes",
"type": "string"
},
"provenance": {
"additionalProperties": false,
"properties": {
"authority": {
"enum": [
"authoritative",
"advisory",
"estimate"
],
"type": "string"
},
"basis": {
"type": "string"
},
"methodology_url": {
"format": "uri",
"type": "string"
},
"source_scope": {
"type": "string"
},
"source_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"authority",
"basis",
"methodology_url"
],
"type": "object"
},
"suggestedCodes": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"friendlyName": {
"type": "string"
},
"relevance": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"technicalName": {
"type": "string"
},
"whyRelevant": {
"type": "string"
}
},
"required": [
"code",
"friendlyName",
"technicalName",
"whyRelevant",
"relevance"
],
"type": "object"
},
"type": "array"
},
"type": {
"enum": [
"specialty_browse",
"imaging_browse",
"search_results"
],
"type": "string"
}
},
"required": [
"type",
"interpretation",
"needsConfirmationWith",
"provenance",
"suggestedCodes"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:e92fa3ffab64615c5bd868fc3e845109af54f5adfeaedf2e09e23e22b36aa58e | sha256sum