Medicare Fee Schedule Rates
Medicare Physician Fee Schedule amounts by code, date and locality, traced to archived CMS files.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案:
{
"mcpServers": {
"medicare-fee-schedule": {
"url": "https://s2reason.com/mcp"
}
}
}遠端端點
https://s2reason.com/mcpstreamable-http它能做什麼
工具清單
工具(2)
🟢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.
輸入結構描述
{
"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"
]
}輸出結構描述
{
"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.
輸入結構描述
{
"type": "object",
"additionalProperties": false
}輸出結構描述
{
"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
}社群
證據