healthcare-billing-codes

Servidor MCP padrão para consulta de códigos CPT, CID-10 e códigos de negação.

GitHub
3

Documentação

Servidor MCP de Códigos de Cobrança Médica

Um servidor MCP (Model Context Protocol) que fornece recursos de consulta e pesquisa para códigos de cobrança médica, incluindo códigos CPT, ICD-10 e HCPCS.

Recursos

  • Consulta de códigos de cobrança: Obtenha informações detalhadas sobre códigos CPT, ICD-10 ou HCPCS específicos
  • Pesquisa por descrição: Encontre códigos pesquisando palavras-chave nas descrições
  • Informações de categoria: Visualize categorias de códigos e taxas de reembolso típicas (quando aplicável)

Ferramentas

lookup_billing_code

Consulte informações sobre um código de cobrança médica específico.

Parâmetros:

  • code_type (string, obrigatório): Tipo de código - "CPT", "ICD10" ou "HCPCS"
  • code (string, obrigatório): O código de cobrança a ser consultado

Exemplo:

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

search_codes_by_description

Pesquise códigos de cobrança por palavra-chave na descrição.

Parâmetros:

  • keyword (string, obrigatório): Palavra-chave para pesquisar
  • code_type (string, opcional): Filtrar por tipo de código ou "ALL" (padrão: "ALL")

Exemplo:

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

Instalação

Pré-requisitos

  • Python 3.10 ou superior
  • pip

Configuração

  1. Clone este repositório:
git clone https://github.com/yourusername/healthcare-billing-codes.git
cd healthcare-billing-codes
  1. Instale as dependências:
pip install -e .
  1. Execute o servidor:
python server.py

Uso com Claude Desktop

Adicione ao seu arquivo de configuração do Claude Desktop (claude_desktop_config.json):

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

Expandindo o Banco de Dados

A implementação atual inclui um pequeno banco de dados de exemplo. Para adicionar mais códigos:

  1. Edite o dicionário BILLING_CODES em server.py
  2. Ou conecte-se a um banco de dados/API externo nas funções de consulta

Exemplo: Adicionando um novo código CPT

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

Fontes de Dados (para expansão)

Para construir um banco de dados completo, considere estas fontes públicas:

  • CMS.gov: Tabelas de honorários do Medicare
  • AMA CPT: Descrições de códigos CPT (requer licença para uso comercial)
  • CDC ICD-10: Banco de dados gratuito de códigos ICD-10
  • CMS HCPCS: Listas de códigos HCPCS

Aviso Legal

Esta ferramenta é fornecida apenas para fins de referência. Os usuários devem verificar todos os códigos de cobrança com fontes oficiais antes do uso em cobrança médica real. Os autores não assumem responsabilidade por erros de cobrança ou negações de sinistros resultantes do uso desta ferramenta.

Licença

Licença MIT - Consulte o arquivo LICENSE para obter detalhes

Contribuições

Contribuições são bem-vindas! Envie pull requests ou abra issues no GitHub.

Opções de Monetização

Este servidor pode ser monetizado como:

  1. Modelo Freemium: Códigos básicos gratuitos, banco de dados abrangente pago
  2. Acesso via API: Cobrança por consulta para usuários comerciais
  3. Licenciamento white-label: Licença para fornecedores de EHR ou empresas de cobrança
  4. Parcerias de dados: Parceria com bancos de dados de codificação para dados oficiais

Contato

Para licenciamento comercial ou parcerias de dados: your-email@example.com