@theyahia/kontur-focus-mcp

MCP server for Kontur.Focus API -- company search, brief reports, financial analytics, founders, and counterparty reliability checks for Russian legal entities.

Supports stdio and Streamable HTTP transports.

Part of the Russian API MCP series alongside @theyahia/dadata-mcp, @theyahia/huntflow-mcp, @theyahia/superjob-mcp, and @theyahia/yookassa-mcp.

Tools (6)

Tool	Description
`search_company`	Search company by INN or OGRN
`search_by_name`	Search companies by name
`get_brief_report`	Brief risk report by INN
`get_analytics`	Financial analytics (revenue, profit, assets) by INN
`get_founders`	Get founders and management by INN
`check_reliability`	Counterparty reliability check by INN

Examples

Проверь ИНН 7707083893
Покажи финансы компании 7707083893
Найди компанию "Сбербанк"
Кто учредители компании с ИНН 7707083893?
Проверь надёжность контрагента 7707083893

Install

Claude Desktop / Cline / Cursor (stdio)

Add to your MCP config:

{
  "mcpServers": {
    "kontur-focus": {
      "command": "npx",
      "args": ["-y", "@theyahia/kontur-focus-mcp"],
      "env": { "KONTUR_FOCUS_API_KEY": "<YOUR_API_KEY>" }
    }
  }
}

Streamable HTTP

KONTUR_FOCUS_API_KEY=your_key npx @theyahia/kontur-focus-mcp --http

Server starts on http://localhost:3000/mcp (override port with PORT env var).

Health check: GET /health

Smithery

npx -y @smithery/cli install @theyahia/kontur-focus-mcp --client claude

Environment Variables

Variable	Required	Description
`KONTUR_FOCUS_API_KEY`	Yes	API key from Kontur.Focus
`PORT`	No	HTTP port (default: 3000, only for `--http` mode)

Skills

skill-check-company

"Проверь компанию по ИНН — статус, руководитель, финансы"

Combines search_company + get_brief_report + get_analytics to produce a full company dossier.

skill-find-counterparty

"Найди контрагента по названию"

Uses search_by_name to find companies, then check_reliability for due diligence.

Synergy with dadata-mcp

Use dadata-mcp to resolve a company name, address, or partial input into an INN, then pass that INN to kontur-focus-mcp for deep due diligence:

suggest_company (dadata-mcp) -- find the company and get its INN
search_company (kontur-focus-mcp) -- full registration data
get_brief_report -- risk summary
get_analytics -- financials
get_founders -- management and ownership
check_reliability -- counterparty check

This two-server combo gives AI agents a complete Russian company intelligence pipeline.

API Reference

Base URL: https://focus-api.kontur.ru/api3/

Docs: https://focus-api.kontur.ru/

License

MIT

kontur-focus-mcp

Quick Install