credithub-mcp
v1.0.10
Published
A consulta de crédito mais poderosa do Brasil, direto no Claude Desktop. CPF, CNPJ, dívidas, protestos, processos - tudo via IA.
Maintainers
Readme
🚀 CreditHub MCP
A consulta de crédito mais poderosa do Brasil, agora direto no seu Claude Desktop
Começar Agora • Ferramentas • Documentação • CreditHub
💡 Por que usar?
Imagina pedir pro Claude:
"Faz uma análise completa do CNPJ 12.345.678/0001-90"
E receber de volta: razão social, sócios, dívidas, protestos, processos judiciais, score de crédito, situação na Receita Federal — tudo estruturado e pronto pra decisão.
Isso é o CreditHub MCP.
| Sem MCP | Com CreditHub MCP | |---------|-------------------| | Claude não tem acesso a dados de crédito | Claude consulta CPF/CNPJ em tempo real | | Você copia e cola dados manualmente | IA analisa e interpreta automaticamente | | Análise de crédito leva horas | Análise completa em segundos |
⚡ Início Rápido
1 minuto para dar superpoderes de análise de crédito ao seu Claude.
Configuração no Claude Desktop
Adicione ao seu arquivo de configuração:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"credithub": {
"command": "npx",
"args": ["-y", "credithub-mcp"],
"env": {
"CREDITHUB_API_KEY": "sua_api_key_aqui"
}
}
}
}🎁 Não tem API key? Cadastre-se grátis e ganhe R$50 em créditos para testar!
Requisitos
- Node.js 20+ instalado
- Conta no CreditHub
🛠 Ferramentas Disponíveis
credithub.consultarDocumento
A consulta mais completa de CPF/CNPJ do Brasil.
"Consulta o CPF 123.456.789-00"Retorna:
- ✅ Dados cadastrais (nome, nascimento, sexo, nome da mãe)
- ✅ Situação na Receita Federal
- ✅ Score de crédito
- ✅ Dívidas (PEFIN, REFIN, CCF)
- ✅ Protestos em cartório
- ✅ Processos judiciais
- ✅ Participações em empresas
- ✅ Histórico de consultas
credithub.findNameAddress
Localize pessoas pelo nome.
"Encontra endereços de João Silva em São Paulo"Retorna lista de possíveis matches com CPF e endereços.
credithub.query
Query customizada para power users.
"Execute: SELECT FROM 'INFO'.'INFO'"Acesso direto à linguagem de consulta do CreditHub para casos avançados.
🎯 Casos de Uso
| Setor | Aplicação | |-------|-----------| | Factoring/FIDC | Análise de risco de sacados e cedentes | | Cobrança | Localização de devedores, análise de patrimônio | | Compliance | KYC automatizado, due diligence | | Vendas B2B | Qualificação de leads, análise de crédito de clientes | | Jurídico | Pesquisa de processos, análise de partes |
📖 Documentação
Variáveis de Ambiente
| Variável | Descrição | Obrigatório |
|----------|-----------|-------------|
| CREDITHUB_API_KEY | Sua chave de API do CreditHub | ✅ |
Desenvolvimento Local
# Clone o repositório
git clone https://github.com/iCheques/credithub-mcp.git
cd credithub-mcp
# Instale as dependências
npm install
# Configure o .env
cp example.env .env
# Edite .env com sua CREDITHUB_API_KEY
# Teste o CLI
npm run start:stdioDocker
docker build -t credithub-mcp .
docker run -e CREDITHUB_API_KEY=sua_key credithub-mcp🔒 Segurança
- API key nunca é logada ou exposta
- Comunicação via HTTPS com servidores CreditHub
- Dados processados em tempo real, sem armazenamento local
- Compatível com LGPD
🤝 Sobre o CreditHub
O CreditHub é a plataforma líder de consultas de crédito para factorings, FIDCs, securitizadoras e ESCs no Brasil.
- 🏆 A consulta mais poderosa — tecnologia exclusiva de agregação de dados
- 💰 Melhor custo-benefício — até 90% mais barato que concorrentes
- 🔌 100% integrado — funciona com os principais ERPs do mercado
Cadastre-se grátis e ganhe R$50 em créditos →
📄 Licença
MIT © iCheques
Feito com ❤️ pelo time CreditHub
A melhor consulta de crédito do Brasil, agora potencializada por IA.
