Kaspi Merchant

FreeNot checked

Enables managing Kaspi Marketplace orders through AI assistants, including listing, accepting, completing, and canceling orders, with real-time operations direc

by theYahia

GitHub Embed

About

Enables managing Kaspi Marketplace orders through AI assistants, including listing, accepting, completing, and canceling orders, with real-time operations directly on production data (no sandbox).

README

Первый 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	Товарные предложения продавца

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

Статус	Описание
`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

Ссылки

Kaspi Seller API документация
JSON:API спецификация
Часть серии russian-mcp — MCP-серверы для СНГ-рынка

Лицензия

MIT

from github.com/theYahia/kaspi-merchant-mcp

Install Kaspi Merchant in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install kaspi-merchant-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add kaspi-merchant-mcp -- npx -y @theyahia/kaspi-merchant-mcp

FAQ

Is Kaspi Merchant MCP free?

Yes, Kaspi Merchant MCP is free — one-click install via Unyly at no cost.

Does Kaspi Merchant need an API key?

No, Kaspi Merchant runs without API keys or environment variables.

Is Kaspi Merchant hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Kaspi Merchant in Claude Desktop, Claude Code or Cursor?

Open Kaspi Merchant on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Fetch

Web content fetching and conversion for efficient LLM usage.

by Community

AWS KB Retrieval

Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.

by modelcontextprotocol

Spring AI MCP Server

Provides auto-configuration for setting up an MCP server in Spring Boot applications.