Yandex Delivery MCP

A1 Яндекс Доставка MCP

MCP server for the Yandex Delivery B2B API: pricing, booking and tracking same-day and next-day shipments

MCP server

High risk

We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.

Why this level

  • Can book real shipments with a real cost
  • Order cancellation can be paid
  • The token sits in plain text in the client config
All reasons and checks
Russian stack

a1-x-tech/mcp-yandex-dostavka

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/a1-yandeks-dostavka-mcp

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

This entry is high risk, so there is no one-click install. Review the code and add the config by hand.

Run in a terminal

claude mcp add --transport stdio --env 'YANDEX_DELIVERY_TOKEN=<your YANDEX_DELIVERY_TOKEN>' mcp-yandex-dostavka -- npx -y mcp-yandex-dostavka@1.1.0

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "mcp-yandex-dostavka": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-dostavka@1.1.0"
      ],
      "env": {
        "YANDEX_DELIVERY_TOKEN": "<your YANDEX_DELIVERY_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YANDEX_DELIVERY_TOKENsecret, required
Shared Bearer token for both contours (dostavka.yandex.ru cabinet, «Интеграции» → «Получить токен»). Treat it as a secret.
YANDEX_DELIVERY_EXPRESS_TOKENsecret, optional
Express-contour override of the shared token.
YANDEX_DELIVERY_PLATFORM_TOKENsecret, optional
Platform-contour override of the shared token.
YANDEX_DELIVERY_EXPRESS_BASE_URLoptional
Express API root override.
YANDEX_DELIVERY_PLATFORM_BASE_URLoptional
Platform API root; set https://b2b.taxi.tst.yandex.net for the test contour.
YANDEX_DELIVERY_LANGoptional
Accept-Language header (required by the express methods).
YANDEX_DELIVERY_TIMEOUT_MSoptional
Per-request timeout in milliseconds.
YANDEX_DELIVERY_MAX_RETRIESoptional
Retries on transient errors (429 always; 5xx/network for idempotent calls only).

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "mcp-yandex-dostavka": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-dostavka@1.1.0"
      ],
      "env": {
        "YANDEX_DELIVERY_TOKEN": "<your YANDEX_DELIVERY_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

YANDEX_DELIVERY_TOKENsecret, required
Shared Bearer token for both contours (dostavka.yandex.ru cabinet, «Интеграции» → «Получить токен»). Treat it as a secret.
YANDEX_DELIVERY_EXPRESS_TOKENsecret, optional
Express-contour override of the shared token.
YANDEX_DELIVERY_PLATFORM_TOKENsecret, optional
Platform-contour override of the shared token.
YANDEX_DELIVERY_EXPRESS_BASE_URLoptional
Express API root override.
YANDEX_DELIVERY_PLATFORM_BASE_URLoptional
Platform API root; set https://b2b.taxi.tst.yandex.net for the test contour.
YANDEX_DELIVERY_LANGoptional
Accept-Language header (required by the express methods).
YANDEX_DELIVERY_TIMEOUT_MSoptional
Per-request timeout in milliseconds.
YANDEX_DELIVERY_MAX_RETRIESoptional
Retries on transient errors (429 always; 5xx/network for idempotent calls only).

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

code --add-mcp '{"name":"mcp-yandex-dostavka","type":"stdio","command":"npx","args":["-y","mcp-yandex-dostavka@1.1.0"],"env":{"YANDEX_DELIVERY_TOKEN":"<your YANDEX_DELIVERY_TOKEN>"}}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "mcp-yandex-dostavka": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-dostavka@1.1.0"
      ],
      "env": {
        "YANDEX_DELIVERY_TOKEN": "<your YANDEX_DELIVERY_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

YANDEX_DELIVERY_TOKENsecret, required
Shared Bearer token for both contours (dostavka.yandex.ru cabinet, «Интеграции» → «Получить токен»). Treat it as a secret.
YANDEX_DELIVERY_EXPRESS_TOKENsecret, optional
Express-contour override of the shared token.
YANDEX_DELIVERY_PLATFORM_TOKENsecret, optional
Platform-contour override of the shared token.
YANDEX_DELIVERY_EXPRESS_BASE_URLoptional
Express API root override.
YANDEX_DELIVERY_PLATFORM_BASE_URLoptional
Platform API root; set https://b2b.taxi.tst.yandex.net for the test contour.
YANDEX_DELIVERY_LANGoptional
Accept-Language header (required by the express methods).
YANDEX_DELIVERY_TIMEOUT_MSoptional
Per-request timeout in milliseconds.
YANDEX_DELIVERY_MAX_RETRIESoptional
Retries on transient errors (429 always; 5xx/network for idempotent calls only).

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add mcp-yandex-dostavka --env 'YANDEX_DELIVERY_TOKEN=<your YANDEX_DELIVERY_TOKEN>' -- npx -y mcp-yandex-dostavka@1.1.0

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.mcp-yandex-dostavka]
command = "npx"
args = ["-y", "mcp-yandex-dostavka@1.1.0"]
env = { YANDEX_DELIVERY_TOKEN = "<your YANDEX_DELIVERY_TOKEN>" }

