Skip to main content
Glama
cdek-shopping-mcp

cdek-shopping-mcp

by heahoh

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CDEK_SHOPPING_LANGNo`Accept-Language` header sent on every request.ru
CDEK_SHOPPING_TOKENNoBearer token for authenticated endpoints (e.g. `list_orders`).
CDEK_SHOPPING_MAX_RPSNoMax requests/second enforced by the client.5
CDEK_SHOPPING_BASE_URLNoAPI 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
catalog_categoriesA

List catalog categories, optionally the children of a given category.

Args:
    parent_id: ID of the parent category. Omit to get the top-level tree.
search_productsA

Search products, brands and categories in the cdek.shopping catalog.

Args:
    q: Free-text search query, e.g. "Apple смартфон синий".
    filter: Facet filters as "key=value" strings (from a prior search response).
    sort: One of PRICE_ASC, PRICE_DESC, DEFAULT.
    page: Page number, 1-based.
    per_page: Results per page (max 100).
    only_filters: If true, return only the available filters, not results.
search_autocompleteB

Get search-box autocomplete suggestions for a partial query.

Args:
    q: Partial search text typed by the user.
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.

Args:
    product_id: Product ID.
    has_media: If true, only reviews that include photos/video.
    has_text: If true, only reviews that include written text.
    page: Page number, 1-based.
    per_page: Reviews per page.
    sort_field: Field to sort by (e.g. date, rating).
    sort_order: Sort direction (asc/desc).
list_category_productsB

List products inside a given catalog category.

Args:
    category_id: Category ID (see catalog_categories).
    sort: One of PRICE_ASC, PRICE_DESC, DEFAULT.
    page: Page number, 1-based.
    per_page: Results per page.
list_collection_productsB

List products inside a given curated collection/subselection.

Args:
    collection_id: Collection ID.
    sort: One of PRICE_ASC, PRICE_DESC, DEFAULT.
    page: Page number, 1-based.
    per_page: Results per page.
recommendationsA

Get personalized/related product recommendations for given placements.

Args:
    placements: Required list of placement codes identifying where the
        recommendations will be shown (e.g. "product_page", "cart").
    product_id: Product IDs to base "related to this" recommendations on.
    category_id: Category ID to scope recommendations to.
    region_id: Region/location ID affecting availability and pricing.
    page: Page number, 1-based.
    per_page: Results per page.
    user_history: Opaque user-history token used to personalize results.
list_ordersA

List the authenticated user's orders.

Requires the CDEK_SHOPPING_TOKEN environment variable to be set to a
valid bearer token; otherwise this returns an authentication error.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.4/5.0

Scored across 10 tools

Disambiguation4/5

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.

Naming Consistency3/5

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.

Tool Count5/5

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.

Completeness3/5

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.

Maintenance

ActivityMaintained
ResponsivenessOutdated data