KASSA.AT MCP by usefulapi
Read and update articles, customers and stock in KASSA.AT.
Should I use this
Quality & Safety
Findings (1)
- LOWin kassa_update_article
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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-httpWhat it can do
Tool inventory
Tools (12)
🟢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
Evidence