If the file already exists, append the block to the end.

Keys and settings

YANDEX_DELIVERY_TOKENsecret, required
Shared Bearer token for both contours (dostavka.yandex.ru cabinet, «Интеграции» → «Получить токен»). Treat it as a secret.
YANDEX_DELIVERY_EXPRESS_TOKENsecret, optional
Express-contour override of the shared token.
YANDEX_DELIVERY_PLATFORM_TOKENsecret, optional
Platform-contour override of the shared token.
YANDEX_DELIVERY_EXPRESS_BASE_URLoptional
Express API root override.
YANDEX_DELIVERY_PLATFORM_BASE_URLoptional
Platform API root; set https://b2b.taxi.tst.yandex.net for the test contour.
YANDEX_DELIVERY_LANGoptional
Accept-Language header (required by the express methods).
YANDEX_DELIVERY_TIMEOUT_MSoptional
Per-request timeout in milliseconds.
YANDEX_DELIVERY_MAX_RETRIESoptional
Retries on transient errors (429 always; 5xx/network for idempotent calls only).

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "mcp-yandex-dostavka": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-dostavka@1.1.0"
      ],
      "env": {
        "YANDEX_DELIVERY_TOKEN": "<your YANDEX_DELIVERY_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YANDEX_DELIVERY_TOKENsecret, required
Shared Bearer token for both contours (dostavka.yandex.ru cabinet, «Интеграции» → «Получить токен»). Treat it as a secret.
YANDEX_DELIVERY_EXPRESS_TOKENsecret, optional
Express-contour override of the shared token.
YANDEX_DELIVERY_PLATFORM_TOKENsecret, optional
Platform-contour override of the shared token.
YANDEX_DELIVERY_EXPRESS_BASE_URLoptional
Express API root override.
YANDEX_DELIVERY_PLATFORM_BASE_URLoptional
Platform API root; set https://b2b.taxi.tst.yandex.net for the test contour.
YANDEX_DELIVERY_LANGoptional
Accept-Language header (required by the express methods).
YANDEX_DELIVERY_TIMEOUT_MSoptional
Per-request timeout in milliseconds.
YANDEX_DELIVERY_MAX_RETRIESoptional
Retries on transient errors (429 always; 5xx/network for idempotent calls only).

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "mcp-yandex-dostavka": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-dostavka@1.1.0"
      ],
      "env": {
        "YANDEX_DELIVERY_TOKEN": "<your YANDEX_DELIVERY_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

YANDEX_DELIVERY_TOKENsecret, required
Shared Bearer token for both contours (dostavka.yandex.ru cabinet, «Интеграции» → «Получить токен»). Treat it as a secret.
YANDEX_DELIVERY_EXPRESS_TOKENsecret, optional
Express-contour override of the shared token.
YANDEX_DELIVERY_PLATFORM_TOKENsecret, optional
Platform-contour override of the shared token.
YANDEX_DELIVERY_EXPRESS_BASE_URLoptional
Express API root override.
YANDEX_DELIVERY_PLATFORM_BASE_URLoptional
Platform API root; set https://b2b.taxi.tst.yandex.net for the test contour.
YANDEX_DELIVERY_LANGoptional
Accept-Language header (required by the express methods).
YANDEX_DELIVERY_TIMEOUT_MSoptional
Per-request timeout in milliseconds.
YANDEX_DELIVERY_MAX_RETRIESoptional
Retries on transient errors (429 always; 5xx/network for idempotent calls only).

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "mcp-yandex-dostavka": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-dostavka@1.1.0"
      ],
      "env": {
        "YANDEX_DELIVERY_TOKEN": "<your YANDEX_DELIVERY_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

YANDEX_DELIVERY_TOKENsecret, required
Shared Bearer token for both contours (dostavka.yandex.ru cabinet, «Интеграции» → «Получить токен»). Treat it as a secret.
YANDEX_DELIVERY_EXPRESS_TOKENsecret, optional
Express-contour override of the shared token.
YANDEX_DELIVERY_PLATFORM_TOKENsecret, optional
Platform-contour override of the shared token.
YANDEX_DELIVERY_EXPRESS_BASE_URLoptional
Express API root override.
YANDEX_DELIVERY_PLATFORM_BASE_URLoptional
Platform API root; set https://b2b.taxi.tst.yandex.net for the test contour.
YANDEX_DELIVERY_LANGoptional
Accept-Language header (required by the express methods).
YANDEX_DELIVERY_TIMEOUT_MSoptional
Per-request timeout in milliseconds.
YANDEX_DELIVERY_MAX_RETRIESoptional
Retries on transient errors (429 always; 5xx/network for idempotent calls only).

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "mcp-yandex-dostavka": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-dostavka@1.1.0"
      ],
      "env": {
        "YANDEX_DELIVERY_TOKEN": "<your YANDEX_DELIVERY_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YANDEX_DELIVERY_TOKENsecret, required
Shared Bearer token for both contours (dostavka.yandex.ru cabinet, «Интеграции» → «Получить токен»). Treat it as a secret.
YANDEX_DELIVERY_EXPRESS_TOKENsecret, optional
Express-contour override of the shared token.
YANDEX_DELIVERY_PLATFORM_TOKENsecret, optional
Platform-contour override of the shared token.
YANDEX_DELIVERY_EXPRESS_BASE_URLoptional
Express API root override.
YANDEX_DELIVERY_PLATFORM_BASE_URLoptional
Platform API root; set https://b2b.taxi.tst.yandex.net for the test contour.
YANDEX_DELIVERY_LANGoptional
Accept-Language header (required by the express methods).
YANDEX_DELIVERY_TIMEOUT_MSoptional
Per-request timeout in milliseconds.
YANDEX_DELIVERY_MAX_RETRIESoptional
Retries on transient errors (429 always; 5xx/network for idempotent calls only).

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "mcp-yandex-dostavka": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mcp-yandex-dostavka@1.1.0"
      ],
      "environment": {
        "YANDEX_DELIVERY_TOKEN": "<your YANDEX_DELIVERY_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

YANDEX_DELIVERY_TOKENsecret, required
Shared Bearer token for both contours (dostavka.yandex.ru cabinet, «Интеграции» → «Получить токен»). Treat it as a secret.
YANDEX_DELIVERY_EXPRESS_TOKENsecret, optional
Express-contour override of the shared token.
YANDEX_DELIVERY_PLATFORM_TOKENsecret, optional
Platform-contour override of the shared token.
YANDEX_DELIVERY_EXPRESS_BASE_URLoptional
Express API root override.
YANDEX_DELIVERY_PLATFORM_BASE_URLoptional
Platform API root; set https://b2b.taxi.tst.yandex.net for the test contour.
YANDEX_DELIVERY_LANGoptional
Accept-Language header (required by the express methods).
YANDEX_DELIVERY_TIMEOUT_MSoptional
Per-request timeout in milliseconds.
YANDEX_DELIVERY_MAX_RETRIESoptional
Retries on transient errors (429 always; 5xx/network for idempotent calls only).

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "mcp-yandex-dostavka": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-dostavka@1.1.0"
      ],
      "env": {
        "YANDEX_DELIVERY_TOKEN": "<your YANDEX_DELIVERY_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

YANDEX_DELIVERY_TOKENsecret, required
Shared Bearer token for both contours (dostavka.yandex.ru cabinet, «Интеграции» → «Получить токен»). Treat it as a secret.
YANDEX_DELIVERY_EXPRESS_TOKENsecret, optional
Express-contour override of the shared token.
YANDEX_DELIVERY_PLATFORM_TOKENsecret, optional
Platform-contour override of the shared token.
YANDEX_DELIVERY_EXPRESS_BASE_URLoptional
Express API root override.
YANDEX_DELIVERY_PLATFORM_BASE_URLoptional
Platform API root; set https://b2b.taxi.tst.yandex.net for the test contour.
YANDEX_DELIVERY_LANGoptional
Accept-Language header (required by the express methods).
YANDEX_DELIVERY_TIMEOUT_MSoptional
Per-request timeout in milliseconds.
YANDEX_DELIVERY_MAX_RETRIESoptional
Retries on transient errors (429 always; 5xx/network for idempotent calls only).

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "mcp-yandex-dostavka": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-dostavka@1.1.0"
      ],
      "env": {
        "YANDEX_DELIVERY_TOKEN": "<your YANDEX_DELIVERY_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YANDEX_DELIVERY_TOKENsecret, required
Shared Bearer token for both contours (dostavka.yandex.ru cabinet, «Интеграции» → «Получить токен»). Treat it as a secret.
YANDEX_DELIVERY_EXPRESS_TOKENsecret, optional
Express-contour override of the shared token.
YANDEX_DELIVERY_PLATFORM_TOKENsecret, optional
Platform-contour override of the shared token.
YANDEX_DELIVERY_EXPRESS_BASE_URLoptional
Express API root override.
YANDEX_DELIVERY_PLATFORM_BASE_URLoptional
Platform API root; set https://b2b.taxi.tst.yandex.net for the test contour.
YANDEX_DELIVERY_LANGoptional
Accept-Language header (required by the express methods).
YANDEX_DELIVERY_TIMEOUT_MSoptional
Per-request timeout in milliseconds.
YANDEX_DELIVERY_MAX_RETRIESoptional
Retries on transient errors (429 always; 5xx/network for idempotent calls only).

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit e0e5903.

Text for your agent

Get a corporate client token from the Integrations tab at dostavka.yandex.ru and add the server: claude mcp add --env YANDEX_DELIVERY_TOKEN=your_token --transport stdio --scope user yandex-dostavka -- npx -y mcp-yandex-dostavka@latest.

Other ways from the author
claude mcp add --env YANDEX_DELIVERY_TOKEN=ваш_токен --transport stdio --scope user yandex-dostavka -- npx -y mcp-yandex-dostavka@latest

Token from the Integrations tab at dostavka.yandex.ru.

This is third-party code. Review the repository files before installing.

What it does

The server gives the agent 16 actions over the two parts of the Yandex Delivery B2B API: same-day express delivery and next-day, Russia-wide, pickup-point and locker delivery. The agent can price a shipment and get a courier ETA, prepare and book it, find an order by status or phone, get the courier's position and a public tracking link for the recipient, and check cancellation terms before cancelling. The server clearly separates pricing, preparation and booking: a real order is only created at the confirmation step. Next-day delivery has a sandbox limited to Moscow addresses; same-day delivery has none, but pricing and reading existing requests are safe.

Who it is for. For companies and sole proprietors already connected to the Yandex Delivery B2B API who want to book and track shipments from an agent chat.

Good fit when

  • You need a quick price and ETA between two addresses
  • You need to book a shipment and get a recipient tracking link right away
  • You need to check status, courier position or paid cancellation terms

Not a fit when

  • You have no corporate Yandex Delivery contract or a token from the dashboard
  • You need a same-day sandbox: Yandex does not offer one at all
  • You need continuous automatic order tracking without calling the agent

Example request

Price a 2 kg box delivery for today by 6 PM and book it if the price is under 1,000 rubles

Limitations

Requires a corporate client token; next-day and pickup-point delivery also need a shipping station connected. The token sits in the client config in plain text. The server is not read-only: it can book and cancel a real delivery, and cancellation can be paid. Confirmation before write actions depends on the AI application's own policy. There is no background order watching, only status checks on request.

How to disable. Run claude mcp remove yandex-dostavka in Claude Code or delete the yandex-dostavka block from your client config.

MCP

Transport
stdio
Authentication
API key
Environment variables
Environment variables
YANDEX_DELIVERY_TOKEN
required, secret
Shared Bearer token for both delivery APIs
YANDEX_DELIVERY_EXPRESS_TOKEN
secret
Separate token for same-day delivery
YANDEX_DELIVERY_PLATFORM_TOKEN
secret
Separate token for next-day, Russia-wide and pickup-point delivery
ASKADS_TELEMETRY
Set to 0 to disable anonymous usage telemetry

Security check

  • Can book real shipments with a real cost
  • Order cancellation can be paid
  • The token sits in plain text in the client config

README in short

The README gives ready instructions for Codex, Claude Desktop, Claude Code, Cursor and VS Code, an environment-variable table with separate tokens for the two APIs, and a section on exactly when a real order is created. It separately covers anonymous usage telemetry, disabled via ASKADS_TELEMETRY, and links to a catalogue of 16 MCP capabilities and a technical tool reference.

FAQ

Can I safely test it without a real order?

For same-day delivery, pricing and reading existing requests are safe. For next-day delivery there is a sandbox with Moscow addresses via YANDEX_DELIVERY_PLATFORM_BASE_URL.

Is cancellation free?

Not always: the server checks cancellation terms first, and whether it is paid depends on the current status and Yandex Delivery's rules.

Editors’ pick

An MCP server with n8n node and template knowledge: the agent picks nodes, validates configs and, with API access, creates workflows in your n8n

MCP serverHigh riskNo VPN needed23KRepository stars
Official

Zapier's official MCP plugin: the agent gets actions across thousands of apps through your Zapier account

PluginHigh risk421Repository stars

A curated list of Claude skills and plugins, plus Composio's own automation skills for 78 SaaS apps

SkillHigh risk75.8KRepository stars

A plugin and CLI catalog for agents: generates command-line interfaces for GUI apps like GIMP and Blender and installs ready ones via CLI-Hub

PluginHigh riskNo VPN needed50.9KRepository stars
Foxx AIYandex Delivery MCP

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.