Checko MCP Server

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

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

Что внутри

Сервер выставляет три типа возможностей 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-ФЗ), методология аудита физлица.

Инструменты

Быстрый старт

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

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

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

Самый простой способ — через uvx (не нужен git clone, Docker или venv). Добавьте запись в конфиг MCP вашего AI-клиента:

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

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

Нет uvx? Установите uv — он включает uvx.

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

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

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

docker compose build

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

CHECKO_API_KEY подхватится из .env автоматически.

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": "ваш_ключ"
      }
    }
  }
}

На Windows путь до интерпретатора выглядит так: C:\\путь\\checko-mcp\\.venv\\Scripts\\python.exe.

Готовые сценарии (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.