How do I use Medical Billing MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Medical Billing MCP What does denial code CO-50 mean and how to fix it?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Medical Billing MCP

by Kustode-ce

Overview Schema Related Servers Score Discussions

Python

Local

🏥 Medical Billing MCP

Open-source billing knowledge for AI assistants

License: MIT MCP Docker PRs Welcome

The Problem: A billing staff member gets a denial code. They Google it, read 5 articles, call the payer, wait on hold for 45 minutes, and maybe get an answer. Cost: 30-60 minutes per denial.
The Solution: Ask an AI assistant. Get instant answers with resolution steps. Cost: 2 minutes.

What Is This?

An MCP (Model Context Protocol) server that gives AI assistants like Claude access to medical billing knowledge:

Tool	What It Does
`lookup_icd10`	Look up diagnosis codes
`lookup_cpt`	Look up procedure codes
`lookup_modifier`	Understand when to use modifiers (25, 59, etc.)
`lookup_denial`	Understand denial codes + how to fix them
`lookup_payer`	Get payer-specific rules (timely filing, etc.)
`lookup_bundling`	Check if codes are bundled together

This is a knowledge layer. You bring your own payer connectivity (Stedi, Availity, Change Healthcare, etc.).

Related MCP server: MCP Healthcare Server

Quick Start

Option 1: Docker (Recommended)

# Clone the repo
git clone https://github.com/Kustode-ce/medical-billing-mcp.git
cd medical-billing-mcp

# Run with Docker
docker compose up -d

# Test it
docker compose exec mcp python -m medical_billing_mcp --test

Option 2: Local Install

# Clone and install
git clone https://github.com/Kustode-ce/medical-billing-mcp.git
cd medical-billing-mcp
pip install -e .

# Run the server
python -m medical_billing_mcp

Configure Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "medical-billing": {
      "command": "python",
      "args": ["-m", "medical_billing_mcp"]
    }
  }
}

Config locations:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Restart Claude Desktop.

Usage Examples

Once installed, ask Claude questions like:

Understanding Codes

"What does ICD-10 code E11.9 mean?"

"What's CPT code 99214 and what documentation do I need?"

"When should I use modifier 25?"

Resolving Denials

"I got denial code CO-50. What does it mean and how do I fix it?"

"My claim was denied for 'not medically necessary'. What are the resolution steps?"

Payer Rules

"What's Medicare's timely filing limit?"

"What are Blue Cross MA's known billing issues?"

Bundling

"Are CPT codes 99213 and 36415 bundled?"

See docs/examples/ for sample conversations.

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                    AI ASSISTANT (Claude)                         │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ MCP Protocol
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    MEDICAL BILLING MCP                           │
│                                                                  │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │                      server.py                            │  │
│  │            (Tool definitions + routing)                   │  │
│  └──────────────────────────────────────────────────────────┘  │
│                              │                                   │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │                     handlers.py                           │  │
│  │              (Lookup functions)                           │  │
│  └──────────────────────────────────────────────────────────┘  │
│                              │                                   │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │                       data/                               │  │
│  │                                                           │  │
│  │   icd10.json   cpt.json   modifiers.json                 │  │
│  │   denials.json   payers.json   bundling.json             │  │
│  │                                                           │  │
│  │            [Community contributes here]                   │  │
│  └──────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────┘

See ARCHITECTURE.md for detailed design documentation.

What This Is NOT

Not In Scope	Why	You Already Have
Claim submission	Not our job	Stedi, Availity
Eligibility checks	Real-time payer data	Stedi, payer portals
Prior auth submission	Payer integration	Cohere, eviCore
EOB/ERA parsing	Clearinghouse function	Stedi, clearinghouse
PHI storage	Security/compliance	Your EHR/PMS

We provide knowledge. You provide connectivity.

Data Sources

All data is from public sources:

