KontragentPro

Servidor MCP KontragentPro

O servidor MCP KontragentPro permite verificar empresas russas por INN diretamente no diálogo com o assistente de IA: você pergunta sobre o contraparte, o assistente consulta os registros por conta própria e responde com dados do EGRUL, relatórios da Receita Federal e do registro de falências. Instala-se com uma única linha de comando e funciona sem cadastro.

Instalação no Claude Desktop

Abra "Configurações → Developer → Edit Config" e adicione o servidor na seção mcpServers. Reinicie o aplicativo — as ferramentas aparecerão na lista.

{
  "mcpServers": {
    "kontragentpro": {
      "command": "uvx",
      "args": ["kontragentpro-mcp"]
    }
  }
}

O comando uvx baixa o pacote kontragentpro-mcp do PyPI e o executa sem instalá-lo no sistema. Se preferir pip — pip install kontragentpro-mcp, depois o comando kontragentpro-mcp.

Instalação no Cursor

"Settings → MCP → Add new server", tipo command, o mesmo comando uvx kontragentpro-mcp. A configuração é idêntica à do Claude Desktop, pois o servidor se comunica via stdio — o transporte padrão do Model Context Protocol.

Ferramentas do servidor

O servidor declara cinco ferramentas. O assistente escolhe a adequada por conta própria, com base na pergunta.

Ferramenta	O que faz
get_company	Cartão resumido da pessoa jurídica por INN em uma única consulta
get_company_financials	Dinâmica financeira plurianual do GIR BO da Receita Federal
get_company_timeline	Fluxo de eventos: falências, auditorias, marcas registradas
search_companies	Seleção de pessoas jurídicas por receita anual (dados abertos da Receita Federal), região, OKVED, número de funcionários
check_account	Saldo da cota diária da sua chave

Limites e chave

Sem chave, estão disponíveis 5 consultas por minuto — o suficiente para testar, mas uma verificação completa de empresa consome várias chamadas seguidas. A chave gratuita eleva o limite para 60 consultas por minuto e 100 por dia; é emitida imediatamente no painel pessoal na página para desenvolvedores. A chave é passada ao servidor pela variável de ambiente KONTRAGENTPRO_API_KEY.

Fontes de dados

O servidor MCP não armazena dados: é um wrapper sobre a API pública v2, que fornece informações dos registros estaduais — EGRUL da Receita Federal, GIR BO da Receita Federal (demonstrações contábeis), EFRBS (falências), ERKNM da Procuradoria-Geral (auditorias), Rospatent (marcas registradas), registros de sanções e agentes estrangeiros do Ministério da Justiça. Cada bloco na resposta indica a fonte, para que o assistente possa referenciá-la em sua resposta. Também disponibilizamos esses registros como conjuntos agregados na página de dados abertos.

Se o assistente não for necessário

Os mesmos dados estão disponíveis sem instalar nada: abra a verificação por INN diretamente no site ou selecione empresas pelo catálogo de pessoas jurídicas com filtros por receita anual, região e OKVED. Para integrar ao seu aplicativo, use a REST API; os termos e limites do plano pago estão na página de tarifas.

Perguntas frequentes

O que é MCP e para que serve

O Model Context Protocol é um protocolo aberto pelo qual o assistente de IA chama ferramentas externas. Sem ele, o assistente responde sobre a empresa com base na memória dos dados de treinamento, e as informações ficam desatualizadas. Com o servidor MCP KontragentPro, ele consulta os registros no momento da pergunta e responde com dados atualizados.

É necessário uma chave de API

Não. Sem chave, o acesso anônimo funciona com 5 consultas por minuto. A chave é necessária se você atingir o limite: com ela, 60 consultas por minuto e 100 por dia, gratuitamente.

Em quais clientes funciona

Em qualquer cliente MCP com transporte stdio: Claude Desktop, Cursor, Claude Code e outros. O servidor está publicado no registro oficial do Model Context Protocol sob o nome io.github.kontragentpro/kontragentpro-mcp.

Qual a diferença para a REST API

Os dados e limites são os mesmos. A REST API é chamada a partir do seu código; o servidor MCP é chamado pelo próprio assistente, sem necessidade de escrever código. Se você estiver integrando a verificação ao seu aplicativo ou CRM, use a REST API.

Posso ver o código-fonte

Sim, o servidor é aberto sob a licença MIT: github.com/kontragentpro/kontragentpro-mcp. O pacote é publicado no PyPI, versão atual 0.2.2.