Yandex Delivery MCP
A1 Яндекс Доставка MCP
MCP server for the Yandex Delivery B2B API: pricing, booking and tracking same-day and next-day shipments
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
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/a1-yandeks-dostavka-mcpDetects 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.0Or 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.0Or 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.
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@latestToken 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 rublesLimitations
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 | |
|---|---|
| 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.
Related
An MCP server with n8n node and template knowledge: the agent picks nodes, validates configs and, with API access, creates workflows in your n8n
Zapier's official MCP plugin: the agent gets actions across thousands of apps through your Zapier account
Awesome Claude Skills by Composio
Awesome Claude Skills
A curated list of Claude skills and plugins, plus Composio's own automation skills for 78 SaaS apps
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