# Kash — POS, Invoicing, CRM & Webshop # Kash MCP Server — Official Integration ## Quick Start ```bash # Connect this server (installs CLI if needed) npx -y @smithery/cli@latest mcp add paracetamol951/kash # Browse available tools npx -y @smithery/cli@latest tool list paracetamol951/kash # Get full schema for a tool npx -y @smithery/cli@latest tool get paracetamol951/kash account_list # Call a tool npx -y @smithery/cli@latest tool call paracetamol951/kash account_list '{}' ``` ## Direct MCP Connection Endpoint: `https://kash.run.tools` **Optional config:** - `Shop_ID` (header) — Your Kash shop ID. Optional — you can authenticate in-conversation or with oAuth instead. - `Api_Key` (header) — Your Kash API key. Optional — you can authenticate in-conversation or with oAuth instead. ## Tools (39) - `account_list` — List all Kash / free-cash-register.net accounts linked to an email address. Use this before account_create to check if … - `account_create` — Create a new Kash / free-cash-register.net account. Requires an email address and a shop name (accountTitle). Optional:… - `auth_request_otp` — Step 1 of 2 for in-conversation authentication. Sends a one-time password (OTP) to the user's email address. If the use… - `auth_login_with_otp` — Step 2 of 2 for in-conversation authentication. Exchange the OTP received by email for an APIKEY and SHOPID, and automa… - `account_edit` — Modify the settings of the authenticated shop account. All fields are optional. Covers: basic info (name, address, lega… - `account_show_infos` — Retrieve all current settings of the authenticated shop account as a JSON object. Returns the full shop configuration: … - `auth_logout` — Clear the current authentication session (APIKEY and SHOPID). After this, all tools requiring authentication will fail … - `report_get` — Download a synthetic HTML sales report for a given period. Period logic: omit all date fields to get yesterday's report… - `order_create` — Record a new order in the connected shop. Input includes paymentMode, and items[]. Each item can be of type 'catalog' (… - `order_edit` — Modify an existing order by its ID. Use the payment field to control the order state: -2 = keep as unvalidated quote (n… - `data_list_products` — Retrieve the list of articles (products) configured in the shop. Returns an array of products with fields like id, titl… - `data_list_departments` — Get all departments (product categories) defined in the shop, including their names and default tax rates. Supports for… - `data_list_department_groups` — Return the list of department groups, used to organize product categories. Each group may include multiple department I… - `data_list_clients` — Get the list of clients registered in the shop, including contact info, loyalty points. - `data_list_variations` — Retrieve product variations (declinaisons) such as size or color. Returns an array of variant definitions with value an… - `data_list_delivery_men` — List all delivery methods available for the shop, such as in-store pickup, home delivery, or courier services. - `data_list_payments_modes` — tools.data.list.payments.description - `data_list_cashboxes` — List the registered cashboxes (physical or virtual) linked to the shop, including their current status and identifiers. - `data_list_delivery_zones` — Return all configured delivery zones, including area names, postal codes, and applicable delivery fees or restrictions. - `data_list_relay_points` — List all relay points where customers can pick up their orders, including address, city, and postal code. - `data_list_discounts` — Return all available discounts or promotions, including their names, types (percentage or fixed), values, and condition… - `data_list_users` — List all users (cashiers, managers, etc.) associated with the shop, including their roles and identifiers. - `data_list_tables` — Retrieve the list of tables configured in the app, used for restaurant mode or table management. - `data_list_vats` — Retrieve the list of VAT rates configured in the shop, including their title, rate percentage, and optional accounting … - `data_list_pending_orders` — Retrieve the list of unvalidated orders (that can still be modified) - `data_list_orders` — List either: unvalidated orders (called quotes) with creation date between from_date_ISO8601 and to_date_ISO8601 OR val… - `order_detail` — Retrieve full order information by its unique ID, including items, client data, payment mode, and total amount. - `vat_add` — Add a new VAT rate to the shop configuration. Requires a title and a rate (e.g. 20 for 20%). Optional fields: accountin… - `vat_edit` — Modify an existing VAT rate by its ID. All fields are optional except the ID. - `vat_delete` — Permanently remove a VAT rate from the shop configuration by its ID. - `plu_add` — Add a new item/article to the shop catalog. Requires a title. Optional fields include price, department (deptID), VAT r… - `plu_edit` — Edit an existing item/article in the catalog by its ID. All fields are optional except the ID. Use data_list_products t… - `plu_delete` — Permanently remove an item/article from the catalog by its ID. - `dept_add` — Add a new department (product category) to the catalog. Requires a title. Optional fields include VAT rate (vatID), pri… - `dept_edit` — Edit an existing department/category by its ID. All fields are optional except the ID. Use data_list_departments to fin… - `dept_delete` — Permanently remove a department/category from the catalog by its ID. - `client_add` — Add a new customer to the shop's customer file. All fields are optional: name, surname, email, phone, address, company … - `client_edit` — Edit an existing customer by their ID. All fields are optional except the ID. Use data_list_clients to find the custome… - `client_delete` — Permanently remove a customer from the shop's customer file by their ID. ```bash # Get full input/output schema for a tool npx -y @smithery/cli@latest tool get paracetamol951/kash ``` ## Resources - `kash://spec` — Kash agent specification: payment values, delivery methods, VAT logic, order states, and agent behavior rules. - `kash://catalog-guide` — Kash catalog guide: product fields, department hierarchy, variation system, stock management, visibility flags, and kit… - `kash://client-guide` — Kash client/CRM guide: identity fields, address, business data, loyalty, blacklist, segmentation, and agent rules for c… ## Prompts (4) - `authenticate` (email) — Step-by-step guide to log in to a Kash shop via email OTP and initialise the session. - `record-sale` (items_description, payment_method) — Guided workflow to create a complete sale: find products, identify the client, choose payment method, and submit. - `daily-report` (date) — Retrieve and summarise the sales report for a given date or today. - `add-product` (product_name, price) — Guided workflow to create a product: choose department, VAT rate, price and optional variations.