kaspi-merchant-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kaspi-merchant-mcp Show new orders today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
kaspi-merchant-mcp
Первый MCP-сервер для Kaspi Marketplace в мире. 721 000 продавцов в Казахстане теперь могут управлять заказами через AI-ассистентов.
Kaspi.kz — крупнейший маркетплейс Казахстана. API работает по спецификации JSON:API (
Content-Type: application/vnd.api+json).
Sandbox отсутствует — все операции выполняются на реальных данных продакшна.
Операции accept_order, complete_order, cancel_order необратимы!
Инструменты (8 штук)
Инструмент | Метод | Описание |
| GET | Список заказов с фильтрацией по статусу и дате |
| GET | Один заказ по ID |
| GET | Позиции заказа (товары, кол-во, цена) |
| PATCH | Принять заказ (ACCEPTED_BY_MERCHANT) |
| PATCH | Завершить заказ (COMPLETED) |
| PATCH | Отменить заказ (CANCELLED) |
| GET | Список городов Kaspi |
| GET | Товарные предложения продавца |
Related MCP server: Yandex Market Seller MCP Server
Статусы заказов
Статус | Описание |
| Новый заказ, ожидает обработки |
| Требуется подпись (для крупных покупок) |
| Готов к выдаче |
| В доставке (курьерская) |
| В доставке через Kaspi Доставку |
| Архив (завершённые/отменённые) |
Быстрый старт
1. Получите API-токен
Откройте Kaspi Seller Cabinet → Настройки → API → Скопируйте токен.
2. Настройте MCP-сервер
Claude Desktop
claude_desktop_config.json:
{
"mcpServers": {
"kaspi": {
"command": "npx",
"args": ["-y", "@theyahia/kaspi-merchant-mcp"],
"env": {
"KASPI_AUTH_TOKEN": "ваш-токен"
}
}
}
}Claude Code (CLI)
claude mcp add kaspi -- npx -y @theyahia/kaspi-merchant-mcp
# Установите переменную окружения:
export KASPI_AUTH_TOKEN="ваш-токен"VS Code (Copilot)
.vscode/mcp.json:
{
"servers": {
"kaspi": {
"command": "npx",
"args": ["-y", "@theyahia/kaspi-merchant-mcp"],
"env": {
"KASPI_AUTH_TOKEN": "ваш-токен"
}
}
}
}Cursor
.cursor/mcp.json:
{
"mcpServers": {
"kaspi": {
"command": "npx",
"args": ["-y", "@theyahia/kaspi-merchant-mcp"],
"env": {
"KASPI_AUTH_TOKEN": "ваш-токен"
}
}
}
}Windsurf
~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"kaspi": {
"command": "npx",
"args": ["-y", "@theyahia/kaspi-merchant-mcp"],
"env": {
"KASPI_AUTH_TOKEN": "ваш-токен"
}
}
}
}Примеры запросов
"Покажи новые заказы за сегодня"
"Прими заказ 12345678"
"Какие заказы ожидают отправки?"
"Покажи детали заказа ABC-123"
"Отмени заказ XYZ, причина: нет в наличии"
"Список городов Kaspi"Разработка
git clone https://github.com/theYahia/kaspi-merchant-mcp.git
cd kaspi-merchant-mcp
npm install
npm run build
npm testСсылки
Часть серии russian-mcp — MCP-серверы для СНГ-рынка
Лицензия
MIT
Available Tools
8 toolsaccept_orderA
Accept a Kaspi order (set status to ACCEPTED_BY_MERCHANT). WARNING: This is IRREVERSIBLE! The order will be accepted and you must fulfill it.
Inputs: order_id (required).
cancel_orderA
Cancel a Kaspi order. WARNING: This is IRREVERSIBLE! The order will be cancelled and the buyer will be notified.
Inputs: order_id (required), reason.
complete_orderA
Mark a Kaspi order as COMPLETED. WARNING: This is IRREVERSIBLE! Only use when the order has been fully delivered.
Inputs: order_id (required).
get_citiesA
Get the list of all Kaspi cities in Kazakhstan.
Inputs: no named parameters.
get_orderA
Get a single order by ID from Kaspi Marketplace.
Inputs: order_id (required).
get_order_itemsA
Get line items (entries) for an order. Returns products, quantities, prices.
Inputs: order_id (required).
get_ordersA
List orders from Kaspi Marketplace. Filter by state, date range. Returns JSON:API response.
Inputs: page_number, page_size, state, creation_date_from, +1 more.
get_productsB
Get merchant product offers (merchantoffers) from Kaspi Marketplace.
Inputs: page_number, page_size.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a distinct purpose: order lifecycle actions (accept, cancel, complete) and informational queries (get orders, products, cities). No overlap between tools.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., accept_order, get_orders), making it easy to predict functionality.
With 8 tools, the set covers essential merchant operations without being overly large or sparse. It's well-scoped for Kaspi marketplace management.
Covers core order lifecycle (accept, cancel, complete) and retrieval, plus cities and products. Minor gap: no tool for updating products or marking orders as shipped, but it's acceptable.
Related MCP Connectors
Manage Shipday orders, drivers, driver earnings, reports from your AI assistants.
Run your restaurant from an AI client: orders, menu, reports, refunds, payouts and staff.
Operate Obriym CRM from your AI assistant: leads, deals, orders, catalog, stock, marketplaces.
Connect AI to store orders, products and inventory with scoped access and human approvals.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables management of Shopify orders through the Admin REST API, allowing users to create new orders and retrieve order status details. It supports both local and remote access via SSE and STDIO transports for integration with MCP clients like Claude Desktop.-
- AlicenseAqualityDmaintenanceIntegrates with Yandex Market Partner API, providing search and execute tools for managing orders, returns, shipments, offers, prices, and other seller operations via natural language.181MIT
- AlicenseNot gradedqualityDmaintenanceIntegrates RetailCRM API with AI assistants, enabling access to orders, customers, and products from your CRM through natural language commands.1MIT
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to Wildberries and Ozon seller accounts for real-time access to sales, stocks, prices, finances, and reviews through official APIs.MIT