Log inSubmit server
Cdek MCP logo

Cdek MCP

Connects AI agents to CDEK API for delivery rates, orders, tracking, pickup points, courier requests, and webhooks.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Cdek MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "cdek-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/cdek-mcp"
      ],
      "env": {
        "CDEK_CLIENT_ID": "YOUR_VALUE_HERE",
        "CDEK_CLIENT_SECRET": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 16 tools correctly (13d ago).

Overview

The cdek-mcp MCP server connects AI agents to the CDEK API v2 for delivery and logistics operations. It exposes tools for comparing tariffs, creating and managing orders, tracking shipments, finding cities and pickup points, generating documents, requesting courier pickups, and managing webhooks. OAuth 2.0 client-credentials authentication is handled automatically, with sandbox and production endpoints supported. Use it when an agent needs to answer delivery questions or perform CDEK shipment workflows through Claude Desktop, Cursor, Windsurf, or VS Code.

Use cases

  • Compare delivery tariffs and estimated times for a route
  • Create and track CDEK shipment orders
  • Find nearby CDEK pickup points by city or coordinates
  • Request courier collection and print shipment documents
  • Register webhooks for order-status or delivery-photo events

Key features

  • CDEK tariff and delivery-time calculation
  • Shipment creation, lookup, cancellation, and filtering
  • Waybill tracking and geographic search
  • Pickup-point and parcel-locker lookup
  • Barcode, label, receipt, and waybill generation
  • Courier pickup and webhook management

Tools16

What Cdek MCP lets your agent do. Expand a tool for its parameters.

Verified live~3.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

9/9 checks healthy over the last 51d

What it can do

From the 16 tools this server returned when we ran it.

Can delete or modify data · 2Makes network requests · 2Read-only tools · 14
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age206 days
Maintainers1

Observed 2026-10-22 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3d ago via OSV.dev · @theyahia/cdek-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads174Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed16Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Cdek MCP works

What cdek-mcp MCP server does

The cdek-mcp MCP server exposes CDEK API v2 operations as MCP tools for an AI agent. It covers the main stages of a delivery workflow: estimate a shipment, identify locations and pickup points, create an order, monitor its status, arrange collection, and produce shipping documents.

Tariff tools calculate a price and delivery time for a selected tariff or return available tariff options for a route. Order tools create shipments, retrieve an order by UUID, cancel or delete an order, and search orders using dates, store numbers, or CDEK waybill numbers. Tracking uses a CDEK waybill number.

Geographic lookup includes cities, regions, pickup points, and parcel lockers. Pickup-point searches can use a city or GPS coordinates. The server also supports barcode or label generation, PDF receipts or waybills, courier pickup requests, and webhook subscriptions for order-status changes or delivery photos.

How it works

The server communicates with CDEK through OAuth 2.0 using the client-credentials flow. It obtains an access token when the first API request is made, caches the token, refreshes it shortly before expiration, and shares one refresh operation across concurrent requests. If CDEK returns HTTP 401, the cached token is reset and the request is retried.

By default, the process can run as a standard local MCP command. It also supports Streamable HTTP mode. In HTTP mode, MCP JSON-RPC uses POST /mcp, the SSE stream is available at GET /mcp, and DELETE /mcp ends a session. GET /health provides a health endpoint.

Setup and configuration

Install and launch the package with npx -y @theyahia/cdek-mcp, then provide credentials from the CDEK account’s integration settings. CDEK_CLIENT_ID and CDEK_CLIENT_SECRET are required. Set CDEK_SANDBOX=true to use the test endpoint; without it, the production CDEK endpoint is used. The public test credentials mentioned in the project may change, so dedicated sandbox credentials may be needed.

For HTTP mode, pass --http and set HTTP_PORT, for example HTTP_PORT=3000 npx @theyahia/cdek-mcp --http. The README includes configuration examples for Claude Desktop, Cursor, Windsurf, and VS Code.

Tools and capabilities

The cdek-mcp MCP server provides 16 tools:

  • calculate_tariff and calculate_tariff_list estimate delivery cost and time.
  • create_order, get_order, delete_order, and list_orders manage shipments.
  • track_shipment retrieves shipment tracking information.
  • get_cities, get_regions, and list_delivery_points query CDEK geography and pickup locations.
  • generate_barcode and print_receipt create shipment materials.
  • create_courier_pickup and get_courier_pickup manage courier collection requests.
  • create_webhook and delete_webhook manage event subscriptions.

Limitations and notes

The server requires valid CDEK API credentials and depends on CDEK API availability. Sandbox behavior uses CDEK’s test environment and should be selected explicitly with CDEK_SANDBOX=true. Operations that create, cancel, or modify shipments require appropriate CDEK account permissions and should be tested before production use. The repository provides lint, type-checking, unit-test, build, and end-to-end smoke-test commands for local development.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Cdek MCP

cdek-mcp is an MCP server that connects AI agents to the CDEK API v2. Its main tools calculate delivery tariffs, create and manage orders, track shipments, search cities and pickup points, generate barcodes and receipts, request courier pickups, and manage webhooks. It supports both sandbox and production CDEK environments.

Install it through npx with `npx -y @theyahia/cdek-mcp`. Add the command to the MCP configuration for your client, then set `CDEK_CLIENT_ID` and `CDEK_CLIENT_SECRET`. The README provides configuration examples for Claude Desktop, Cursor, Windsurf, and VS Code.

Set `CDEK_SANDBOX=true` and provide sandbox credentials in `CDEK_CLIENT_ID` and `CDEK_CLIENT_SECRET`. This selects the CDEK test endpoint. Shared test credentials can change, so request or configure your own sandbox keys if authentication returns an invalid-client error.

Yes, cdek-mcp supports Streamable HTTP mode. Start it with the `--http` flag and set `HTTP_PORT`, such as `HTTP_PORT=3000 npx @theyahia/cdek-mcp --http`. MCP requests use `/mcp`, and `/health` is available for status checks.

Related MCP servers

All in Delivery All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCdek MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/cdek-mcp?style=directory)](https://allmcps.com/mcp/cdek-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/cdek-mcp"><img src="https://allmcps.com/api/badge/cdek-mcp?style=directory" alt="Cdek MCP on AllMCPs" /></a>