healthcare-billing-codes

Servidor MCP estándar para consultar códigos CPT, ICD-10 y de denegación.

Documentación

Servidor MCP de Códigos de Facturación Médica

Un servidor MCP (Model Context Protocol) que proporciona capacidades de consulta y búsqueda de códigos de facturación médica, incluyendo códigos CPT, ICD-10 y HCPCS.

Características

  • Consulta de códigos de facturación: Obtenga información detallada sobre códigos CPT, ICD-10 o HCPCS específicos
  • Búsqueda por descripción: Encuentre códigos buscando palabras clave en las descripciones
  • Información de categorías: Vea categorías de códigos y tasas de reembolso típicas (cuando corresponda)

Herramientas

lookup_billing_code

Consulte información sobre un código de facturación médica específico.

Parámetros:

  • code_type (cadena, obligatorio): Tipo de código - "CPT", "ICD10" o "HCPCS"
  • code (cadena, obligatorio): El código de facturación a consultar

Ejemplo:

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

search_codes_by_description

Busque códigos de facturación por palabra clave en la descripción.

Parámetros:

  • keyword (cadena, obligatorio): Palabra clave a buscar
  • code_type (cadena, opcional): Filtrar por tipo de código o "ALL" (predeterminado: "ALL")

Ejemplo:

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

Instalación

Requisitos previos

  • Python 3.10 o superior
  • pip

Configuración

  1. Clone este repositorio:
git clone https://github.com/yourusername/healthcare-billing-codes.git
cd healthcare-billing-codes
  1. Instale las dependencias:
pip install -e .
  1. Ejecute el servidor:
python server.py

Uso con Claude Desktop

Agregue a su archivo de configuración de Claude Desktop (claude_desktop_config.json):

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

Ampliación de la Base de Datos

La implementación actual incluye una pequeña base de datos de muestra. Para agregar más códigos:

  1. Edite el diccionario BILLING_CODES en server.py
  2. O conéctese a una base de datos/API externa en las funciones de consulta

Ejemplo: Agregar un nuevo código CPT

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

Fuentes de Datos (para expansión)

Para construir una base de datos completa, considere estas fuentes públicas:

  • CMS.gov: Programas de tarifas de Medicare
  • AMA CPT: Descripciones de códigos CPT (requiere licencia para uso comercial)
  • CDC ICD-10: Base de datos gratuita de códigos ICD-10
  • CMS HCPCS: Listas de códigos HCPCS

Aviso Legal

Esta herramienta se proporciona únicamente con fines de referencia. Los usuarios deben verificar todos los códigos de facturación con fuentes oficiales antes de usarlos en facturación médica real. Los autores no asumen responsabilidad por errores de facturación o denegaciones de reclamos resultantes del uso de esta herramienta.

Licencia

Licencia MIT - Consulte el archivo LICENSE para más detalles

Contribuciones

¡Las contribuciones son bienvenidas! Envíe solicitudes de extracción o abra problemas en GitHub.

Opciones de Monetización

Este servidor puede monetizarse como:

  1. Modelo freemium: Códigos básicos gratuitos, base de datos completa de pago
  2. Acceso API: Cobrar por consulta para usuarios comerciales
  3. Licencia de marca blanca: Licenciar a proveedores de EHR o empresas de facturación
  4. Asociaciones de datos: Asociarse con bases de datos de codificación para datos oficiales

Contacto

Para licencias comerciales o asociaciones de datos: your-email@example.com