IA & Agentes
O CPFHub.io foi projetado para funcionar nativamente com agentes de IA. Temos suporte oficial para os principais frameworks e protocolos usados por LLMs modernos.
O que está disponível
| Ferramenta | Descrição | Instalação |
|---|---|---|
| MCP Server | Servidor Model Context Protocol oficial | https://api.cpfhub.io/mcp |
| Agent Skills | Definições de tool para Claude, GPT-4 e outros | Agent Skills |
| OpenAPI 3.1 | Spec da API para geração automática de clients | /openapi.json |
| llms.txt | Índice da documentação legível por máquina | /llms.txt |
Casos de uso com agentes de IA
Onboarding conversacional: Um agente de onboarding pede o CPF do usuário durante o chat e valida a identidade na hora, sem sair do fluxo de conversa.
Prevenção de fraude autônoma: Um agente de compliance monitora transações e consulta identidades suspeitas automaticamente antes de aprovar.
Atendimento ao cliente: Um assistente de suporte confirma a identidade do cliente pelo CPF antes de acessar dados sensíveis da conta.
Automações no-code: Fluxos em n8n, Make ou Zapier que validam CPFs como parte de workflows maiores de captação ou cadastro.
Ferramentas disponíveis
O MCP Server remoto expõe nove tools para agentes de IA, com o mesmo custo e os mesmos limites da API REST:
| Tool | Descrição | Custo |
|---|---|---|
lookup_cpf | Consulta Simples: nome, gênero e data de nascimento a partir de um CPF | 1 crédito por CPF encontrado |
lookup_cpf_realtime | Consulta em Tempo Real na Receita Federal (CPF + data de nascimento): situação cadastral, ano do óbito (deathYear, inteiro ou null), código de controle e comprovante | 1,5 crédito por consulta bem-sucedida |
lookup_cnpj | Consulta de CNPJ: razão social, situação cadastral, endereço, CNAEs e sócios | 1 crédito por CNPJ encontrado |
bulk_lookup_cpf | Lote de até 10.000 CPFs (Consulta Simples), assíncrono | 1 crédito por CPF encontrado |
bulk_lookup_cnpj | Lote de até 10.000 CNPJs, assíncrono | 1 crédito por CNPJ encontrado |
get_bulk_job | Status e resultados de um lote de CPF ou CNPJ | Grátis |
create_kyc_link | Cria um link de Verificação de Identidade (selfie com prova de vida e documento) | Grátis para criar; 5 créditos por verificação concluída |
get_kyc_link | Status e decisão de um link de Verificação de Identidade | Grátis |
get_quota_info | Plano, créditos restantes e usados e status de cobrança | Grátis |
Os custos acima são os padrões; o do seu plano fica no dashboard. Parâmetros e respostas de cada tool estão em MCP Server.
Próximos passos
- MCP Server: configure o servidor MCP em Claude Desktop, Claude Code, Cursor ou qualquer cliente MCP
- Agent Skills: definições de tool para usar diretamente em prompts de sistema
- Biblioteca de Prompts: prompts prontos para casos de uso comuns
- Plataformas: n8n, Make, Zapier, LangChain
Atualizado em 13 de novembro de 2026