kaspi-mcp

Name: kaspi-mcp
Author: theYahia

Local

github.com/theYahiaBusiness & Marketing0Updated 8w ago

Repository

About kaspi-mcp

kaspi-mcp connects AI clients to the Kaspi.kz seller API, letting sellers look up orders and product listings without opening the merchant cabinet. It provides three focused tools for order lists, product catalogs, and order details.

Key features

01Filter and list orders
02List seller products
03Retrieve order details by ID

Use cases

01Review orders received today
02Browse a seller’s product catalog
03Inspect a specific order

MCP support

The MCP server exposes three Kaspi.kz seller API tools to MCP clients: order listing, product listing, and order lookup by ID. It requires a Kaspi API key.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "theyahia-kaspi": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/kaspi-mcp"
      ],
      "env": {
        "KASPI_API_KEY": "<KASPI_API_KEY>"
      }
    }
  }
}

Run commandnpx -y @theyahia/kaspi-mcp

Environment variables to set

KASPI_API_KEYSecretAPI key for the service

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@theyahia/kaspi-mcp1.0.0stdio

Tools

Saved tool list · updated 3w ago

Parameter	Type	Required	Description
state	enum	No	Filter by order statusNEW \| SIGN_REQUIRED \| PICKUP \| DELIVERY \| KASPIDELIVERY \| ARCHIVE \| COMPLETED \| CANCELLED \| RETURNED
page_size	integer	No	Page size
page_number	integer	No	Page number (starting at 0)
creation_date_to	string	No	Creation date to (YYYY-MM-DD)
creation_date_from	string	No	Creation date from (YYYY-MM-DD)

Details

From the project README

MCP-сервер для Kaspi.kz Marketplace — заказы и товары продавца через ИИ

Если вы искали, как подключить кабинет продавца Kaspi.kz к нейросети и смотреть заказы и товары не заходя в Kaspi Merchant Cabinet — это оно. 3 инструмента: список заказов с фильтрами, каталог товаров продавца и детали заказа по ID. Спрашиваете «какие заказы пришли сегодня» — получаете список прямо в чате.

Возможности (3 инструмента)

Инструмент	Описание
`get_orders`	Список заказов с фильтрацией
`get_products`	Список товаров продавца
`get_order`	Детали заказа по ID

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

{
  "mcpServers": {
    "kaspi": {
      "command": "npx",
      "args": ["-y", "@theyahia/kaspi-mcp"],
      "env": {
        "KASPI_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Переменные окружения

Переменная	Обязательная	Описание
`KASPI_API_KEY`	Да	API-ключ из кабинета продавца Kaspi.kz

Лицензия

MIT

Telegram: @vhodvai

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.