Caisse Enregistreuse MCP Server

What paracetamol951/caisse-enregistreuse-mcp-server MCP server does

The paracetamol951/caisse-enregistreuse-mcp-server MCP server exposes Kash business operations as MCP tools. Kash is a cloud platform covering point-of-sale activity, invoicing, CRM, and webshops. Agents can use the connection to record and inspect sales, work with orders, manage catalog structures, retrieve reference data, and maintain customer records.

The repository lists 46 available tools. Supported operations include creating and editing orders, recording payments, assigning customers, validating orders as invoices, and filtering order lists by dates or status. Reporting includes an HTML sales summary for a selected period, with a default period of the previous day.

How it works

Two connection modes are documented. The hosted mode uses https://mcp.kash.click/mcp, so the client does not need a local installation. Authentication for this endpoint uses OAuth 2.0 with PKCE. The server also documents Claude.ai, ChatGPT, and Smithery connection flows, although client support depends on the MCP product being used.

The local mode runs through STDIO. The npm package starts the server, which then uses a Kash shop identifier and API key supplied as command-line options or environment variables. Kash credentials can be obtained from Setup → Webservices. Alternatively, users can authenticate during a conversation with an email OTP, or create a Kash account through the account tools.

Setup and configuration

For hosted use, configure an MCP client with the server URL and OAuth authentication. No local package installation is required. The documented endpoint is https://mcp.kash.click/mcp; a health endpoint and MCP manifest are also available for the hosted service.

For local use, install and run the npm package with the SHOPID and APIKEY values. The README also documents building from source with npm and starting build/stdio.js. A Docker-based HTTP mode is available, but it requires Redis and is run through the repository’s Docker Compose setup or a separate Redis container.

The account tools can check whether an email already has a Kash account, create an account, request an OTP, complete OTP login, and log out. This provides an in-conversation alternative to configuring API credentials, where supported by the server flow.

Tools and capabilities

The paracetamol951/caisse-enregistreuse-mcp-server MCP server organizes tools across these areas:

• Account creation and account lookup
• OTP authentication and session logout
• Sales, order creation, order editing, order details, and pending orders
• Period-based sales reports
• Product, department, department-group, VAT, variation, and variation-choice management
• Customer creation, editing, deletion, and listing
• Lists of payments, cashboxes, delivery methods, delivery zones, pickup points, discounts, users, and restaurant tables
• A ping utility for basic availability checks

Catalog tools can store product details such as price, department, VAT, barcode, stock, and variations. Customer tools cover contact information, company data, VAT numbers, loyalty details, notes, and blacklist status, as described in the project material.

Limitations and notes

A Kash account is required for normal business use. The README states that the hosted route uses OAuth, while the STDIO route uses a shop ID and API key or the documented authentication tools. HTTP self-hosting requires Redis. Tool titles and descriptions are available in English and French, with language resolution handled automatically.

The project is licensed under GPL v3. The repository also links to a hosted demonstration and publishes the caisse-enregistreuse-mcp-server npm package, but the provided material does not specify service-level guarantees, usage quotas, or data-retention policies.