Medicare Fee Schedule Rates
Medicare Physician Fee Schedule amounts by code, date and locality, traced to archived CMS files.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~3,020Tokens (tool definitions)
~15.6 KBTypical response size
Significant attention impact (2.36% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"medicare-fee-schedule": {
"url": "https://s2reason.com/mcp"
}
}
}Remote endpoints
https://s2reason.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (2)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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.
Input Schema
{
"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"
]
}Output Schema
{
"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.
Input Schema
{
"type": "object",
"additionalProperties": false
}Output Schema
{
"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
}Community
Evidence
Recent observations
verifiedversion not recorded2 tools