KASSA.AT MCP by usefulapi

Read and update articles, customers and stock in KASSA.AT.

Should I use this

Quality & Safety

A
Description quality
98%
Schema completeness
92%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (1)

  • LOWTool 'kassa_update_article' description lacks action verbin kassa_update_article

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~3,250Tokens (tool definitions)
~2.5 KBTypical response size
Significant attention impact (2.54% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "kassa-at": {
      "url": "https://kassa-at.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://kassa-at.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (12)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢kassa_list_articles(query, article_number, bar_code, company_article_id, product_category_id, ...)

List the articles (products and services) of the cash register, with price, VAT percent, unit and bar codes. Full-text search with query, or filter by article number, bar code or your own article id. GET /api/v1/articles.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Full-text search over the article fields.",
      "type": "string",
      "maxLength": 200
    },
    "article_number": {
      "description": "Exact article number.",
      "type": "string",
      "maxLength": 59
    },
    "bar_code": {
      "description": "Exact bar code.",
      "type": "string",
      "maxLength": 59
    },
    "company_article_id": {
      "description": "Your own article number (number, or an operator as in the docs).",
      "type": "string",
      "maxLength": 60
    },
    "product_category_id": {
      "description": "Product category id.",
      "type": "string",
      "maxLength": 60
    },
    "sort": {
      "description": "Sort field and direction, as the KASSA.AT docs show.",
      "type": "string",
      "maxLength": 100
    },
    "fields": {
      "description": "Comma-separated list of fields to return, for example id,line_item_name.",
      "type": "string",
      "maxLength": 500
    },
    "page": {
      "description": "Page number, starts at 1. Use together with limit.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Rows per page, 1 to 1000 (default 100).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢kassa_list_article_categories(article_id)

List the product categories an article belongs to (id, name, colour). GET /api/v1/articles/{id}/product_categories.

Input Schema

{
  "type": "object",
  "properties": {
    "article_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The internal article id (from kassa_list_articles)."
    }
  },
  "required": [
    "article_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢kassa_list_customers(query, customer_number, company_name, email, city, ...)

List customers, with name, customer number, address, phone and email. Full-text search with query, or filter by a field. GET /api/v1/customers.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Full-text search over the customer fields.",
      "type": "string",
      "maxLength": 200
    },
    "customer_number": {
      "description": "Exact customer number.",
      "type": "string",
      "maxLength": 59
    },
    "company_name": {
      "description": "Company name (exact filter as the docs show).",
      "type": "string",
      "maxLength": 119
    },
    "email": {
      "description": "E-mail address (exact filter).",
      "type": "string",
      "maxLength": 99
    },
    "city": {
      "type": "string",
      "maxLength": 99
    },
    "sort": {
      "description": "Sort field and direction, as the KASSA.AT docs show.",
      "type": "string",
      "maxLength": 100
    },
    "fields": {
      "description": "Comma-separated list of fields to return, for example id,line_item_name.",
      "type": "string",
      "maxLength": 500
    },
    "page": {
      "description": "Page number, starts at 1. Use together with limit.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Rows per page, 1 to 1000 (default 100).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢kassa_find_customer_by_number(customer_number)

Find one customer by the customer number you assigned. GET /api/v1/customers/customer_number.

Input Schema

{
  "type": "object",
  "properties": {
    "customer_number": {
      "type": "string",
      "minLength": 1,
      "maxLength": 59,
      "description": "The customer number."
    }
  },
  "required": [
    "customer_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢kassa_list_warehouses(deleted)

List the warehouses (stock locations) of the company, with id and description. GET /api/v1/warehouses.

Input Schema

{
  "type": "object",
  "properties": {
    "deleted": {
      "description": "true = only deleted warehouses, false = only active ones. Leave out for both.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢kassa_list_inventories(warehouse_id, article_numbers, article_number, article, active, ...)

List the inventory records of a warehouse for given articles, optionally with the current stock. Rate limited by KASSA.AT. Give article_numbers (up to 1000), article_number or article. POST /api/v1/warehouses/{id}/inventories/search (a read).

Input Schema

{
  "type": "object",
  "properties": {
    "warehouse_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The warehouse id (from kassa_list_warehouses)."
    },
    "article_numbers": {
      "description": "Article numbers to look up.",
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 59
      }
    },
    "article_number": {
      "description": "One article number.",
      "type": "string",
      "maxLength": 59
    },
    "article": {
      "description": "One internal article id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "active": {
      "description": "true = only active inventories, false = only inactive.",
      "type": "boolean"
    },
    "inspect_stock": {
      "description": "true = include the current stock in each record.",
      "type": "boolean"
    }
  },
  "required": [
    "warehouse_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢kassa_get_inventory_stock(warehouse_id, inventory_id)

Get the current stock quantity of one inventory record. GET /api/v1/warehouses/{id}/inventories/{inventory_id}/stock.

Input Schema

{
  "type": "object",
  "properties": {
    "warehouse_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The warehouse id."
    },
    "inventory_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The inventory id (from kassa_list_inventories)."
    }
  },
  "required": [
    "warehouse_id",
    "inventory_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴kassa_create_article(line_item_name, gross_amount_per_item, sales_tax_percentage, default_quantity, article_number, ...)

Create a new article (product or service) in the cash register. The VAT percent must be 0, 10, 13 or 20. Creates a record; it does not delete anything. POST /api/v1/articles.

Input Schema

{
  "type": "object",
  "properties": {
    "line_item_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 249,
      "description": "Article name shown on receipts."
    },
    "gross_amount_per_item": {
      "type": "number",
      "minimum": 0,
      "description": "Gross price per item."
    },
    "sales_tax_percentage": {
      "anyOf": [
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 10
        },
        {
          "type": "number",
          "const": 13
        },
        {
          "type": "number",
          "const": 20
        }
      ],
      "description": "VAT percent: 0, 10, 13 or 20."
    },
    "default_quantity": {
      "type": "number",
      "description": "Default quantity per sale."
    },
    "article_number": {
      "type": "string",
      "maxLength": 59
    },
    "unit": {
      "description": "Unit, for example \"Stk\" or \"kg\".",
      "type": "string",
      "maxLength": 9
    },
    "bar_code": {
      "type": "string",
      "maxLength": 59
    },
    "bar_code_2": {
      "type": "string",
      "maxLength": 59
    },
    "product_name": {
      "type": "string",
      "maxLength": 59
    },
    "product_type": {
      "type": "string",
      "maxLength": 59
    },
    "brand": {
      "type": "string",
      "maxLength": 59
    },
    "manufacturer": {
      "type": "string",
      "maxLength": 59
    },
    "supplier_article_number": {
      "type": "string",
      "maxLength": 59
    },
    "product_description": {
      "type": "string",
      "maxLength": 5000
    },
    "variant_description": {
      "type": "string",
      "maxLength": 59
    },
    "product_category_id": {
      "description": "Comma-separated product category ids.",
      "type": "string",
      "maxLength": 200
    },
    "favourite": {
      "type": "boolean"
    },
    "food": {
      "type": "boolean"
    },
    "drink": {
      "type": "boolean"
    },
    "manual_gross_amount_entry": {
      "description": "Let the cashier enter the price by hand.",
      "type": "boolean"
    },
    "manual_quantity_entry": {
      "description": "Let the cashier enter the quantity by hand.",
      "type": "boolean"
    },
    "print_price_per_kg": {
      "type": "boolean"
    },
    "print_pickup_number": {
      "type": "boolean"
    }
  },
  "required": [
    "line_item_name",
    "gross_amount_per_item",
    "sales_tax_percentage",
    "default_quantity"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴kassa_update_article(article_id, line_item_name, gross_amount_per_item, sales_tax_percentage, default_quantity, ...)

Change one or more fields of an article. Only the fields you pass change; the rest stay as they are. PATCH /api/v1/articles/{id}.

Input Schema

{
  "type": "object",
  "properties": {
    "article_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The internal article id."
    },
    "line_item_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 249
    },
    "gross_amount_per_item": {
      "description": "New gross price per item.",
      "type": "number",
      "minimum": 0
    },
    "sales_tax_percentage": {
      "anyOf": [
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 10
        },
        {
          "type": "number",
          "const": 13
        },
        {
          "type": "number",
          "const": 20
        }
      ]
    },
    "default_quantity": {
      "type": "number"
    },
    "article_number": {
      "type": "string",
      "maxLength": 59
    },
    "unit": {
      "description": "Unit, for example \"Stk\" or \"kg\".",
      "type": "string",
      "maxLength": 9
    },
    "bar_code": {
      "type": "string",
      "maxLength": 59
    },
    "bar_code_2": {
      "type": "string",
      "maxLength": 59
    },
    "product_name": {
      "type": "string",
      "maxLength": 59
    },
    "product_type": {
      "type": "string",
      "maxLength": 59
    },
    "brand": {
      "type": "string",
      "maxLength": 59
    },
    "manufacturer": {
      "type": "string",
      "maxLength": 59
    },
    "supplier_article_number": {
      "type": "string",
      "maxLength": 59
    },
    "product_description": {
      "type": "string",
      "maxLength": 5000
    },
    "variant_description": {
      "type": "string",
      "maxLength": 59
    },
    "product_category_id": {
      "description": "Comma-separated product category ids.",
      "type": "string",
      "maxLength": 200
    },
    "favourite": {
      "type": "boolean"
    },
    "food": {
      "type": "boolean"
    },
    "drink": {
      "type": "boolean"
    },
    "manual_gross_amount_entry": {
      "description": "Let the cashier enter the price by hand.",
      "type": "boolean"
    },
    "manual_quantity_entry": {
      "description": "Let the cashier enter the quantity by hand.",
      "type": "boolean"
    },
    "print_price_per_kg": {
      "type": "boolean"
    },
    "print_pickup_number": {
      "type": "boolean"
    }
  },
  "required": [
    "article_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴kassa_create_customer(customer_number, company_name, first_name, last_name, address, ...)

Create a customer record. Give at least one field. Creates a record; it does not delete anything. POST /api/v1/customers.

Input Schema

{
  "type": "object",
  "properties": {
    "customer_number": {
      "description": "Your customer number. An existing customer with this number is reused.",
      "type": "string",
      "maxLength": 59
    },
    "company_name": {
      "description": "Company name of the customer.",
      "type": "string",
      "maxLength": 119
    },
    "first_name": {
      "type": "string",
      "maxLength": 99
    },
    "last_name": {
      "type": "string",
      "maxLength": 99
    },
    "address": {
      "description": "Street and house number.",
      "type": "string",
      "maxLength": 99
    },
    "city": {
      "type": "string",
      "maxLength": 99
    },
    "zip": {
      "type": "string",
      "maxLength": 99
    },
    "country": {
      "type": "string",
      "maxLength": 99
    },
    "phone_number": {
      "type": "string",
      "maxLength": 99
    },
    "fax_number": {
      "type": "string",
      "maxLength": 99
    },
    "email": {
      "type": "string",
      "maxLength": 99
    },
    "uid": {
      "description": "VAT id (UID-Nummer).",
      "type": "string",
      "maxLength": 99
    },
    "tax_number": {
      "description": "Tax number (Steuernummer).",
      "type": "string",
      "maxLength": 99
    },
    "notice_1": {
      "type": "string",
      "maxLength": 239
    },
    "notice_2": {
      "type": "string",
      "maxLength": 239
    },
    "notice_3": {
      "type": "string",
      "maxLength": 239
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴kassa_update_customer(customer_id, customer_number, company_name, first_name, last_name, ...)

Change one or more fields of a customer. Only the fields you pass change. This tool does not delete customers. PATCH /api/v1/customers/{id}.

Input Schema

{
  "type": "object",
  "properties": {
    "customer_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The internal customer id (from kassa_list_customers)."
    },
    "customer_number": {
      "description": "Your customer number. An existing customer with this number is reused.",
      "type": "string",
      "maxLength": 59
    },
    "company_name": {
      "description": "Company name of the customer.",
      "type": "string",
      "maxLength": 119
    },
    "first_name": {
      "type": "string",
      "maxLength": 99
    },
    "last_name": {
      "type": "string",
      "maxLength": 99
    },
    "address": {
      "description": "Street and house number.",
      "type": "string",
      "maxLength": 99
    },
    "city": {
      "type": "string",
      "maxLength": 99
    },
    "zip": {
      "type": "string",
      "maxLength": 99
    },
    "country": {
      "type": "string",
      "maxLength": 99
    },
    "phone_number": {
      "type": "string",
      "maxLength": 99
    },
    "fax_number": {
      "type": "string",
      "maxLength": 99
    },
    "email": {
      "type": "string",
      "maxLength": 99
    },
    "uid": {
      "description": "VAT id (UID-Nummer).",
      "type": "string",
      "maxLength": 99
    },
    "tax_number": {
      "description": "Tax number (Steuernummer).",
      "type": "string",
      "maxLength": 99
    },
    "notice_1": {
      "type": "string",
      "maxLength": 239
    },
    "notice_2": {
      "type": "string",
      "maxLength": 239
    },
    "notice_3": {
      "type": "string",
      "maxLength": 239
    }
  },
  "required": [
    "customer_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴kassa_record_stock_movement(warehouse_id, inventory_id, quantity, text, type)

Add a stock movement to one inventory: a positive quantity adds stock, a negative one removes it. It changes the stock level; it does not set an absolute level. POST /api/v1/warehouses/{id}/inventories/{inventory_id}/movements.

Input Schema

{
  "type": "object",
  "properties": {
    "warehouse_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The warehouse id."
    },
    "inventory_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The inventory id."
    },
    "quantity": {
      "type": "number",
      "description": "Positive = stock in, negative = stock out."
    },
    "text": {
      "description": "Short note for the movement (under 100 characters).",
      "type": "string",
      "maxLength": 99
    },
    "type": {
      "description": "Force the direction. Leave out to use the sign of quantity.",
      "type": "string",
      "enum": [
        "increase",
        "decrease"
      ]
    }
  },
  "required": [
    "warehouse_id",
    "inventory_id",
    "quantity"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded12 tools