Overview

Kash.click MCP Server is an implementation of the Model Context Protocol (MCP) that exposes a point-of-sale (POS) / cash-register backend (free-cash-register.net) to MCP-compatible clients such as ChatGPT, Claude, and automation tools like n8n. It acts as a bridge so conversational agents can read sales data, record receipts, manage products and stock, and generate reports using natural language or programmatic MCP calls.

For developers, this means you can add POS capabilities to AI assistants or chat-based workflows without building a custom API adapter. The server supports both STDIO (for desktop MCP clients like Claude Desktop) and HTTP (streamable MCP over REST/WebSocket) modes and provides a small set of tools (MCP methods) tailored to common retail operations.

Features

Sales recording: create receipts/orders (sale_create) with catalog items and free lines.
Order retrieval: list orders by date range, lookup receipts.
Product & inventory: query products, variations, departments, stock levels.
Business data: clients, payment methods, cashboxes, delivery zones, relay points, discounts, users.
Reporting: request revenue summaries and other analytics via conversational queries.
Protocol support: STDIO MCP (for local clients) and HTTP Streamable MCP (requires Redis).
Live demo and hosted endpoint available: https://mcp.kash.click

Prerequisites

A free-cash-register.net account (register at https://kash.click/free-pos-software/ChatGPT).
From the POS app, obtain your SHOPID and APIKEY (Setup → Webservices).
For HTTP/Streamable mode: a Redis server or use the hosted MCP endpoint.

Installation / Configuration

Environment variables (.env)

Create a .env file with your credentials:

APIKEY=YOUR_API_KEY_HERE
SHOPID=YOUR_SHOP_ID_HERE

Quick run via npx

Run the server locally (stdlib/STDIO mode by default):

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

Install from source (npm)

# 1) Install dependencies
npm install

# 2) Configure environment variables (see .env above)

# 3) Build
npm run build

# 4) Run (example)
node build/stdio.js

Claude Desktop integration (STDIO)

Edit your Claude Desktop config (%APPDATA%\Claude\claude_desktop_config.json on Windows or ~/Library/Application Support/Claude/claude_desktop_config.json on macOS) to add the MCP server:

{
  "mcpServers": {
    "caisse": {
      "command": "node",
      "args": [
        "/PATH/TO/PROJECT/build/stdio.js"
      ],
      "cwd": "/PATH/TO/PROJECT",
      "env": {
        "SHOPID": "16",
        "APIKEY": "XXXXXXXX"
      }
    }
  }
}

ChatGPT (Workspace) connector (HTTP mode)

In ChatGPT Settings → Connectors → Create Connector, fill fields:

Field	Value
Name	Kash POS
Description	Record sales and retrieve POS reports via MCP
MCP Server URL	https://mcp.kash.click/mcp
Authentication	oAuth (as required by connector setup)

After creation, the connector appears in new conversations.

HTTP endpoints (hosted)

POST https://mcp.kash.click/mcp — MCP JSON-RPC endpoint
GET https://mcp.kash.click/health — { “status”: “ok” }
GET https://mcp.kash.click/.well-known/mcp/manifest.json — MCP manifest

Note: the HTTP/streamable implementation requires Redis for session state.

Available Tools / Resources

Common MCP tools exposed (excerpt):

sale_create — create a sale/receipt (products, free lines, payment)
orders_list / orders_get — list or fetch orders by date range/ID
products_list — list products and variations
departments_list, department_groups_list
clients_list
payments_list, cashboxes_list
delivery_zones, relay_points
discounts_list, users_list

Refer to the repository for full Zod schemas and field details: https://github.com/paracetamol951/caisse-enregistreuse-mcp-server

Example: Create a Sale (HTTP JSON-RPC)

POST to /mcp with a JSON-RPC MCP message for sale_create:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sale_create",
  "params": {
    "shopId": "12345",
    "apiKey": "abcdef123456",
    "payment": 500,
    "deliveryMethod": 0,
    "lines": [
      { "productId": "100", "quantity": 2 },
      { "label": "Extra napkins", "price": 0.50, "quantity": 1 }
    ],
    "idUser": 1,
    "idClient": null
  }
}

The server will validate inputs and return a standard MCP response with the created order/receipt.

Use Cases

Voice/Chat checkout: Let staff or a conversational assistant record orders hands-free: “Record two coffees and one croissant for table 4.”
Reporting: Ask “What’s my revenue this week?” and receive a summarized report generated from POS data.
Help desk lookups: “Show invoice for order #125” to fetch and display receipt details in chat.
Automation: Trigger MCP calls from n8n or a workflow engine to synchronize sales data with accounting or CRM.
Inventory checks: “Is item SKU-100 in stock?” to query product and variation stock levels.

Where to get help / Source

GitHub repository: https://github.com/paracetamol951/caisse-enregistreuse-mcp-server
Hosted demo: https://mcp.kash.click

For integration details, schema definitions, and advanced configuration options, consult the repository README and source code.

Kash.click MCP Server for POS Integration