KeepMD MCP for EOB Decoder for Hermes Agent
Explain the codes, insurance terms and patient-responsibility math on a medical Explanation of Benefits
(EOB), Medicare Summary Notice or itemized bill, inside Hermes Agent.
This folder is an Agent Plugins v1 package (plugin.json, mcp.json, skills/), configuration only. It
connects Hermes to the free, read-only KeepMD MCP for EOB Decoder server at https://mcp.keepmd.org/eob
(Streamable HTTP, no sign-in, no API key) and bundles the reading-an-eob workflow skill.
Install
hermes plugins install keepmd-mcp-eob-decoder
hermes plugins enable keepmd-mcp-eob-decoder
Then ask, for example:
- "My EOB lists E11.9, A0428 and J3490. What are they?"
- "What does coinsurance mean on my EOB?"
- "Billed 1200, allowed 650, deductible 500, 20% coinsurance. My EOB says I owe 630. Is that right?"
Tools
All five tools are annotated read-only.
| Tool | What it does |
|---|---|
lookup_codes | Official descriptors for ICD-10-CM and HCPCS Level II codes; flags CPT, dental and remark codes, which are licensed by their owners and not described |
search_codes | Finds codes from everyday wording |
explain_insurance_term | Plain-language definitions with a worked example |
check_eob_math | Checks billed, allowed, deductible, coinsurance and patient-responsibility arithmetic |
get_eob_reading_guide | Step-by-step guide to reading a statement, red flags and appeals |
What to know before installing
- Every tool call goes to KeepMD's hosted server at
mcp.keepmd.org. It receives only codes, search words,
insurance terms and dollar amounts. It stores nothing, logs no tool arguments and never needs names or
member IDs. Privacy notice: https://keepmd.org/privacy/mcp-eob-decoder/ - No credentials, no local processes, no shell commands, no telemetry, and nothing is read outside the package.
- The tool set is served by the remote server at runtime and is not covered by the pinned commit. Its source is
this repository: https://github.com/keepmd-medical/keepmd-mcp-eob-decoder - General billing and coding reference, not medical, legal or financial advice.
Docs: https://keepmd.org/mcp-eob-decoder/ · Support: support@keepmd.org
README from the reviewed commit 345a48c; it updates when the author re-pins.

KeepMD