Back to Directory/Other

mcp-zakupki

MCP server for Russian government procurement data (44-FZ / 223-FZ / 615-PP).

OtherPythonv0.2.0
View on GitHub

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 готовую структуру.

Зачем

БольСейчасС atomno-mcp-zakupki
Каждое утро 30–60 мин просеивать ЕИС вручную или платить 16–67 K ₽/год за Контур / SeldonExcel-сводки + email-уведомленияОдин MCP-вызов из Cursor → LLM сама фильтрует, объясняет, сравнивает
Скрипты на Python с ftp.zakupki.gov.ru сломались с января 2025Ищут замену через коммерческие APIОфициальный сайт ЕИС: поиск, XML-карточка, карточка организации
AI-агент не может прочитать тендер самКопи-паст в чатget_tender(reg_number) отдаёт всю карточку как JSON

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

ToolЧто делает
search_tendersПоиск закупок на официальном сайте zakupki.gov.ru. Ключ не нужен.
get_tenderКарточка закупки по реестровому номеру (официальная XML-печатная форма).
lookup_okpd2Поиск кода ОКПД2 / КТРУ по тексту (локальный справочник, без сети).
get_customer_historyКарточка заказчика по ИНН и статус в реестре недобросовестных. Сводку объёмов сайт не считает.
get_supplier_statsСводка по поставщику. Без токена машинного обмена ЕИС недоступна — тулза вернёт отказ, не нули.

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

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. Конфигурация

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

ПеременнаяОписаниеГде взять
MCP_ZAKUPKI_DAMIA_KEYAPI-ключ DaMIA API-Закупкиhttps://damia.ru/apizakupki (free-тариф «Старт» ≈ 100 запросов/мес)
MCP_ZAKUPKI_GOSPLAN_KEYAPI-ключ ГосПлан API v2https://wiki.gosplan.info (sandbox без регистрации: fz44test.gosplan.info)
MCP_ZAKUPKI_NAVODKI_KEYAPI-ключ navodki.ruhttps://navodki.ru
MCP_ZAKUPKI_EIS_TOKENТокен ЕИС (через pmd/auth/welcome)https://zakupki.gov.ru/pmd/auth/welcome + сертификат Минфина
MCP_ZAKUPKI_API_KEYPro hosted — обязателен для get_customer_history / get_supplier_stats и будущих AI-туловhttps://atomno-mcp.ru/pricing#zakupki-pro
MCP_ZAKUPKI_LOG_LEVELDEBUG / INFO / WARNING / ERROR / CRITICALпо умолчанию INFO
MCP_ZAKUPKI_CACHE_DBПуть к SQLite-кэшукаталог данных пользователя (%LOCALAPPDATA%/atomno/ или ~/.local/share/atomno/)
MCP_ZAKUPKI_PROVIDERSЦепочка источниковпо умолчанию eis_public
MCP_ZAKUPKI_RPSЛимит запросов в минутупо умолчанию 30

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 --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.

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

ИсточникЧто отдаётКогда используется
ЕИС, официальный сайтПоиск, XML-карточка, карточка организации, реестр недобросовестныхПо умолчанию, без ключа
SOAP ЕИС (int.zakupki.gov.ru)Машинная выгрузкаТолько с токеном после регистрации на портале
DaMIA / ГосПлан / navodkiКоммерческие APIТолько если явно заданы в MCP_ZAKUPKI_PROVIDERS и есть ключ

Цепочка по умолчанию: 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.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

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

Лицензия

MIT © 2026 Atomno.

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

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

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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx atomno-mcp-zakupki

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

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

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

atomno-mcp-zakupkipypi

Compatible MCP Clients

mcp-zakupki works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More

MCP vs ACP: What's the Difference Between Agent Protocols?MCP connects an agent to tools and data. ACP connects an editor to an agent. They sound similar and get confused constantly, but the JetBrains-Zed backed ACP and Anthropic's MCP were built to stack on top of each other.Read articlePinterest vs Microsoft Advertising MCP ServersTwo ad platforms shipped MCP servers on the same day, one week ahead of Cannes Lions. Pinterest's is an invite-only alpha; Microsoft's is a broadly available pilot. Neither is indexed in MCPFind's directory yet. Here's the real difference between them.Read articleHome Assistant MCP Server: 4 Options Compared for ClaudeHome Assistant has no vendor-official MCP server, so four community projects fill the gap, each with a different architecture. This guide compares voska/hass-mcp, homeassistant-ai/ha-mcp, achetronic/hass-mcp, and a custom-component option so you can pick the one that matches your setup.Read article