English Français العربية

KeepMD MCP for EOB Decoder

السجل الرسمي الصحة

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http keepmd-mcp-for-eob-decoder 'https://mcp.keepmd.org/eob'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "keepmd-mcp-for-eob-decoder": {
            "type": "http",
            "url": "https://mcp.keepmd.org/eob"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. KeepMD MCP for EOB Decoder
  2. What it does
  3. Privacy
  4. Data
  5. Use it
  6. Run it yourself
  7. Test it
  8. About KeepMD
  9. License

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.) · support@keepmd.org

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:

{ "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

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

Test it

npm run dev                                   # terminal 1
npm run smoke -- http://127.0.0.1:8787/eob    # terminal 2: initialize, tools/list, one call per tool, the prompt
npx @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: support@keepmd.org (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.

الأسئلة الشائعة

ما هو KeepMD MCP for EOB Decoder؟

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

كيف أثبّت KeepMD MCP for EOB Decoder؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http keepmd-mcp-for-eob-decoder 'https://mcp.keepmd.org/eob'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج KeepMD MCP for EOB Decoder إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل KeepMD MCP for EOB Decoder مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون KeepMD MCP for EOB Decoder؟

ينشره keepmd-medical. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.