KeepMD MCP for EOB Decoder

org.keepmd由 keepmd.org 發布官方發布者v0.1.3更新於 Nov 5, 2026

Explains medical bill and EOB codes, terms and math. From KeepMD, the family medical records app.

發布方自己的服務：KeepMD EOB Decoder

已驗證Streamable HTTP可網頁執行金融知識與記憶

概覽

AI 產生的概覽

唯讀的遠端 MCP 伺服器，協助助理解讀醫療保險 EOB 與帳單上的代碼、保險術語和金額。

可以做什麼
  • 查詢 ICD-10-CM、HCPCS Level II 及修飾碼的官方描述與目前有效性
  • 依日常用語或代碼前綴搜尋代碼
  • 解釋保險與帳單術語，附範例及相關術語
  • 重算 EOB 單行或理賠總額，標出差額收費或金額不符
  • 提供閱讀 EOB、對帳單提出異議或申訴拒付的逐步指南
適用情境
當使用者想弄懂 Explanation of Benefits、Medicare Summary Notice 或逐項醫療帳單時適用：某個代碼代表什麼、某個保險用語是什麼意思、金額是否對得起來，以及下一步該怎麼做。
執行需求
遠端 Streamable HTTP 端點；未宣告需要驗證、帳號或 API 金鑰。任何支援 HTTP 傳輸的 MCP 用戶端皆可使用。
安裝前請注意
僅為唯讀參考資料，不構成醫療、法律或財務建議，回傳內容附有免責聲明。輸入僅限代碼、術語和金額；伺服器聲明不儲存資料、不記錄工具參數。CPT、CDT 與 CARC/RARC 描述受授權限制，未包含在內。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 KeepMD MCP for EOB Decoder，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/org.keepmd%2Fmcp-eob-decoder/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "keepmd-for-eob-decoder": {
      "type": "http",
      "url": "https://mcp.keepmd.org/eob"
    }
  }
}

README

KeepMD MCP for EOB Decoder

A read-only Model Context Protocol server that helps an AI assistant read a medical Explanation of Benefits (EOB), Medicare Summary Notice or itemized bill. It is the same job the KeepMD EOB Decoder browser extensions do, exposed to Claude, ChatGPT, Cursor and any other MCP client.

Endpoint: https://mcp.keepmd.org/eob (Streamable HTTP, no authentication) Documentation: https://keepmd.org/mcp-eob-decoder/ Publisher: KeepMD (VertexMD, Inc.) · [email protected]

In plain English: you paste or describe an EOB or bill to Claude, ChatGPT or another assistant, and the assistant uses this server to say what each code means, what the insurance words mean, whether the amounts add up, and what to do next. The server only ever sees codes, words and dollar figures.

What it does

ToolPurpose
lookup_codesOfficial descriptors for ICD-10-CM diagnosis codes, HCPCS Level II service/supply/drug codes and HCPCS modifiers, with chapter, plain-language notes and licensing notices for CPT, dental, NDC and X12 remark codes (recognized, not described). Up to 50 codes per call.
search_codesFind ICD-10-CM or HCPCS Level II codes from words in a description, or by code prefix.
explain_insurance_term~115 insurance and billing terms (allowed amount, coinsurance, CO/PR group codes, No Surprises Act, observation status…) with examples and related terms.
check_eob_mathRecomputes one service line or claim total from the printed amounts and flags balance billing, mismatched totals and impossible cost sharing.
get_eob_reading_guideStep-by-step guide to reading an EOB, disputing a bill, or appealing a denial, with links to official consumer resources.

