mcp-zakupki

atomno-mcp-zakupki

MCP-сервер госзакупок: поиск тендеров на zakupki.gov.ru, история заказчиков и поставщиков, справочник ОКПД2. Законы 44-ФЗ, 223-ФЗ и 615-ПП — прямо в Cursor, Claude и любом клиенте MCP.

Russian public procurement search for AI agents.

[PyPI version] [License: MIT] [Python 3.11+] [MCP]

Установили локально, прописали в конфиге Cursor / Claude Desktop / Cline — и в одном промпте просите: «Покажи свежие тендеры за сегодня по ОКПД2 62.0 в Москве с НМЦК ≤ 5 млн ₽». Сервер сходит в выбранный источник данных, нормализует ответ и вернёт LLM готовую структуру.

Зачем

Что внутри (open-клиент)

Источник по умолчанию — официальный сайт ЕИС. Покупной посредник отключён. Сводка объёмов и статистика поставщика без токена машинного обмена недоступны.

Quick start

1. Установка

# Через uvx (рекомендуется — без установки в систему):uvx atomno-mcp-zakupki --help
# Через pipx:pipx install atomno-mcp-zakupkiatomno-mcp-zakupki --version
# В виртуальное окружение проекта:pip install atomno-mcp-zakupki

Опциональный экстра для официального ЕИС-токена (требует сертификат Минфина):

pip install "atomno-mcp-zakupki[eis-official]"

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

Поиск и карточка закупки работают без ключа — источник zakupki.gov.ru. Покупной посредник и SOAP-токен ЕИС не обязательны.

3. Подключение к Cursor

Откройте ~/.cursor/mcp.json (или Cursor → Settings → Model Context Protocol) и добавьте:

{  "mcpServers": {    "zakupki": {      "command": "uvx",      "args": ["atomno-mcp-zakupki"],      "env": {        "MCP_ZAKUPKI_LOG_LEVEL": "INFO"      }    }  }}

4. Подключение к Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json (Windows) или ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

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

5. Подключение к Cline / Goose / Kiro

Любой MCP-клиент: запустите atomno-mcp-zakupki (по умолчанию stdio транспорт) и пропишите в его конфиге команду запуска.

Для HTTP-режима:

atomno-mcp-zakupki --transport http --host 127.0.0.1 --port 8765

Примеры

Утренний мониторинг тендеров

[Cursor]: Покажи свежие тендеры за сегодня по ОКПД2 62.0 в УрФО          с НМЦК 500K-3M ₽, СМП-only.
→ search_tenders(    okpd2_codes=["62.01", "62.02", "62.09"],    regions=["66", "74", "59", "45", "72", "86", "89"],    price_min_rub=500000, price_max_rub=3000000,    smp_only=True,    publish_date_from="2026-04-26",    status=["applications_open"]  )← 7 тендеров найдено за 412 мс.

Карточка тендера

[Cursor]: Расскажи подробно про реестровый номер 0173100007426000018.
→ get_tender(reg_number="0173100007426000018", include_documents=True)← Все поля: заказчик, НМЦК, документация (PDF), сроки, площадка...

Анализ заказчика (Pro)

[Cursor]: Кто такой ИНН 7449023800? Покажи историю закупок за 2 года.
→ get_customer_history(inn="7449023800", period_from="2024-01-01")← Требуется MCP_ZAKUPKI_API_KEY (hosted Pro).

Подбор кода ОКПД2

[Cursor]: Какой ОКПД2 у разработки веб-портала?
→ lookup_okpd2(query="разработка веб-портала", limit=5)← [{"code":"62.01.11.000","name":"Услуги по проектированию ИС","match":0.94}, ...]

CLI

atomno-mcp-zakupki --helpatomno-mcp-zakupki --versionatomno-mcp-zakupki --check-configatomno-mcp-zakupki --log-level DEBUGatomno-mcp-zakupki --transport http --host 127.0.0.1 --port 8765atomno-mcp-zakupki --transport sse --port 9000

Полный список опций — в atomno-mcp-zakupki --help.

Источники данных

Цепочка по умолчанию: MCP_ZAKUPKI_PROVIDERS=eis_public. Если источник не ответил, тулза вернёт типизированную ошибку provider_unavailable или not_implemented — не пустой список.

Архитектура (вкратце)

AI-клиент (Cursor / Claude / Cline) ──MCP──▶ atomno-mcp-zakupki                                              │                                              ├──▶ lookup_okpd2 (offline)                                              ├──▶ Self-hosted API (search/get)                                              └──▶ hosted Pro (api.atomno-mcp.ru) — production

Все провайдеры реализуют общий BaseProvider-интерфейс. Ответы нормализуются в Pydantic-модели Tender, Customer, Document, OrgHistorySummary.

Разработка

git clone https://github.com/atomno-mcp/mcp-zakupki.gitcd mcp-zakupki
python -m venv .venvsource .venv/bin/activate            # Linux/macOS# .venv\Scripts\activate              # Windows
pip install -e ".[dev]"pytest -v --cov=src/mcp_zakupkiruff check src tests

Disclaimer

• Сервис не аффилирован с Министерством финансов РФ, ФАС, оператором ЕИС или конкретными ЭТП.
• Данные берём с официального сайта ЕИС (zakupki.gov.ru) по обычным публичным адресам, с официальными корневыми сертификатами Минцифры.
• Машинный обмен SOAP требует токен и регистрацию на портале — без этого сводка объёмов и статистика поставщика недоступны.
• Используйте на свой риск. Решения о подаче заявок на тендеры — на ответственности пользователя.

Лицензия

MIT © 2026 Atomno.

Семья MCP-серверов atomno

atomno-mcp-zakupki — пятый сервер семьи atomno-mcp-*:

• atomno-mcp-cbr-rates — курсы ЦБ РФ
• atomno-mcp-egrul — реквизиты юр.лиц из ЕГРЮЛ
• atomno-mcp-fns-check — налоговая благонадёжность
• atomno-mcp-fssp — задолженности и исп. производства (готовится)
• atomno-mcp-zakupki — вы здесь
• atomno-mcp-rosreestr — недвижимость, кадастр (готовится)
• atomno-mcp-sudact — судебная практика (готовится)

Подключите все вместе — и получите полное B2G-досье по тендеру за один промпт.