mcp-zakupki

Servidor MCP para datos de contratación pública rusa (44-FZ / 223-FZ / 615-PP): busque licitaciones, historial de clientes/proveedores, consulta OKPD2 directamente desde Cursor, Claude Desktop, Cline, Goose y cualquier MCP-c...

GitHub

Prueba este MCPPatrocinado

Documentación

atomno-mcp-zakupki

Servidor MCP de contratación pública: búsqueda de licitaciones en zakupki.gov.ru, historial de clientes y proveedores, directorio OKPD2. Leyes 44-FZ, 223-FZ y 615-PP — directamente en Cursor, Claude y cualquier cliente MCP.

Búsqueda de contratación pública rusa para agentes de IA.

Instálalo localmente, configúralo en Cursor / Claude Desktop / Cline — y en un solo prompt pide: «Muéstrame las licitaciones recientes de hoy por OKPD2 62.0 en Moscú con NMCC ≤ 5 millones de ₽». El servidor consultará la fuente de datos seleccionada, normalizará la respuesta y devolverá a la LLM una estructura lista.

Por qué

Problema	Ahora	Con `atomno-mcp-zakupki`
Cada mañana 30–60 min revisando el EIS manualmente o pagando 16–67 K ₽/año por Kontur / Seldon	Resúmenes en Excel + notificaciones por email	Una sola llamada MCP desde Cursor → la LLM filtra, explica y compara por sí sola
Scripts en Python con `ftp.zakupki.gov.ru` dejaron de funcionar desde enero de 2025	Buscando alternativas mediante APIs comerciales	Sitio oficial del EIS: búsqueda, ficha XML, ficha de organización
El agente de IA no puede leer una licitación por sí mismo	Copiar y pegar en el chat	`get_tender(reg_number)` devuelve toda la ficha como JSON

Qué incluye (cliente open)

Herramienta	Qué hace
`search_tenders`	Búsqueda de contrataciones en el sitio oficial `zakupki.gov.ru`. No se necesita clave.
`get_tender`	Ficha de la contratación por número de registro (formulario impreso XML oficial).
`lookup_okpd2`	Búsqueda de código OKPD2 / KTRU por texto (directorio local, sin conexión).
`get_customer_history`	Ficha del cliente por INN y estado en el registro de proveedores no confiables. El sitio no calcula resúmenes de volúmenes.
`get_supplier_stats`	Resumen del proveedor. Sin token de intercambio automático del EIS no está disponible — la herramienta devolverá una denegación, no ceros.

La fuente predeterminada es el sitio oficial del EIS. El intermediario de pago está desactivado. El resumen de volúmenes y las estadísticas del proveedor no están disponibles sin token de intercambio automático.

Inicio rápido

1. Instalación

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

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

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

Extra opcional para el token oficial del EIS (requiere certificado del Ministerio de Finanzas):

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

2. Configuración

La búsqueda y la ficha de contratación funcionan sin clave — fuente zakupki.gov.ru. El intermediario de pago y el token SOAP del EIS no son obligatorios.

Variable	Descripción	Dónde obtenerla
`MCP_ZAKUPKI_DAMIA_KEY`	Clave API de DaMIA API-Zakupki	https://damia.ru/apizakupki (tarifa gratuita «Start» ≈ 100 solicitudes/mes)
`MCP_ZAKUPKI_GOSPLAN_KEY`	Clave API de GosPlan API v2	https://wiki.gosplan.info (sandbox sin registro: `fz44test.gosplan.info`)
`MCP_ZAKUPKI_NAVODKI_KEY`	Clave API de navodki.ru	https://navodki.ru
`MCP_ZAKUPKI_EIS_TOKEN`	Token del EIS (a través de `pmd/auth/welcome`)	https://zakupki.gov.ru/pmd/auth/welcome + certificado del Ministerio de Finanzas
`MCP_ZAKUPKI_API_KEY`	Pro hosted — obligatorio para `get_customer_history` / `get_supplier_stats` y futuras herramientas de IA	https://atomno-mcp.ru/pricing#zakupki-pro
`MCP_ZAKUPKI_LOG_LEVEL`	DEBUG / INFO / WARNING / ERROR / CRITICAL	por defecto `INFO`
`MCP_ZAKUPKI_CACHE_DB`	Ruta a la caché SQLite	directorio de datos del usuario (`%LOCALAPPDATA%/atomno/` o `~/.local/share/atomno/`)
`MCP_ZAKUPKI_PROVIDERS`	Cadena de fuentes	por defecto `eis_public`
`MCP_ZAKUPKI_RPS`	Límite de solicitudes por minuto	por defecto `30`

