x5-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| X5_COOKIE | Yes | The Cookie header value from the X5 Club browser session. Required for accessing X5 purchase history. | |
| X5_DB_PATH | No | Custom path to the local SQLite database file. If not set, uses the default platform-specific data directory. | |
| X5_SYNC_FROM | No | Start date for syncing in YYYY-MM-DD format. If not provided, the sync period is determined from existing data. | |
| X5_NETWORK_CODES | No | Comma-separated network codes used during sync. Default: D,S,VK,SL,VP. | D,S,VK,SL,VP |
| X5_PAGE_DELAY_MS | No | Delay in milliseconds between page requests during sync. Default: 500. | 500 |
| X5_ENABLE_SYNC_TOOL | No | Set to '0' to disable the sync tool and only analyze existing data. Default is '1' (enabled). | 1 |
| X5_REQUEST_TIMEOUT_MS | No | Timeout in milliseconds for X5 API requests. Default: 30000. | 30000 |
| X5_MAX_PAGES_PER_MONTH | No | Maximum number of pages to fetch per month during sync. Default: 1000. | 1000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| x5_sync_historyA | Загрузить чеки X5 в локальную SQLite. Сетевой запрос, обновляет локальный кэш. Первый запуск требует from/to; далее перекрытие 7 дней. Большой импорт запускайте CLI. |
| x5_get_sync_statusA | Покрытие истории, сети, свежесть и результаты последних синхронизаций. Проверять перед аналитикой. |
| x5_get_recent_receiptsA | Последние чеки из SQLite без состава; limit/offset. Состав — x5_get_receipt. |
| x5_get_receiptB | Один чек и до 500 его позиций; itemsCount показывает полное число позиций. |
| x5_get_spendingB | Траты по суммам чеков, без удвоения по товарам. Период включительно, сеть по исходному коду. null — неизвестно. |
| x5_search_purchasesA | Локальный поиск по названию товара без учёта регистра, ё/е; фильтры дат, сети, категории; limit/offset. |
| x5_get_product_historyB | История PLU, цены и количество. PLU найдите через x5_search_purchases. Сети и единицы не смешиваются в сводке. |
| x5_get_top_productsA | Частые товары по числу разных чеков, с количеством и последней покупкой. Фильтры периода, сети, категории. |
| x5_get_categoriesC | Исходные коды категорий и число позиций. Названия категорий не выдумываются. |
| x5_get_category_spendingA | Предварительная ОЦЕНКА трат по категориям: pricePromo × quantity. Семантика цены не подтверждена, это не точные итоги чеков. |
| x5_get_price_changesA | Сравнить первую и последнюю известную цену каждого PLU за период, раздельно по сети и единице. Акции могут объяснять разницу. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| x5_monthly_review | Посчитай траты за период через x5_get_spending, разбивку по неделям и сетям. Покажи частые товары через x5_get_top_products и 3 наблюдения с оговорками о покрытии. |
| x5_product_review | Найди товар через x5_search_purchases, уточни PLU по найденным вариантам, затем x5_get_product_history. Покажи последнюю покупку, количество и изменение фактической цены. |
| x5_shopping_patterns | Исследуй частые товары через x5_get_top_products и историю выбранных PLU. Отдели частоту покупок от количества, выдели регулярные покупки без выводов о потреблении всей семьи. |
| x5_savings_review | Сравни total_regular_minor и total_paid_minor по чекам за период; используй x5_get_spending и x5_get_price_changes. Не называй разницу с обычной ценой гарантированной экономией. Покажи неизвестные суммы и товары для проверки цен. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
Each tool targets a distinct function: syncing, sync status, receipt browsing/detail, spending, product search, product history, top products, categories, category spending, and price changes. The two spending-related tools are clearly separated by receipt totals versus estimated category totals.
All names follow a consistent x5_ prefix and snake_case convention, with read operations predominantly using x5_get_* plus clearly distinct action verbs like x5_sync_history and x5_search_purchases. There is no mixing of naming styles.
Eleven tools is well within the ideal range and each tool contributes a clear part of the workflow: data ingestion, status checking, receipt access, and analytics. None feel redundant or unnecessary.
The surface covers the full local receipt analytics workflow: sync, verify sync status, list/read receipts, search products, and perform spending/category/price analysis. Minor limitations such as large imports being delegated to CLI and receipts with more than 500 line items not being paginated prevent a perfect score.