Skip to main content
Glama
kaspi-merchant-mcp

kaspi-merchant-mcp

by theYahia

kaspi-merchant-mcp

Первый MCP-сервер для Kaspi Marketplace в мире. 721 000 продавцов в Казахстане теперь могут управлять заказами через AI-ассистентов.

Kaspi.kz — крупнейший маркетплейс Казахстана. API работает по спецификации JSON:API (Content-Type: application/vnd.api+json).


WARNING

Sandbox отсутствует — все операции выполняются на реальных данных продакшна.

Операции accept_order, complete_order, cancel_order необратимы!


Инструменты (8 штук)

Инструмент

Метод

Описание

get_orders

GET

Список заказов с фильтрацией по статусу и дате

get_order

GET

Один заказ по ID

get_order_items

GET

Позиции заказа (товары, кол-во, цена)

accept_order

PATCH

Принять заказ (ACCEPTED_BY_MERCHANT)

complete_order

PATCH

Завершить заказ (COMPLETED)

cancel_order

PATCH

Отменить заказ (CANCELLED)

get_cities

GET

Список городов Kaspi

get_products

GET

Товарные предложения продавца

Related MCP server: Yandex Market Seller MCP Server

Статусы заказов

Статус

Описание

NEW

Новый заказ, ожидает обработки

SIGN_REQUIRED

Требуется подпись (для крупных покупок)

PICKUP

Готов к выдаче

DELIVERY

В доставке (курьерская)

KASPI_DELIVERY

В доставке через Kaspi Доставку

ARCHIVE

Архив (завершённые/отменённые)

Быстрый старт

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

Ссылки

Лицензия

MIT

Available Tools

8 tools
accept_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

    A4/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a distinct purpose: order lifecycle actions (accept, cancel, complete) and informational queries (get orders, products, cities). No overlap between tools.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., accept_order, get_orders), making it easy to predict functionality.

    Tool Count5/5

    With 8 tools, the set covers essential merchant operations without being overly large or sparse. It's well-scoped for Kaspi marketplace management.

    Completeness4/5

    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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Integrates RetailCRM API with AI assistants, enabling access to orders, customers, and products from your CRM through natural language commands.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects AI assistants to Wildberries and Ozon seller accounts for real-time access to sales, stocks, prices, finances, and reviews through official APIs.
      MIT