Data	Source
ICD-10 codes	CMS
CPT descriptions	AMA (limited - full requires license)
HCPCS codes	CMS
Denial codes (CARC/RARC)	X12 / Washington Publishing
Payer rules	Public payer manuals

Contributing

We welcome contributions! The easiest way to help:

Add Payer Rules

Know a payer's quirks? Edit data/payers.json:

{
  "bcbs_tx": {
    "name": "Blue Cross Blue Shield Texas",
    "timely_filing_days": 95,
    "known_issues": ["Requires modifier 25 documentation"]
  }
}

Add Denial Resolution Steps

Fixed a tricky denial? Share how in data/denials.json:

{
  "CO-151": {
    "description": "Service not covered",
    "resolution_steps": [
      "Check if service requires prior auth",
      "Verify correct place of service code",
      "Appeal with medical necessity documentation"
    ]
  }
}

See CONTRIBUTING.md for full guidelines.

Project Structure

medical-billing-mcp/
├── src/medical_billing_mcp/
│   ├── __init__.py
│   ├── __main__.py
│   ├── server.py          # MCP server
│   ├── handlers.py        # Lookup functions
│   └── data/              # JSON knowledge base
│       ├── icd10.json
│       ├── cpt.json
│       ├── modifiers.json
│       ├── denials.json
│       ├── payers.json
│       └── bundling.json
├── tests/
├── docs/
│   ├── diagrams/          # Architecture diagrams
│   ├── api/               # API documentation
│   └── examples/          # Usage examples
├── docker/
│   ├── Dockerfile
│   └── docker-compose.yml
├── ARCHITECTURE.md
├── CONTRIBUTING.md
├── LICENSE
└── README.md

License

MIT License - see LICENSE

Note: CPT codes are copyrighted by the AMA. This tool provides limited descriptions for educational purposes. For full CPT data, obtain an AMA license.

Support

🐛 Issues: GitHub Issues
💬 Discussions: GitHub Discussions

Made for the healthcare community ❤️

Because providers should spend time with patients, not fighting insurance companies.

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

Medikode Medical Coding MCP
Biology & Medicine Health & Wellness Research & Data
raelango
A
license
-
quality
C
maintenance
Enables AI assistants to access Medikode's medical coding platform for validating CPT/ICD-10 codes, performing chart quality assurance, parsing EOBs, calculating RAF scores, and extracting HCC codes from clinical documentation.
Last updated 2025-10-30
47
2
ISC
MCP Healthcare Server
shinegami-2002
A
license
-
quality
D
maintenance
Provides real-time access to medical data including drug interactions, ICD-10 codes, FDA adverse event reports, and clinical guidelines. It enables LLMs to query databases like openFDA, PubMed, and CMS for pharmaceutical and clinical information.
Last updated 2026-03-01
1
MIT
mymedi-ai-mcp-server
AI & Machine Learning Health & Wellness
MyMedi-AI
A
license
A
quality
B
maintenance
Healthcare billing AI for agents — 12 tools for ICD-10/CPT/HCPCS code lookup (80K+ codes), prior auth prediction, medical NER, claims validation, HIPAA compliance auditing, and provider/drug enrichment. Pay-per-call via credits or USDC.
Last updated 2026-07-24
20
133
2
MIT
vClinic MCP Serverofficial
Biology & Medicine RAG Systems Search
v-clinic
F
license
-
quality
C
maintenance
Enables AI agents to manage virtual clinic data including patients, visits, diagnoses, treatments, lab/radiology orders, and search medical literature and internal knowledge base.
Last updated 2026-07-12

View all related MCP servers

Related MCP Connectors

Rootr
Connect your team's living knowledge base — docs, data, issues, CRM — to Claude and ChatGPT.
Ragora
Search your knowledge bases from any AI assistant using hybrid RAG.
MedPrice AI
Hosted MCP server exposing US hospital procedure cost data to AI assistants

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Kustode-ce/medical-billing-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server