bradesco-rede-mcp

MCP server para consulta em tempo real a rede referenciada do Bradesco Saude. Expoe uma ferramenta search_providers que agentes LLM podem chamar para buscar medicos, hospitais, clinicas e laboratorios.

Instalacao

npm install -g bradesco-rede-mcp

Requer Node 20+. Sem necessidade de browser ou Playwright — o servidor faz chamadas HTTP diretas a API do Bradesco.

Related MCP server: recife-open-data-mcp

Configuracao no cliente MCP

Claude Desktop

Adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "bradesco-rede": {
      "command": "node",
      "args": ["/caminho/absoluto/bradesco-rede-mcp/dist/index.js"],
      "env": {
        "LOG_LEVEL": "info"
      }
    }
  }
}

opencode

Adicione ao opencode.json na secao mcp, mesmo padrao: command + args + env.

Caminho absoluto e obrigatorio.

Variaveis de ambiente

Todas tem defaults. Configurar e otimizacao, nao pre-requisito.

Testes

npm test                                    # unit + integracao
RUN_LIVE_TESTS=true npm run test:live       # live (real API, lento)

Limitacoes

• Uma busca por vez (sem concorrencia). Para v1, inflight=1 + cache em memoria e a unica protecao contra excesso de requisicoes (nao ha delay minimo entre buscas).

• Cache em memoria apenas (volatil ao reiniciar).

• Coordenadas aproximadas (capitais estaduais) — distancias podem ser imprecisas.

• Token de autenticacao renovado automaticamente.

• O filtro plano e aceito mas nao aplicado em v1 (wiring exige lookup de codigoRede, fora do escopo).

• O filtro tipo e aplicado client-side apos a busca (a API nao suporta filtro direto por tipo).

• Busca por localizacao apenas (so estado/cidade) nao e suportada — informe nome (>= 3 chars) ou especialidade.

Troubleshooting

Aviso legal

Esta ferramenta automatiza consultas a API publica de rede referenciada do Bradesco Saude para uso pessoal. Nao e afiliada ao Bradesco. O usuario e responsavel por cumprir os Termos de Uso do site alvo. Os dados retornados sao cacheados em memoria por curto periodo e nao sao persistidos ou redistribuidos.