Kash MCP Server is a server compliant with the MCP (Model Context Protocol), allowing ChatGPT, Claude, and other MCP-compatible clients to connect to a sales recorder system (or POS, cash register). It provides a simple interface to: - 📊 View sales and revenue - 🧾 Create and record receipts - 🛒 Manage products and stock - 🧠 Generate automated reports through conversational requests Connect you
Add this skill
npx mdskills install paracetamol951/caisse-enregistreuse-mcp-serverWell-documented POS integration with comprehensive tool coverage and clear setup instructions
1# 🧾 Kash MCP Server23[](LICENSE)4[](https://mcp.kash.click)5[](https://github.com/paracetamol951/caisse-enregistreuse-mcp-server/stargazers)67[](https://www.youtube.com/watch?v=PpkrUfEy4ns)89**Kash MCP Server** is a server compliant with the **MCP (Model Context Protocol)**, allowing ChatGPT, Claude, and other MCP-compatible clients to connect to a **sales recorder system** (or POS, cash register).1011It provides a simple interface to:12- 📊 View sales and revenue13- 🧾 Create and record receipts14- 🛒 Manage products and stock15- 🧠 Generate automated reports through conversational requests1617> 🟢 Live Server: [https://mcp.kash.click](https://mcp.kash.click)1819---2021**Connect your cash register to ChatGPT, Claude, or n8n — and manage your business simply by talking.**22232425Imagine your cash register understanding your sentences, executing your commands, and analyzing your reports — without a single click.26With this intelligent gateway, the **free-cash-register.net** software becomes compatible with ChatGPT, Claude, and n8n, transforming your interactions into concrete actions.27Just say “record an order for two coffees at table 4” or “show me the invoice for order 125” — and it’s done.2829You can also ask “what’s my revenue for this week?” or “who are my best customers on Tuesdays?”.30Your favorite assistant communicates directly with your cash register and responds instantly.31This is a new way to run your business: smoother, faster, and incredibly natural.32Your **voice becomes your interface**, and your **assistant becomes your new coworker**.3334This project exposes the **kash.click** API as **Model Context Protocol (MCP)** tools, available over **HTTP (Streamable)** and/or **STDIO**.3536---3738## 🚀 Features3940- **Sales**: `sale_create` with support for catalog and free lines.41- **Orders** : get the order list in the specified date range42- **Data** (lists): products, departments, department groups, clients, variations, deliveries, payment methods, cashboxes, delivery zones, relay points, discounts, users…4344---4546## 🔹 Example usage (ChatGPT / Claude MCP)4748- 💬 “Show me today’s sales”49- 💬 “Record a sale of 2 coffees and 1 croissant at table 84”50- 💬 “Ten red roses to deliver to Mrs. Dupond at 6:15 PM!”51- 💬 “Generate a cash register report for the week”52- 💬 “Have takeaway sales increased this year?”53- 💬 “Did customer Dupont pay for their order?”5455---5657## ⚙Prerequisities5859You need to have a free-cash-register.net account.6061If you don't have one, you can register at :6263https://kash.click/free-pos-software/ChatGPT6465Then in the software, you have to get your APIKEY and SHOPID in Setup, Webservices page.6667---6869## ⚙️ Installation7071### Claude7273#### Minimum installation7475Edit the file `claude_desktop_config.json` in your Claude Desktop configuration directory:7677Windows78```79%APPDATA%\Claude\claude_desktop_config.json80```8182Mac OS83```84~/Library/Application Support/Claude/claude_desktop_config.json85```8687Provide the following content after replacing your SHOPID and APIKEY.8889```json90 {91 "mcpServers": {92 "caisse": {93 "command": "npx",94 "args": [95 "caisse-enregistreuse-mcp-server",96 "--shopid=[replaceWithYourSHOPID]",97 "--apikey=[replaceWithYourAPIKEY]"98 ]99 }100 }101}102```103104#### Install via npx105106Create an installation folder and run the following command in your shell:107108```bash109npx caisse-enregistreuse-mcp-server --shopid=12345 --apikey=abcdef123456110```111112#### Install via npm113114```bash115# 1) Dependencies116npm install117118# 2) Environment variables (see below)119120# 3) Build121npm run build122```123124#### Configuration125126The binary/runner launches `src/stdio.ts` and communicates via MCP stdin/stdout.127Edit the file `claude_desktop_config.json` in your Claude Desktop configuration directory128Customize the installation path and set your SHOPID and APIKEY (retrieve them from [https://kash.click](https://kash.click)):129130```json131{132 "mcpServers": {133 "caisse": {134 "command": "node",135 "args": [136 "{{PATH_TO_SRC}}/build/stdio.js"137 ],138 "cwd": "{{PATH_TO_SRC}}",139 "env": {140 "SHOPID": "16",141 "APIKEY": "XXXXXXXX"142 }143 }144 }145}146```147148### ChatGPT149150> Requires a workspace account151152In **Settings → Connectors → Create Connector**, fill in the following:153154| Variable | Value |155|-----------|--------|156| `Name` | `Kash POS` |157| `Description` | `Can record sales from your catalog and retrieve your sales reports. POS software integration.` |158| `MCP Server URL` | `https://mcp.kash.click/mcp` |159| `Authentication` | `oAuth` |160161Once added, the connector will be **available in new conversations**.162163---164165### Environment variables166167| Variable | Default | Description |168|-----------|----------|-------------|169| `APIKEY` | `----` | Required: your API key |170| `SHOPID` | `----` | Required: your shop ID |171172Create a `.env` file:173174```env175APIKEY=XXXXXXXXXXXXXX176SHOPID=XXX177```178179---180181## ▶️ Launch182183### HTTP Mode (Streamable MCP)184185The HTTP mode requires a Redis server.186It is recommended to use the hosted MCP HTTP/WebSocket server available at [https://mcp.kash.click](https://mcp.kash.click):187188- **POST** `https://mcp.kash.click/mcp` with a JSON-RPC MCP message189- **GET** `https://mcp.kash.click/health` → `{ "status": "ok" }`190- **GET** `https://mcp.kash.click/.well-known/mcp/manifest.json` → MCP manifest191192---193194## 🧪 Available MCP Tools (excerpt)195196### `sale_create`197Creates a sale.198199Input (Zod schema, main fields):200- `shopId: string`, `apiKey: string`201- `payment: number`202- `deliveryMethod: 0|1|2|3|4|5|6`203- `idUser?: number | string`204- `idClient?: number | string`205- `idtable?: number | string`206- `idcaisse?: number | string`207- `numcouverts?: number | string`208- `publicComment?: string`209- `privateComment?: string`210- `pagerNum?: number | string`211- `client?: {{ firstname?, lastname?, email?, phone?, address?, zip?, city?, country? }}`212- `items: Array<213 {{ type:'catalog', productId?, quantity?, titleOverride?, priceOverride?, declinaisons? }}214 | {{ type:'dept', departmentId?, price?, title? }}215 | {{ type:'free', price?, title? }}216 >`217218Legacy item encoding:219- **Catalog**: `productId_quantity_titleOverride_priceOverride_[...declinaisons]`220- **Department sale**: `-<departmentId>_<price>_<title>`221- **Free line**: `Free_<price>_<title>`222→ Sent as `itemsList[]`.223224### `data_list_*` (examples)225- `data_list_products`226- `data_list_departments`227- `data_list_department_groups`228- `data_list_clients`229- `data_list_variations`230- `data_list_delivery_men`231- `data_list_payments`232- `data_list_cashboxes`233- `data_list_delivery_zones`234- `data_list_relay_points`235- `data_list_discounts`236- `data_list_users`237- `data_list_tables`238239All accept: `{{ format=('json'|'csv'|'html') }}`.240241---242243## 💻 Compatible Clients244245- **ChatGPT (OpenAI)** — via external MCP configuration246- **Claude (Anthropic)** — via “Tools manifest URL”247- **n8n / Flowise / LangChain** — import via public URL248249---250251## 🧩 MCP Manifest Endpoint252253The MCP API exposes a JSON manifest describing all available tools for compatible clients (ChatGPT, Claude, n8n, etc.).254255### Public manifest URL256257https://mcp.kash.click/.well-known/mcp/manifest.json258259> 🗂️ This URL is the one to provide to your MCP client when configuring the server.260261---262263## 📋 License264265© 2025. GNU GENERAL PUBLIC LICENSE266
Full transparency — inspect the skill content before installing.