healthcare-billing-codes

★ 2

from contextkits

Standard MCP Server for looking up CPT, ICD-10, and denial codes.

🔥🔥🔥✓ VerifiedFreeQuick setup

Healthcare Billing Codes MCP Server

An MCP (Model Context Protocol) server that provides lookup and search capabilities for medical billing codes including CPT, ICD-10, and HCPCS codes.

Features

Lookup billing codes: Get detailed information about specific CPT, ICD-10, or HCPCS codes
Search by description: Find codes by searching keywords in descriptions
Category information: View code categories and typical reimbursement rates (where applicable)

Tools

`lookup_billing_code`

Look up information about a specific medical billing code.

Parameters:

code_type (string, required): Type of code - "CPT", "ICD10", or "HCPCS"
code (string, required): The billing code to look up

Example:

{
  "code_type": "CPT",
  "code": "99213"
}

`search_codes_by_description`

Search for billing codes by keyword in description.

Parameters:

keyword (string, required): Keyword to search for
code_type (string, optional): Filter by code type or "ALL" (default: "ALL")

Example:

{
  "keyword": "diabetes",
  "code_type": "ICD10"
}

Extending the Database

The current implementation includes a small sample database. To add more codes:

Edit the BILLING_CODES dictionary in server.py
Or connect to an external database/API in the lookup functions

Example: Adding a new CPT code

"99215": {
    "description": "Office visit, established patient, 40-54 minutes",
    "category": "Evaluation and Management",
    "typical_reimbursement": "$185-$260"
}

Data Sources (for expansion)

To build a complete database, consider these public sources:

CMS.gov: Medicare fee schedules
AMA CPT: CPT code descriptions (requires license for commercial use)
CDC ICD-10: Free ICD-10 code database
CMS HCPCS: HCPCS code lists

Legal Disclaimer

This tool is provided for reference purposes only. Users must verify all billing codes with official sources before use in actual medical billing. The authors assume no liability for billing errors or claim denials resulting from use of this tool.

Monetization Options

This server can be monetized as:

Freemium model: Basic codes free, comprehensive database paid
API access: Charge per lookup for commercial users
White-label licensing: License to EHR vendors or billing companies
Data partnerships: Partner with coding databases for official data

Contact

For commercial licensing or data partnerships: your-email@example.com

Copy & paste — that's it

pip install -e .

Installation

Prerequisites

Python 3.10 or higher
pip

Setup

Clone this repository:

git clone https://github.com/yourusername/healthcare-billing-codes.git
cd healthcare-billing-codes

Install dependencies:

pip install -e .

Run the server:

python server.py

Usage with Claude Desktop

Add to your Claude Desktop config file (claude_desktop_config.json):

{
  "mcpServers": {
    "healthcare-billing-codes": {
      "command": "python",
      "args": ["/path/to/healthcare-billing-codes/server.py"]
    }
  }
}