cdek-shopping-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CDEK_SHOPPING_LANG | No | `Accept-Language` header sent on every request. | ru |
| CDEK_SHOPPING_TOKEN | No | Bearer token for authenticated endpoints (e.g. `list_orders`). | |
| CDEK_SHOPPING_MAX_RPS | No | Max requests/second enforced by the client. | 5 |
| CDEK_SHOPPING_BASE_URL | No | API base URL. | https://api.cdek.shopping/front-controller/v1 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Tools in this server call the cdek.shopping API. Do not call them at more than 5 requests/second combined, even across parallel tool calls: space out calls, avoid redundant lookups, and back off on errors instead of retrying immediately.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| catalog_categoriesA | List catalog categories, optionally the children of a given category. |
| search_productsA | Search products, brands and categories in the cdek.shopping catalog. |
| search_autocompleteB | Get search-box autocomplete suggestions for a partial query. |
| get_productB | Get full details for a single product by ID. |
| get_product_summaryB | Get a short summary card for a product (for compact display/embedding). |
| product_reviewsC | List customer reviews for a product. |
| list_category_productsB | List products inside a given catalog category. |
| list_collection_productsB | List products inside a given curated collection/subselection. |
| recommendationsA | Get personalized/related product recommendations for given placements. |
| list_ordersA | List the authenticated user's orders. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Most tools target distinct resources or retrieval modes: catalog browsing, product search, product details, reviews, recommendations, and orders. Minor overlap exists between get_product and get_product_summary, and between search_products and the category/collection product listers, but the descriptions make the boundaries reasonably clear.
Several tools follow a readable verb_noun pattern, such as list_orders, search_products, get_product, and list_category_products. However, catalog_categories, product_reviews, and recommendations are noun-only names, and search_autocomplete slightly breaks the resource-action pattern, producing mixed conventions.
Ten tools is well-scoped for a shopping/catalog MCP server, covering search, category browsing, product details, reviews, recommendations, and order listing. Each tool has a plausible role and the set does not feel bloated.
The catalog side is fairly complete: categories, search, product details, reviews, collections, and recommendations are covered. The shopping lifecycle is not: there is no get_order detail tool, no cart operations, and no checkout or purchase flow, which are notable gaps for a shopping-oriented server.