SkillFoxx

CDEK MCP: calculator and HTTP server

CDEK MCP Server

A CDEK API MCP server with a delivery calculator across all tariffs, courier booking and an HTTP mode for external agent platforms

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • It can create real delivery orders and book couriers under live keys
  • The HTTP mode exposes the server over the network with no built-in description of external call authentication
All reasons and checks
Russian stack

aryazansev/cdek-mcpAuthor:aryazansev

Install

Services

Manual install

npm install -g cdek-mcp

Global install of the npm package.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • It can create real delivery orders and book couriers under live keys
  • The HTTP mode exposes the server over the network with no built-in description of external call authentication

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

What it does

The server wraps the CDEK API in tools for delivery calculation (a specific tariff or all available ones at once), a full order cycle (create, look up by UUID or CDEK number, list, delete), pickup point, city and region search, courier pickup booking and shipment tracking. Besides running locally as an MCP server for Claude Desktop, it has a separate HTTP mode with /health, /manifest and /tools/:toolName endpoints meant for external agent platforms like Google AI Studio, with ready one-click Railway and Render deploy buttons.

Who it is for. For people who need a quick CDEK delivery calculation across all tariffs at once and courier booking, including connecting from external agent platforms over HTTP.

Good fit when

  • You need to compare cost and timing across all CDEK tariffs at once
  • You need to book a courier pickup, not just delivery to a pickup point
  • You need an HTTP endpoint for AI Studio or a similar platform, not just Claude Desktop

Not a fit when

  • You need ready PDF labels and waybills: this server does not generate them, only order data
  • Project maturity matters: the README has placeholder links like yourusername for the repository and needs a CDEK test contract to verify

Example request

Calculate delivery from Moscow to Saint Petersburg across all CDEK tariffs for a 1 kg package

MCP

Transport
stdio, http
Authentication
API key

Environment variables

CDEK_CLIENT_ID required, secret
Client ID from the CDEK dashboard
CDEK_CLIENT_SECRET required, secret
Client Secret from the CDEK dashboard
CDEK_BASE_URL
API base URL, api.edu.cdek.ru/v2 for testing or api.cdek.ru/v2 for production

Limitations

The README has unreplaced placeholders (yourusername) in its GitHub and npm links, signalling the project is not fully publish-ready. Real order work needs an active CDEK contract or test access to api.edu.cdek.ru. There is no PDF label or waybill generation, only order JSON data.

How to disable. Remove the cdek entry from mcpServers in claude_desktop_config.json, or stop the HTTP server and the Railway/Render deployment.

FAQ

Can I test it without a live contract?

Yes, the README points to the api.edu.cdek.ru test environment for verification without a full contract.

Does it connect to more than Claude Desktop?

Yes, there is an HTTP mode with a /manifest endpoint for connecting from AI Studio and other platforms.

Discussion

No questions or reviews yet.

All CDEK tools
Russian stack

MCP server for the CDEK API: tariff quotes, pickup point search, tracking, order creation, courier pickup and waybill printing

MCP serverBroad access1
Russian stack

An MCP server, CLI tool and Pydantic models for the CDEK v2 API: creating orders, barcodes, labels, waybills, pickup point search and a local goods catalog

MCP serverBroad access
Russian stack

A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data

MCP serverBroad access38
Russian stack

Ready-made methods for Telegram, Bitrix24, VK, CDEK, Yandex Disk, databases and other APIs in 1C, OneScript and the oint CLI

CLIBroad access693

1C AI Skills for OpenIntegrations

1C AI Skills for OpenIntegrations (OInt)

Russian stack

Twelve agent skills for the OpenIntegrations library in 1C: Bitrix24 and CDEK, Google and Yandex, Telegram, VK, databases and network protocols

SkillMinimal access

README in short

The README covers quick deploy to Railway or Render, npm or from-source installation, two usage modes (local Claude Desktop and an external HTTP server for AI Studio), a full tool list for the calculator, orders, pickup points, courier and tracking, and REST endpoint examples.

README badge

Report a problem