CPFHub.io

API de consulta de CPF brasileño con servidor MCP para agentes de IA

SaaS

Sobre CPFHub.io

CPFHub.io es una API REST para consultar datos del CPF brasileño, con un servidor MCP para que agentes de IA la usen como herramienta (https://api.cpfhub.io/mcp). La consulta simple devuelve nombre, género y fecha de nacimiento en unos 150 ms, y la consulta en tiempo real verifica la situación del registro y el año de fallecimiento directamente en la Receita Federal en cerca de un segundo. Consultas en lote de hasta 10.000 CPF. Plan gratuito con 50 créditos al mes, sin tarjeta; planes pagos desde unos US$4 al mes.

¿Qué es CPFHub.io?

CPFHub.io es una API REST para consultar datos asociados al CPF, el número de registro de personas físicas de Brasil. Con una sola llamada se obtiene, en formato JSON, el nombre completo, el género y la fecha de nacimiento del titular; el tiempo de respuesta típico que indica la empresa es de unos 150 ms. Además de la ruta simple, ofrece una consulta en tiempo real que va directamente a la Receita Federal y devuelve la situación del registro (regular, suspenso, pendiente, cancelado, nulo o titular fallecido), el año de fallecimiento en el campo deathYear y un comprobante con código de control y enlace de verificación en el sitio de la Receita.

Las tres modalidades —simple, tiempo real y lote— comparten la misma clave de API, el mismo saldo de créditos y un único panel. La consulta en lote procesa hasta 10.000 CPF por envío mediante un job asíncrono, con exportación en CSV, y el panel permite consultar sin escribir código: de a un CPF o subiendo un archivo .csv o .txt.

El servicio también expone un servidor MCP (https://api.cpfhub.io/mcp) para que agentes como Claude o Cursor usen la consulta de CPF como herramienta dentro de sus flujos. Cada consulta queda registrada en el historial del panel para auditoría y exportación, y la empresa indica que el servicio opera conforme a la LGPD, dejando en manos del cliente la definición de la base legal de cada consulta.

Características principales de CPFHub.io

Consulta simple por CPF que devuelve nombre, género y fecha de nacimiento en JSON, con tiempo de respuesta típico cercano a 150 ms.
Consulta en tiempo real contra la Receita Federal que informa situación cadastral, año de fallecimiento y comprobante con código de control, en alrededor de un segundo.
Consulta en lote de hasta 10.000 CPF por envío mediante job asíncrono, con los mismos campos de la consulta simple y exportación en CSV.
Servidor MCP para que agentes de IA como Claude o Cursor ejecuten consultas de CPF como herramienta.
Panel web con historial de todas las consultas, consulta manual y carga de archivos .csv o .txt, sin necesidad de programar.
Una sola clave de API y un único saldo de créditos para todas las modalidades, con ejemplos de integración en cURL, Node.js, Python, PHP, Java, Go, Ruby, .NET, Elixir y Rust.

¿Para quién es CPFHub.io?

Está pensado para equipos de desarrollo y producto que operan en Brasil o atienden a usuarios brasileños y necesitan validar identidad a partir del CPF: comercio electrónico, recursos humanos, inmobiliarias, seguros, salud, delivery, streaming y plataformas con restricción de edad. También sirve a equipos no técnicos de operaciones o compliance, que pueden usar el panel y la carga de archivos sin escribir código, y a quienes construyen agentes de IA y quieren incorporar la verificación de CPF mediante MCP.

Casos de uso

Validar en el momento del registro que el nombre y la fecha de nacimiento declarados coinciden con el CPF, como control antifraude antes de cerrar una contratación o compra.
Confirmar la mayoría de edad de un usuario a partir de la fecha de nacimiento vinculada al CPF en plataformas con contenido o premios restringidos.
Limpiar y completar una base existente de clientes enviando hasta 10.000 CPF por lote y exportando el resultado en CSV.
Comprobar la situación cadastral o un posible fallecimiento antes de una decisión que requiera comprobante oficial, como una admisión laboral o un contrato.

Precio de CPFHub.io

El plan gratuito incluye 50 créditos mensuales sin tarjeta de crédito, con SLA de 95%; la consulta simple consume 1 crédito y la consulta en tiempo real 1,5 crédito. El plan PRO parte de R$ 19 al mes con 100 créditos y llega hasta tramos de 10.000 créditos (por ejemplo, R$ 149 al mes por 1.000 créditos), con SLA de 99% y precio por crédito que baja de R$ 0,19 a R$ 0,10 según el tramo. El plan Corporativo, para más de 10.000 créditos mensuales, tiene precio negociado y SLA de 99,9%.

¿CPFHub.io está disponible en español?

SíEl sitio de CPFHub.io ofrece versión en español además de portugués e inglés, aunque el producto trabaja con datos del registro brasileño y la atención se brinda por WhatsApp y correo.

Preguntas frecuentes sobre CPFHub.io

¿Qué diferencia hay entre la consulta simple y la consulta en tiempo real?: La consulta simple solo recibe el CPF y responde con nombre, género y fecha de nacimiento desde la base de validación de CPFHub.io, en unos 150 ms típicos. La consulta en tiempo real exige también la fecha de nacimiento, va a la Receita Federal en el momento del pedido y devuelve situación cadastral, año de fallecimiento y comprobante, en cerca de un segundo.
¿Se puede probar sin pagar ni dejar tarjeta?: Sí: al crear una cuenta gratuita se reciben 50 créditos por mes sin tarjeta de crédito, y la clave de API queda disponible en el panel de inmediato.
¿Cuándo se descuentan créditos?: En la consulta simple y en lote el crédito se cobra solo cuando el CPF es encontrado; los CPF no encontrados o con formato inválido no se cobran. En la consulta en tiempo real se cobran 1,5 crédito únicamente con respuesta HTTP 200, por lo que una fecha de nacimiento que no coincide (HTTP 422) o una falla de comunicación con la Receita no generan cargo.
¿Hay límites de requisiciones?: Sí, por minuto y por clave de API: 30 requisiciones por minuto en la consulta simple (cada lote cuenta como una) y 5 en la consulta en tiempo real, ajustables en planes personalizados.