Plus the decode_eob prompt and two resources (keepmd://mcp-eob-decoder/glossary, keepmd://mcp-eob-decoder/manifest).

Every tool carries readOnlyHint: true and openWorldHint: false. Every clinical or financial payload carries a disclaimer field: general billing and coding reference, not medical, legal or financial advice.

Privacy

The server has no storage and no accounts. Tools accept codes, terms and dollar amounts only; no schema takes a name, date of birth, member ID, claim number or statement text. Tool arguments are never logged. Full policy: https://keepmd.org/privacy/mcp-eob-decoder/.

Data

SetReleaseLicense
ICD-10-CMFY2027 (effective 2026-10-01), NCHS/CMSPublic domain
HCPCS Level IIOctober 2026 quarterly file, CMSPublic domain (CDT D-codes dropped)
Glossary, reading guide, plain-language notesKeepMD-authoredMIT

CPT (AMA), CDT (ADA) and CARC/RARC (X12) descriptors are licensed and are not included. See NOTICE.md. Exact versions and file hashes: public/data/MANIFEST.json.

Use it

Claude (claude.ai → Settings → Connectors → Add custom connector): https://mcp.keepmd.org/eob Claude Code: claude mcp add --transport http keepmd-mcp-eob-decoder https://mcp.keepmd.org/eob Cursor / VS Code / other clients:

json
{ "mcpServers": { "keepmd-mcp-eob-decoder": { "type": "http", "url": "https://mcp.keepmd.org/eob" } } }

ChatGPT: install from the app directory once listed (see chatgpt/).

Try: "What do Z00.00, 99213 and J0696 mean on this EOB?" · "Explain allowed amount versus billed amount." · "Billed 1,200, allowed 650, deductible 500, 20% coinsurance. Is my 630 patient responsibility right?"

Run it yourself

bash
npm install --legacy-peer-depsnpm run data:refresh      # downloads the CMS/NCHS releases and rebuilds public/datanpm test && npm run typechecknpm run dev               # http://localhost:8787/eob

Test it

bash
npm run dev                                   # terminal 1npm run smoke -- http://127.0.0.1:8787/eob    # terminal 2: initialize, tools/list, one call per tool, the promptnpx @modelcontextprotocol/inspector           # point it at http://127.0.0.1:8787/eob (Streamable HTTP)

Or add the local server to Claude Code with claude mcp add --transport http eob-local http://127.0.0.1:8787/eob and ask it the reviewer prompts in docs/SUBMISSIONS.md. Problems: [email protected] (the issue tracker is off).

Built on @modelcontextprotocol/server (createMcpHandler, stateless Streamable HTTP) and Cloudflare Workers with Static Assets for the code sets. Layout, release and data-refresh steps: CONTRIBUTING.md, docs/DEPLOY.md. Directory submissions (Anthropic, OpenAI, MCP Registry, Google, Meta, Grok, Cursor and others): docs/SUBMISSIONS.md. Bundles: plugin/ (Claude plugin), chatgpt/ (ChatGPT app package), .cursor-plugin/ + mcp.json (Cursor plugin).

About KeepMD

This server comes from KeepMD, a family medical records app for tracking medical records, labs and health documents for everyone you look after. The server is a separate reference service: it stores nothing and never connects to anyone's records.

License

MIT for code and KeepMD-authored content. Government data sources are public domain; see NOTICE.md.

來源：README.md，提交 aeda536

工具

5

lookup_codes

Look up EOB codes

Checks codes against the current official releases, which change every year, and reports whether each is valid, billable or terminated today. Returns the official descriptor for ICD-10-CM diagnosis codes, HCPCS Level II service/supply/drug codes and HCPCS modifiers found on an Explanation of Benefits or medical bill, plus the chapter, a plain-language note where KeepMD has one, the data version, and licensing notices for CPT, dental, NDC and X12 remark codes (which are recognized but not described). Use it for any code a user asks about, including common ones such as Z00.00, 99213, J0696 or CO-45. Accepts every code from a statement in one call.

輸入參數codes必填system

search_codes

Search diagnosis and service codes

Finds ICD-10-CM diagnosis codes and HCPCS Level II service, supply and drug codes whose official description matches words from a statement (everyday wording such as "flu shot" or "x-ray" is translated to the clinical terms), or whose code starts with the given characters. Use it when the statement prints a description but no code, or the code is partly illegible. CPT (5-digit) physician-service codes such as office visits and lab panels are not searchable because their text is licensed.

輸入參數limitquery必填system

explain_insurance_term

Explain an insurance term

Returns KeepMD's plain-language definition, a worked example and related terms for an insurance or medical-billing term from its glossary (allowed amount, deductible, coinsurance, balance billing, CO/PR group codes, No Surprises Act, observation status and about 110 more). Use it when a user asks what a word, column or abbreviation on an EOB, Medicare Summary Notice or bill means, including common ones such as allowed amount, billed amount, deductible or CO. Takes one term per call.

輸入參數term必填

check_eob_math

Check EOB arithmetic

Recomputes one EOB line or claim total from the printed amounts (billed, allowed, plan paid, deductible, copay, coinsurance, non-covered, patient responsibility) and reports the contractual adjustment, the expected patient responsibility and plan payment, and any discrepancy such as a balance bill or a mismatched total. Use it when a user gives EOB or bill amounts and asks whether what they owe is right; it returns an itemized, exact calculation with stated assumptions. Pure arithmetic; takes dollar amounts only, never names or identifiers.

輸入參數copaybilledallowedplan_paiddeductiblein_networknon_coveredcoinsurance_ratecoinsurance_amountpatient_responsibility

get_eob_reading_guide

EOB reading guide

Returns KeepMD's step-by-step guide, red flags and links to official consumer resources for reading an Explanation of Benefits (overview), resolving a bill that looks wrong (dispute), appealing a denial (appeal), or the handful of terms that drive the arithmetic (glossary). Use it when a user asks how to read an EOB, what to do about a bill that looks wrong, or how to appeal a denial.

輸入參數topic

版本歷史

1
  1. v0.1.3最新Nov 5, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Keepmd 整合

KeepMD EOB Decoder

org.keepmd官方發布者

唯讀參考服務，讓助理解讀醫療福利說明（EOB）上的代碼、保險術語與帳單金額計算。

Streamable HTTP可網頁執行
金融5 個工具Nov 4, 2026