Kash

Kash MCP Server is an MCP-compliant gateway that lets ChatGPT, Claude, and other MCP-enabled clients connect to your sales recorder system (POS). It provides a straightforward interface to view sales, create receipts, manage products and stock, and generate automated reports through natural conversations.

How to use

You connect an MCP client to Kash MCP Server to control your cash register with natural language. Use conversational requests to perform common POS actions such as recording sales, retrieving revenue data, listing products or clients, and generating reports. For example, you can tell your assistant to show today’s sales, have it record a sale, or generate a weekly cash register report. The server exposes a set of MCP tools that your client can invoke to perform these actions.

To start using the server, configure your MCP client with the appropriate endpoint and authentication details, then issue commands in plain language that map to the available MCP tools. The system is designed to respond quickly to requests like querying revenue, listing inventory, and creating receipts, turning spoken or written requests into concrete POS actions.

How to install

Prerequisites: you need a Kash free POS account. If you don’t have one, register at the Kash portal and obtain your API key and SHOPID from the Setup, Webservices area.

Choose one of the supported installation methods below and follow the steps to get the MCP server running.

Option A: Install via npx for Claude Desktop (minimum setup)

npx caisse-enregistreuse-mcp-server --shopid=12345 --apikey=abcdef123456

Option B: Claude Desktop configuration (explicit JSON)

Edit the Claude Desktop configuration to add the MCP server entry and point it to the npx execution path with your shop credentials.

{
  "mcpServers": {
    "caisse": {
      "command": "npx",
      "args": [
        "caisse-enregistreuse-mcp-server",
        "--shopid=[replaceWithYourSHOPID]",
        "--apikey=[replaceWithYourAPIKEY]"
      ]
    }
  }
}

Option C: Install via npm (build step required)

Install dependencies, set environment variables, then build before running the server.

# 1) Dependencies
npm install

# 2) Environment variables (see ENV section below)

# 3) Build
npm run build

Environment variables

Set the required environment variables for your MCP server integration.

APIKEY=YOUR_API_KEY
SHOPID=YOUR_SHOP_ID

Available tools

sale_create

Creates a sale with catalog and free line items, including customer and payment details.

data_list_products

Retrieves the list of products in your catalog.

data_list_departments

Retrieves the list of departments in your catalog.

data_list_department_groups

Retrieves department groups to organize products.

data_list_clients

Lists clients/customers.

data_list_variations

Lists product variations.

data_list_delivery_men

Lists delivery personnel (if applicable).

data_list_payments

Lists available payment methods.

data_list_cashboxes

Lists cash boxes in use.

data_list_delivery_zones

Lists delivery zones.

data_list_relay_points

Lists relay points for delivery or pickup.

data_list_discounts

Lists discounts available for orders.

data_list_users

Lists system users.

data_list_tables

Lists tables or seating areas.