KontragentPro
Datos de empresas rusas por INN/OGRN: detalles del registro, estados financieros de varios años, registros de quiebra, marcas comerciales e historial de inspecciones estatales, de registros oficiales abiertos.
Documentación
Servidor MCP KontragentPro
El servidor MCP KontragentPro permite verificar empresas rusas por INN directamente en el diálogo con el asistente de IA: usted pregunta sobre un contratante, el asistente consulta los registros y responde con datos del EGRUL, informes del Servicio Federal de Impuestos y el registro de quiebras. Se instala con una sola línea y funciona sin registro.
Instalación en Claude Desktop
Abra «Configuración → Developer → Edit Config» y agregue el servidor en la sección mcpServers. Reinicie la aplicación: las herramientas aparecerán en la lista.
{
"mcpServers": {
"kontragentpro": {
"command": "uvx",
"args": ["kontragentpro-mcp"]
}
}
}
El comando uvx descarga el paquete kontragentpro-mcp desde PyPI y lo ejecuta sin instalarlo en el sistema. Si prefiere pip — pip install kontragentpro-mcp, luego el comando kontragentpro-mcp.
Instalación en Cursor
«Settings → MCP → Add new server», tipo command, el mismo comando uvx kontragentpro-mcp. La configuración coincide con Claude Desktop, porque el servidor se comunica mediante stdio, el transporte estándar del Model Context Protocol.
Herramientas del servidor
El servidor declara cinco herramientas. El asistente elige la adecuada según la pregunta.
| Herramienta | Qué hace |
|---|---|
get_company | Tarjeta resumida de la entidad legal por INN en una sola consulta |
get_company_financials | Dinámica financiera plurianual del GIR BO del Servicio Federal de Impuestos |
get_company_timeline | Flujo de eventos: quiebras, inspecciones, marcas comerciales |
search_companies | Selección de entidades legales por ingreso anual (datos abiertos del Servicio Federal de Impuestos), región, OKVED, número de empleados |
check_account | Saldo de la cuota diaria según su clave |
Límites y clave
Sin clave hay 5 consultas por minuto disponibles — suficiente para probar, pero una verificación completa de una empresa requiere varias llamadas consecutivas. La clave gratuita eleva el límite a 60 consultas por minuto y 100 por día; se otorga de inmediato en su cuenta personal en la página para desarrolladores. La clave se transmite al servidor mediante la variable de entorno KONTRAGENTPRO_API_KEY.
Fuentes de datos
El servidor MCP no almacena datos: es un envoltorio sobre la API pública v2, que devuelve información de registros estatales — EGRUL del Servicio Federal de Impuestos, GIR BO del Servicio Federal de Impuestos (informes contables), EFRRSB (quiebras), ERKNM de la Fiscalía General (inspecciones), Rospatent (marcas comerciales), registros de sanciones y agentes extranjeros del Ministerio de Justicia. Cada bloque en la respuesta indica su fuente, por lo que el asistente puede referirse a ella en su respuesta. También publicamos los mismos registros como conjuntos agregados en la página de datos abiertos.
Si no necesita el asistente
Los mismos datos están disponibles sin instalar nada: abra la verificación por INN directamente en el sitio o seleccione empresas mediante el catálogo de entidades legales con filtros por ingreso anual, región y OKVED. Para integrarlo en su propia aplicación, use la API REST; las condiciones y límites del plan de pago están en la página de tarifas.
Preguntas frecuentes
Qué es MCP y para qué sirve
Model Context Protocol es un protocolo abierto mediante el cual el asistente de IA invoca herramientas externas. Sin él, el asistente responde sobre una empresa según los datos de entrenamiento, que pueden estar desactualizados. Con el servidor MCP KontragentPro, consulta los registros en el momento de la pregunta y responde con datos actualizados.
¿Se necesita una clave de API?
No. Sin clave funciona el acceso anónimo, 5 consultas por minuto. La clave es necesaria si alcanza el límite: con ella hay 60 consultas por minuto y 100 por día, de forma gratuita.
¿En qué clientes funciona?
En cualquier cliente MCP con transporte stdio: Claude Desktop, Cursor, Claude Code y otros. El servidor está publicado en el registro oficial de Model Context Protocol con el nombre io.github.kontragentpro/kontragentpro-mcp.
¿En qué se diferencia de la API REST?
Los datos y límites son los mismos. La API REST se invoca desde su código; el servidor MCP lo invoca el propio asistente, sin necesidad de escribir código. Si integra la verificación en su aplicación o CRM, use la API REST.
¿Se puede ver el código fuente?
Sí, el servidor es de código abierto bajo licencia MIT: github.com/kontragentpro/kontragentpro-mcp. El paquete se publica en PyPI, versión actual 0.2.2.