Medicare Fee Schedule Rates
Medicare Physician Fee Schedule amounts by code, date and locality, traced to archived CMS files.
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~3,020Tokens (definiciones de herramientas)
~15.6 KBTamaño de respuesta típico
Impacto significativo en la atención (2.36% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"medicare-fee-schedule": {
"url": "https://s2reason.com/mcp"
}
}
}Puntos de conexión remotos
https://s2reason.com/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (2)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢medicare_get_physician_fee(lines, state, locality, setting, detail)
Use this when you need what Medicare's Physician Fee Schedule allows for a CPT or HCPCS code on a given date of service, for the nation or for one state or locality, in the office or facility setting. It takes up to 25 lines (code, modifier, date of service) and returns one answer per line, in order: CMS's allowed amount (national figure, plus the state range or one locality's figure when a state is given), the CMS release in force on that date, its source files with SHA-256 checksums, and the release catalog URL. It covers dates of service from Jan 1, 2023 through Dec 31, 2026; each date is priced under the quarterly CMS release in force that day, and a date outside that span gets a reason instead of a figure. A code with no national rate on this schedule (bundled, carrier-priced, laboratory, drug, anesthesia, ambulance, supplies, or absent from that release) returns a result_kind and a reason, not an error, and a malformed line returns an error for that line only. Do not use it for hospital outpatient or inpatient facility payments, ambulatory surgery center fees, Medicaid, commercial or workers' compensation rates, CPT code descriptions, or opinions on whether a charge is reasonable. It is read-only; amounts are Medicare-allowed amounts per unit, before sequestration and multiple-procedure reductions.
Esquema de entrada
{
"type": "object",
"properties": {
"lines": {
"type": "array",
"minItems": 1,
"maxItems": 25,
"description": "One to 25 service lines to price. The answers come back in this order.",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"maxLength": 16,
"description": "CPT or HCPCS code: five digits, four digits and a letter, or a letter and four digits. Case and spaces do not matter, and a trailing modifier is accepted. Example: 12345."
},
"modifier": {
"type": "string",
"maxLength": 8,
"description": "Optional. none or empty for the whole (global) service, 26 for the professional component, TC for the technical component, or 53 for a discontinued procedure. Example: 26."
},
"date_of_service": {
"type": "string",
"maxLength": 24,
"description": "Date the service was provided: YYYY-MM-DD, or MM/DD/YYYY with the month first, or a written date. The year has four digits. Example: 2025-06-17."
}
},
"required": [
"code",
"date_of_service"
]
}
},
"state": {
"type": "string",
"maxLength": 24,
"description": "Optional, applies to every line. Two-letter key or full name of a state, DC, Puerto Rico or the Virgin Islands. Leave it out for the national figure only. Example: NJ."
},
"locality": {
"type": "string",
"maxLength": 4,
"description": "Optional, applies to every line, needs state. CMS locality number inside that state. Leave it out to get the state's range. Example: 01."
},
"setting": {
"type": "string",
"enum": [
"office",
"facility"
],
"description": "Optional, applies to every line. Which setting the headline figure reports: office (non-facility) or facility (hospital). Both settings are always in the figures. Leave it out for the setting CMS shows first."
},
"detail": {
"type": "string",
"enum": [
"concise",
"detailed"
],
"description": "Optional, applies to every line. concise (default) returns the national figure and the state range. detailed lists every locality in the state, with the geographic indexes used, and needs state."
}
},
"required": [
"lines"
]
}Esquema de salida
{
"type": "object",
"properties": {
"schema": {
"type": "string",
"enum": [
"s2reason.pfs-lines/2"
]
},
"results": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"line": {
"type": "integer"
},
"ok": {
"type": "boolean",
"enum": [
true
]
},
"release_id": {
"type": [
"string",
"null"
]
},
"ama_notice_applies": {
"type": "boolean"
},
"code_description": {
"type": [
"string",
"null"
]
},
"answer": {
"type": "object",
"properties": {
"schema": {
"type": "string",
"enum": [
"s2reason.pfs-answer/1"
]
},
"input": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"modifier": {
"type": "string",
"enum": [
"",
"26",
"TC",
"53"
]
},
"date_of_service": {
"type": "string"
},
"state": {
"type": [
"string",
"null"
]
},
"locality": {
"type": [
"string",
"null"
]
},
"setting": {
"type": [
"string",
"null"
],
"enum": [
"office",
"facility",
null
]
},
"detail": {
"type": "string",
"enum": [
"concise",
"detailed"
]
}
},
"required": [
"code",
"modifier",
"date_of_service",
"state",
"locality",
"setting",
"detail"
],
"additionalProperties": false
},
"result_kind": {
"type": "string",
"enum": [
"figure",
"no_rate",
"carrier_priced",
"bundled",
"not_in_release",
"date_outside_coverage"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"other_schedule": {
"type": [
"string",
"null"
],
"enum": [
"anesthesia",
"lab",
"dme",
"ambulance",
"drug",
null
]
},
"releases_with_code": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
]
},
"modifier_applied": {
"type": [
"string",
"null"
],
"enum": [
"",
"26",
"TC",
"53",
null
]
},
"cms_status": {
"anyOf": [
{
"type": "object",
"properties": {
"code": {
"type": "string"
},
"meaning": {
"type": "string"
}
},
"required": [
"code",
"meaning"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"headline": {
"type": "object",
"properties": {
"setting": {
"type": "string",
"enum": [
"office",
"facility"
]
},
"place": {
"type": "string"
},
"amount": {
"type": [
"number",
"null"
]
},
"low": {
"type": [
"number",
"null"
]
},
"high": {
"type": [
"number",
"null"
]
}
},
"required": [
"setting",
"place",
"amount",
"low",
"high"
],
"additionalProperties": false
},
"figures": {
"anyOf": [
{
"type": "object",
"properties": {
"national": {
"type": "object",
"properties": {
"office": {
"type": "number"
},
"facility": {
"type": "number"
}
},
"required": [
"office",
"facility"
],
"additionalProperties": false
},
"state": {
"anyOf": [
{
"type": "object",
"properties": {
"state": {
"type": "string"
},
"state_name": {
"type": "string"
},
"locality_count": {
"type": "number"
},
"office": {
"type": "object",
"properties": {
"low": {
"type": "number"
},
"high": {
"type": "number"
}
},
"required": [
"low",
"high"
],
"additionalProperties": false
},
"facility": {
"type": "object",
"properties": {
"low": {
"type": "number"
},
"high": {
"type": "number"
}
},
"required": [
"low",
"high"
],
"additionalProperties": false
}
},
"required": [
"state",
"state_name",
"locality_count",
"office",
"facility"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"localities": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"locality": {
"type": "string"
},
"name": {
"type": "string"
},
"mac": {
"type": "string"
},
"office": {
"type": "number"
},
"facility": {
"type": "number"
},
"gpci": {
"type": "object",
"properties": {
"work": {
"type": "number"
},
"pe": {
"type": "number"
},
"mp": {
"type": "number"
}
},
"required": [
"work",
"pe",
"mp"
],
"additionalProperties": false
},
"cap": {
"type": "object",
"properties": {
"office": {
"type": [
"number",
"null"
]
},
"facility": {
"type": [
"number",
"null"
]
}
},
"required": [
"office",
"facility"
],
"additionalProperties": false
}
},
"required": [
"locality",
"name",
"mac",
"office",
"facility",
"gpci",
"cap"
],
"additionalProperties": false
}
},
{
"type": "null"
}
]
}
},
"required": [
"national",
"state",
"localities"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"restatements": {
"type": "object",
"properties": {
"applied": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cr": {
"type": "string"
},
"effective": {
"type": "string"
},
"modifier": {
"type": "string",
"enum": [
"",
"26",
"TC",
"53"
]
}
},
"required": [
"cr",
"effective",
"modifier"
],
"additionalProperties": false
}
},
"pending": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cr": {
"type": "string"
},
"effective": {
"type": "string"
},
"modifier": {
"type": "string",
"enum": [
"",
"26",
"TC",
"53"
]
}
},
"required": [
"cr",
"effective",
"modifier"
],
"additionalProperties": false
}
}
},
"required": [
"applied",
"pending"
],
"additionalProperties": false
},
"recipe": {
"type": "object",
"properties": {
"rvu": {
"anyOf": [
{
"type": "object",
"properties": {
"work": {
"type": "number"
},
"pe_office": {
"type": "number"
},
"pe_facility": {
"type": "number"
},
"mp": {
"type": "number"
}
},
"required": [
"work",
"pe_office",
"pe_facility",
"mp"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"rvu"
],
"additionalProperties": false
},
"page_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"schema",
"input",
"result_kind",
"reason",
"other_schedule",
"releases_with_code",
"modifier_applied",
"cms_status",
"headline",
"figures",
"limitations",
"restatements",
"recipe",
"page_url"
],
"additionalProperties": false
}
},
"required": [
"line",
"ok",
"release_id",
"ama_notice_applies",
"code_description",
"answer"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"line": {
"type": "integer"
},
"ok": {
"type": "boolean",
"enum": [
false
]
},
"error": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message"
],
"additionalProperties": false
}
},
"required": [
"line",
"ok",
"error"
],
"additionalProperties": false
}
]
}
},
"releases": {
"type": "object",
"additionalProperties": {
"type": "object",
"properties": {
"release": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"effective": {
"type": "string"
},
"end": {
"type": [
"string",
"null"
]
},
"cite": {
"type": "string"
},
"url": {
"type": "string"
},
"formula_only": {
"type": "boolean"
}
},
"required": [
"id",
"label",
"effective",
"end",
"cite",
"url",
"formula_only"
],
"additionalProperties": false
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"type": "string"
},
"name": {
"type": "string"
},
"sha256": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
}
},
"required": [
"role",
"name",
"sha256",
"url"
],
"additionalProperties": false
}
},
"conversion_factor": {
"type": "number"
}
},
"required": [
"release",
"sources",
"conversion_factor"
],
"additionalProperties": false
}
},
"coverage": {
"type": "object",
"properties": {
"first_date_of_service": {
"type": "string"
},
"newest_release": {
"type": "string"
},
"newest_release_effective": {
"type": "string"
},
"last_coverable_date": {
"type": "string"
},
"gaps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"why": {
"type": "string"
}
},
"required": [
"from",
"to",
"why"
],
"additionalProperties": false
}
},
"archive_generated": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"required": [
"first_date_of_service",
"newest_release",
"newest_release_effective",
"last_coverable_date",
"gaps",
"archive_generated",
"summary"
],
"additionalProperties": false
},
"recipe_formula": {
"type": "object",
"properties": {
"formula_id": {
"type": "string",
"enum": [
"pfs-rvu-gpci-cf-v1"
]
},
"formula": {
"type": "string"
},
"inputs_note": {
"type": "string"
}
},
"required": [
"formula_id",
"formula",
"inputs_note"
],
"additionalProperties": false
},
"ama_notice": {
"type": [
"string",
"null"
]
},
"release_catalog_url": {
"type": "string"
},
"notice": {
"type": "string"
}
},
"required": [
"schema",
"results",
"releases",
"coverage",
"recipe_formula",
"ama_notice",
"release_catalog_url",
"notice"
],
"additionalProperties": false
}🟢medicare_list_fee_releases
Use this when you need to know which CMS Medicare Physician Fee Schedule releases the archive holds, with their effective dates, CMS source files, SHA-256 checksums and any gaps in coverage, before or instead of looking up a fee. It takes no input and returns every release, newest first (id, label, effective and end dates, the CMS document that fixed the dates, source files, the hosted data bundle), plus the coverage summary and the release catalog URL. Coverage runs from Jan 1, 2023 through Dec 31, 2026, and the list changes only when a new CMS release is archived. Do not use it to get a fee amount (use medicare_get_physician_fee), or for other Medicare schedules such as hospital outpatient, ambulatory surgery center, laboratory, ambulance or DMEPOS, or for Medicaid or commercial rates. It is read-only.
Esquema de entrada
{
"type": "object",
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"schema": {
"type": "string",
"enum": [
"s2reason.pfs-releases/1"
]
},
"coverage": {
"type": "object",
"properties": {
"first_date_of_service": {
"type": "string"
},
"newest_release": {
"type": "string"
},
"newest_release_effective": {
"type": "string"
},
"last_coverable_date": {
"type": "string"
},
"gaps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"why": {
"type": "string"
}
},
"required": [
"from",
"to",
"why"
],
"additionalProperties": false
}
},
"archive_generated": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"required": [
"first_date_of_service",
"newest_release",
"newest_release_effective",
"last_coverable_date",
"gaps",
"archive_generated",
"summary"
],
"additionalProperties": false
},
"releases": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"effective": {
"type": "string"
},
"end": {
"type": [
"string",
"null"
]
},
"formula_only": {
"type": "boolean"
},
"cite": {
"type": "string"
},
"url": {
"type": "string"
},
"source_files": {
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"type": "string"
},
"name": {
"type": "string"
},
"sha256": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
}
},
"required": [
"role",
"name",
"sha256",
"url"
],
"additionalProperties": false
}
},
"bundle": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"sha256": {
"type": [
"string",
"null"
]
}
},
"required": [
"url",
"sha256"
],
"additionalProperties": false
}
},
"required": [
"id",
"label",
"effective",
"end",
"formula_only",
"cite",
"url",
"source_files",
"bundle"
],
"additionalProperties": false
}
},
"release_catalog_url": {
"type": "string"
}
},
"required": [
"schema",
"coverage",
"releases",
"release_catalog_url"
],
"additionalProperties": false
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada2 herramientas