Checko MCP Server

MCP-сервер для Checko.ru API v2 — проверка российских компаний, ИП, физлиц и юридических данных прямо из любого AI-ассистента, поддерживающего Model Context Protocol.

Неофициальный community-проект. Не аффилирован с ООО «Чекко». Использует публичный API Checko.ru — нужен собственный API-ключ.

[!WARNING] Этот сервер — MCP-инструмент, а не самостоятельный агент. Данные берутся из API Checko.ru, но интерпретирует и излагает их AI-ассистент, к которому вы подключили сервер. AI-модели могут ошибаться: путать поля ответа, делать неверные выводы, галлюцинировать факты или пропускать важные детали. Перед принятием любых деловых, юридических или финансовых решений самостоятельно проверяйте ключевые сведения в первоисточниках (ЕГРЮЛ/ЕГРИП на сайте ФНС, КАД.Арбитр, ЕФРСБ и т. д.).

Что внутри

Сервер выставляет три типа возможностей MCP:

• 12 инструментов (tools) — прямой доступ к эндпоинтам Checko API.
• 6 готовых сценариев (prompts) — типовые workflow с уже зашитой последовательностью вызовов: check_counterparty, verify_bank_details, assess_bankruptcy_risk, audit_person, evaluate_tender_participant, analyze_finances.
• 5 справочных ресурсов (resources) — agent guide, правовая справка (152-ФЗ), методология аудита физлица.

Инструменты

Быстрый старт (Docker Compose)

Самый простой путь — собрать образ один раз и подключить как stdio-сервер.

1. Получите API-ключ Checko

checko.ru/user/account/api — потребуется регистрация.

2. Соберите образ

git clone https://github.com/Nymaxxx/checko-mcp.git
cd checko-mcp

cp .env.example .env
# отредактируйте .env: CHECKO_API_KEY=ваш_ключ

docker compose build

3. Подключите к MCP-клиенту

Откройте файл конфигурации MCP вашего AI-клиента (любого, поддерживающего stdio-серверы) и добавьте запись. Замените /абсолютный/путь/checko-mcp на путь к клонированному репозиторию:

{
  "mcpServers": {
    "checko": {
      "command": "docker",
      "args": [
        "compose",
        "-f", "/абсолютный/путь/checko-mcp/docker-compose.yml",
        "run", "--rm", "-i", "checko-mcp"
      ]
    }
  }
}

CHECKO_API_KEY подхватится из .env автоматически (через env_file в docker-compose.yml).

Проверьте — перезапустите MCP-клиент. Сервер должен появиться в списке доступных инструментов.

Альтернативные способы запуска

docker build -t checko-mcp:latest .

{
  "mcpServers": {
    "checko": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "CHECKO_API_KEY=ваш_ключ",
        "checko-mcp:latest"
      ]
    }
  }
}

git clone https://github.com/Nymaxxx/checko-mcp.git
cd checko-mcp

python -m venv .venv
source .venv/bin/activate        # Linux / macOS
# .venv\Scripts\activate         # Windows

pip install -e .

{
  "mcpServers": {
    "checko": {
      "command": "/абсолютный/путь/checko-mcp/.venv/bin/python",
      "args": ["-m", "checko_mcp"],
      "env": {
        "CHECKO_API_KEY": "ваш_ключ"
      }
    }
  }
}

{
  "mcpServers": {
    "checko": {
      "command": "uvx",
      "args": ["checko-mcp"],
      "env": { "CHECKO_API_KEY": "ваш_ключ" }
    }
  }
}

Готовые сценарии (prompts)

В большинстве случаев ручной pipeline не нужен — вызовите подходящий prompt, в котором уже зашита правильная последовательность инструментов и шаблон финального ответа.

В большинстве MCP-клиентов prompts видны как явные команды (slash-меню) и появляются в списке после подключения сервера.

Справочные ресурсы

Сервер также экспонирует markdown-справочники, которые AI-клиент может подгрузить в контекст:

Конфигурация

Документация

• docs/examples.md — комплексные примеры использования (распутывание схемы, batch-фильтрация, анализ номинала, реконструкция нарратива)
• docs/api/ — справочник по эндпоинтам Checko API
• docs/instructions/agent-guide.md — agent guide (он же экспонируется как ресурс checko://docs/agent-guide)
• playbooks/audit/ — методология и шаблоны аудита физлица (экспонируется как ресурсы checko://playbooks/audit/*)
• AGENTS.md — соглашения по коду и инструкции для разработчика
• CHANGELOG.md — история версий
• CONTRIBUTING.md — как внести вклад
• SECURITY.md — как сообщить об уязвимости
• LEGAL.md — правовые основания (152-ФЗ, 149-ФЗ)

Разработка

git clone https://github.com/Nymaxxx/checko-mcp.git
cd checko-mcp

python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

ruff check src/ tests/
pytest -q

CI прогоняет lint + тесты на Python 3.10–3.13 для каждого PR.

Правовые ограничения

Сервер предоставляет доступ к публично раскрытым сведениям государственных реестров (ЕГРЮЛ, ЕГРИП, ГИР БО ФНС, Росстат, КАД, ЕФРСФДЮЛ, ЕФРСБ).

• Использование данных о физических лицах регулируется Федеральным законом от 27.07.2006 № 152-ФЗ «О персональных данных». Пользователь самостоятельно обеспечивает соответствие своей деятельности требованиям законодательства.
• Сервер является программной обёрткой над API Checko.ru. Пользователь обязан ознакомиться с условиями использования Checko.ru и соблюдать их.
• Массовый автоматизированный сбор персональных данных физических лиц без законного основания недопустим.

Подробнее — LEGAL.md.

Лицензия

MIT.