3. Conexión a Cursor

Abra ~/.cursor/mcp.json (o Cursor → Settings → Model Context Protocol) y agregue:

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

4. Conexión a Claude Desktop

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

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

5. Conexión a Cline / Goose / Kiro

Cualquier cliente MCP: ejecute atomno-mcp-zakupki (por defecto transporte stdio) y configure el comando de inicio en su configuración.

Para modo HTTP:

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

Ejemplos

Monitoreo matutino de licitaciones

[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 мс.

Ficha de la licitación

[Cursor]: Расскажи подробно про реестровый номер 0173100007426000018.

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

Análisis del cliente (Pro)

[Cursor]: Кто такой ИНН 7449023800? Покажи историю закупок за 2 года.

→ get_customer_history(inn="7449023800", period_from="2024-01-01")
← Требуется MCP_ZAKUPKI_API_KEY (hosted Pro).

Selección de código OKPD2

[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

Lista completa de opciones — en atomno-mcp-zakupki --help.

Fuentes de datos

Fuente	Qué proporciona	Cuándo se usa
EIS, sitio oficial	Búsqueda, ficha XML, ficha de organización, registro de no confiables	Por defecto, sin clave
SOAP EIS (`int.zakupki.gov.ru`)	Descarga automática	Solo con token tras registrarse en el portal
DaMIA / GosPlan / navodki	APIs comerciales	Solo si se especifican explícitamente en `MCP_ZAKUPKI_PROVIDERS` y hay clave

Cadena predeterminada: MCP_ZAKUPKI_PROVIDERS=eis_public. Si la fuente no responde, la herramienta devolverá un error tipificado provider_unavailable o not_implemented — no una lista vacía.

Arquitectura (en resumen)

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

Todos los proveedores implementan una interfaz común BaseProvider. Las respuestas se normalizan en modelos Pydantic Tender, Customer, Document, OrgHistorySummary.

Desarrollo

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

Aviso legal

El servicio no está afiliado al Ministerio de Finanzas de la Federación Rusa, al FAS, al operador del EIS ni a ETP específicas.
Los datos se obtienen del sitio oficial del EIS (zakupki.gov.ru) mediante direcciones públicas habituales, con los certificados raíz oficiales del Ministerio de Digitalización.
El intercambio automático SOAP requiere token y registro en el portal — sin esto, el resumen de volúmenes y las estadísticas del proveedor no están disponibles.
Úselo bajo su propio riesgo. Las decisiones sobre la presentación de ofertas en licitaciones son responsabilidad del usuario.

Licencia

Familia de servidores MCP atomno

atomno-mcp-zakupki — quinto servidor de la familia atomno-mcp-*:

atomno-mcp-cbr-rates — tasas del Banco Central de la Federación Rusa
atomno-mcp-egrul — datos de personas jurídicas del EGRUL
atomno-mcp-fns-check — solvencia fiscal
atomno-mcp-fssp — deudas y procedimientos de ejecución (en preparación)
atomno-mcp-zakupki — usted está aquí
atomno-mcp-rosreestr — bienes raíces, catastro (en preparación)
atomno-mcp-sudact — práctica judicial (en preparación)

Conéctelos todos juntos — y obtenga un expediente B2G completo de la licitación en un solo prompt.