lookup_billing_codeLABSCO SUMMARY
A code lookup in the window where the note is being written.
Both directions work — a code you were handed and need explained, or a description you need the code for — answered from a table that lives in the repository and that you fill with the source you trust.
What it is
A Python MCP server over a medical billing code table. Two tools: look one code up by system and number, or search codes by a keyword in their description. The repository ships a small sample table in server.py, meant to be extended or pointed at a real source.
What you get
- One CPT, ICD-10 or HCPCS code looked up by system and number
- Codes found by keyword in their description, filtered to one system or searched across all three
- Category and typical reimbursement range, where the record carries them
Requirements
Python 3.10 or higher, installed with pip install -e . and run as python server.py. The bundled table is a sample: CMS.gov fee schedules, the CDC ICD-10 database and CMS HCPCS lists are the sources for a full one, and AMA CPT descriptions need a licence for commercial use. Verify any code against an official source before it goes on a claim.
Setup effort
Build from source — git clone https://github.com/contextkits/healthcare-billing-codes.git
USE CASES
01
Explaining a code that appeared on a claim
Give the system and the number and read back the description and category.
02
Finding the code for a procedure or diagnosis
Search by keyword across the systems, or set the type when you already know which one you are billing under.
03
Checking a code before it goes out
Search for the description you mean, then look the candidate up in full and confirm it against the official source.
2 tools
Listed in project docs. Your client may show a different list.
search_codes_by_descriptionBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
Requires
Python 3.10 or later
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/contextkits/healthcare-billing-codes.git
cd healthcare-billing-codes
pip install -e .MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"healthcare-billing-codes": {
"command": "python",
"args": [
"<YOUR_PATH_TO_HEALTHCARE_BILLING_CODES>/server.py"
]
}
}
}
