atomno-mcp-zakupki

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

Russian public procurement search for AI agents.

Установили локально, прописали в конфиге Cursor / Claude Desktop / Cline —

и в одном промпте просите: *«Покажи свежие тендеры за сегодня по ОКПД2

62.0 в Москве с НМЦК ≤ 5 млн ₽»*. Сервер сходит в выбранный источник

данных, нормализует ответ и вернёт LLM готовую структуру.

Зачем

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

> Production: рекомендуется корпоративный API Atomno (`MCP_ZAKUPKI_API_KEY` на

> `api.atomno-mcp.ru/zakupki/`).

> Self-hosted (свой ключ DaMIA/ГосПлан) — для разработки и пилотов; агрегированная

> аналитика и расширенные отчёты доступны через корпоративный endpoint.

> v0.1.1: убран неофициальный HTML-парсинг ЕИС. Инструменты `get_customer_history`

> и `get_supplier_stats` требуют корпоративного API-ключа.

Quick start

1. Установка

# Через uvx (рекомендуется — без установки в систему):
uvx atomno-mcp-zakupki --help

# Через pipx:
pipx install atomno-mcp-zakupki
atomno-mcp-zakupki --version

# В виртуальное окружение проекта:
pip install atomno-mcp-zakupki

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

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

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

Для production — получите hosted Pro-ключ:

`atomno-mcp.ru/pricing#zakupki-pro`

→ `MCP_ZAKUPKI_API_KEY`.

Для разработки (self-hosted) — ключ одного API-провайдера

(DaMIA / ГосПлан / navodki) для `search_tenders` и `get_tender`.

Без ключей работает только `lookup_okpd2` (локальный справочник ОКПД2).

> HTML-fallback удалён в v0.1.1. Парсинг `zakupki.gov.ru` без API —

> только на hosted backend (private server, Phase 2).

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

Откройте `~/.cursor/mcp.json` (или `Cursor → Settings → Model Context

Protocol`) и добавьте:

{
  "mcpServers": {
    "zakupki": {
      "command": "uvx",
      "args": ["atomno-mcp-zakupki"],
      "env": {
        "MCP_ZAKUPKI_DAMIA_KEY": "your-damia-key-here",
        "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 --help
atomno-mcp-zakupki --version
atomno-mcp-zakupki --check-config
atomno-mcp-zakupki --log-level DEBUG
atomno-mcp-zakupki --transport http --host 127.0.0.1 --port 8765
atomno-mcp-zakupki --transport sse --port 9000

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

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

Цепочка BYOK: `MCP_ZAKUPKI_PROVIDERS=damia,gosplan,navodki`.

HTML-scraping удалён в v0.1.1 — используйте hosted Pro.

Если ни один не отвечает, тулза вернёт типизированную ошибку

`provider_unavailable`.

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

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.git
cd mcp-zakupki

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

pip install -e ".[dev]"
pytest -v --cov=src/mcp_zakupki
ruff check src tests

Disclaimer

• Сервис не аффилирован с Министерством финансов РФ, ФАС, оператором ЕИС

или конкретными ЭТП.

• Данные ЕИС получаем через лицензированные API-провайдеры, официальный

ЕИС-токен или hosted backend Atomno — не через scraping open-клиента.

• HTML-fallback убран в v0.1.1 (соответствие ToS реестра закупок).
• Используйте на свой риск. Решения о подаче заявок на тендеры — на

ответственности пользователя.

Лицензия

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-досье по тендеру за один промпт.