mcpField
M
mcp-zakupki

mcp-zakupki

Local
github.com/atomno-mcpLegal & Government2Updated 8w ago
Repository

About mcp-zakupki

mcp-zakupki is an MCP server for Russian public procurement data under 44-FZ, 223-FZ, and 615-PP. It searches official EIS listings, retrieves tender records, and includes an offline OKPD2/КТРУ reference lookup.

Key features

  1. 01Search tenders on the official EIS site
  2. 02Retrieve tender records by registry number
  3. 03Look up OKPD2 and КТРУ codes offline
  4. 04View customer history and supplier statistics
  5. 05Support configurable data providers

Use cases

  1. 01Monitor tenders by code, region, and price
  2. 02Inspect a tender’s record and documents
  3. 03Find an OKPD2 code from a service description
  4. 04Review customer or supplier procurement data

MCP support

Exposes procurement search, tender details, code lookup, and organization-related tools to MCP clients. The default public EIS search and tender records work without a key; some organization history and supplier statistics require a hosted Pro API key.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "atomno-mcp-mcp-zakupki": {
      "command": "uvx",
      "args": [
        "atomno-mcp-zakupki"
      ]
    }
  }
}
Run commanduvx atomno-mcp-zakupki

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiatomno-mcp-zakupki0.2.0

Tools

6

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.