apipj

Datos de empresas brasileñas (CNPJ) de datos abiertos de la Receita Federal: consulta, validación de CNPJ alfanumérico y estado de carga de datos. Plan gratuito: 50 mil consultas/mes.

Ver en apipj.com.br

Servidor MCP alojado

npx add-mcp 'https://apipj.com.br/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Guias · Por apipj (MASTER BI TECNOLOGIA LTDA) · actualizado en · 5 min de lectura · Código ejecutado contra la API en (Claude Code 2.1.296, curl)

Consultar CNPJ en Claude y en agentes de IA con el servidor MCP de apipj

apipj tiene un servidor MCP (Model Context Protocol) en https://apipj.com.br/mcp. Con él, un agente de IA como Claude Code consulta los datos registrales de un CNPJ, verifica el dígito verificador y ve de qué mes es la base, sin que escribas código de integración. Los datos son los mismos de la API: datos abiertos de la Receita Federal, carga de septiembre de 2026.

Las tres herramientas

Herramienta	Qué hace	¿Necesita cuenta?
`validar_cnpj`	Verifica formato y dígitos verificadores, incluso del CNPJ alfanumérico. Igual que `GET /v1/valida/{cnpj}`.	No, y no gasta cuota
`status_base`	Muestra el mes de la carga y el total de CNPJs en la base. Igual que `GET /v1/status`.	No
`consultar_cnpj`	Devuelve el documento del CNPJ, en el formato `completo` (estándar) o `simplificado`. Igual que `GET /v1/cnpj/{cnpj}`.	Sí: inicio de sesión en Claude o clave de API

Las tres son solo de lectura. consultar_cnpj usa la cuota y el límite por minuto de tu cuenta, sumados a las llamadas que haces por la API: en el plan gratuito, 10 por minuto y 50.000 al mes.

Usar en Claude (claude.ai, Desktop y móvil)

En Personalizar > Conectores, elige Añadir conector personalizado e informa la URL https://apipj.com.br/mcp. validar_cnpj y status_base ya funcionan. En la primera consulta de CNPJ, Claude muestra el botón Conectar: abre la página de apipj, donde entras con Continuar con Google (sin cuenta, se crea al momento, gratis) o con correo y contraseña y haces clic en Autorizar. No hay clave que copiar, y la consulta continúa sola después del inicio de sesión. El conector aparece en el panel, en Aplicaciones conectadas, donde puedes desconectarlo.

Instalar en VS Code o en Cursor

Los enlaces de abajo abren el editor con el servidor ya configurado; confirma la instalación en la ventana que aparezca.

Instalar en VS Code (modo agente de Copilot)
Instalar en Cursor, o mediante el plugin de apipj en Cursor Directory, que incluye también una regla para que el agente escriba integraciones con la API

En la primera consulta de CNPJ, el editor pide conectar la cuenta de apipj, como en Claude. Si prefieres configurar manualmente, el servidor es https://apipj.com.br/mcp (HTTP).

Instalar en Claude Code

La forma más corta es registrar el servidor sin cabecera: en la primera consulta (o con /mcp en una sesión interactiva), Claude Code abre el navegador en el mismo inicio de sesión de apipj.

claude mcp add --transport http apipj https://apipj.com.br/mcp

Si prefieres la clave de API (por ejemplo, en una máquina sin navegador):

Crea una cuenta gratis y copia la clave (apipj_live_...).
Deja la clave en una variable de entorno y registra el servidor:

export APIPJ_KEY="apipj_live_sua_chave"
claude mcp add --transport http apipj https://apipj.com.br/mcp --header "Authorization: Bearer $APIPJ_KEY"
claude mcp list

El último comando debe mostrar apipj: https://apipj.com.br/mcp (HTTP) - ✔ Connected. A partir de ahí, pide en lenguaje natural, por ejemplo: "consulta el CNPJ 00.000.000/0001-91 y dime la situación registral y el municipio".

Otros clientes MCP

Los clientes que siguen la autorización OAuth del MCP descubren el inicio de sesión solos: apunta a https://apipj.com.br/mcp y, en la primera consulta, abren la misma página de autorización. Los demás funcionan si permiten definir una cabecera: envía Authorization: Bearer <sua chave>. El servidor no guarda sesión: cada solicitud es independiente.

Los clientes sin OAuth y sin cabecera personalizada pueden usar solo validar_cnpj y status_base.

Probar sin cliente MCP

Para comprobar que el servidor responde, llama a la herramienta abierta con curl:

curl -s https://apipj.com.br/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"validar_cnpj","arguments":{"cnpj":"12.ABC.345/01DE-35"}}}'

La respuesta trae "valido":true, "alfanumerico":true y "formatado":"12.ABC.345/01DE-35". Para consultar_cnpj, añade la cabecera Authorization: Bearer $APIPJ_KEY.

Lo que recibe el agente cuando algo sale mal

Sin cuenta conectada, consultar_cnpj recibe HTTP 401 con la solicitud de inicio de sesión: en Claude, aparece el botón Conectar; los clientes sin OAuth reciben una frase que explica cómo informar la clave. Los demás errores vuelven como resultado de la herramienta (isError: true) con una frase que el propio agente puede transmitir:

Situación	Qué ocurre
Clave inválida o CNPJ con dígito incorrecto	Explica el problema; no se cobra de la cuota
CNPJ fuera de la base	Avisa que el CNPJ no se encontró en la carga actual
Límite por minuto	Informa cuántos segundos esperar
Cuota del mes agotada	Informa la fecha de renovación y el enlace de precios

validar_cnpj con un número inválido no es un error: la respuesta viene normal, con "valido":false y el motivo.

¿Necesitas más consultas por minuto?

El límite por minuto y la cuota del mes son los del plan de tu cuenta, y valen para el MCP y para la API juntos. Si el agente empieza a recibir "límite por minuto" con frecuencia, o si la cuota se acaba antes de fin de mes, el camino es cambiar de plan. El checkout abre directo, y la misma cuenta (con el inicio de sesión en Claude o con la clave) pasa a tener el nuevo límite en cuanto se confirma el pago:

Plan	Consultas por minuto	Consultas por mes	Precio	Suscribirse
Gratuito	10	50.000	gratis	crear cuenta
Dev	30	200.000	R$ 12,90/mes	suscribirse a Dev
Pro	200	600.000	R$ 59,90/mes	suscribirse a Pro

Si aún no has iniciado sesión, el enlace pide el inicio de sesión y vuelve directo al pago. Detalles en precios.

Límites y cuidados

Ritmo: además del límite de tu plan, el servidor acepta hasta 120 solicitudes por minuto por IP sin credencial y 3.000 con credencial.
Datos de socios: el formato completo trae el cuadro societario exactamente como la Receita lo publica, con CPF enmascarado. Cuando el agente solo esté verificando situación o dirección, prefiere el formato simplificado y no pidas más datos de los necesarios. Consulta la política de privacidad.
Frescura: la base es mensual. Para prueba oficial de la situación de una empresa, vale el comprobante emitido en el sitio de la Receita.

Próximos pasos

Documentación de la API: los mismos datos por HTTP, con todos los campos.
OpenAPI pública: especificación para generadores de clientes y agentes que leen OpenAPI.
Validar proveedor por CNPJ: un buen guion para pedir al agente.