Elementary POS MCP by usefulapi
List receipts, stock and customers, edit customers and add stock changes in Elementary POS.
使うべきか
品質と安全性
検出事項(3)
- LOWelementarypos_list_cash_journal 内
- LOWelementarypos_list_stock_changes 内
- LOWelementarypos_get_webhook_status 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"elementary-pos": {
"url": "https://elementary-pos.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://elementary-pos.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(21)
🟢elementarypos_list_receipts(from, to, lastModifiedFrom, deviceId, limit, ...)
List sales receipts, filtered by date range, last-modified time or cash register. Good for sales summaries. Elementary POS API: POST /v1/receipt/get-receipts.
入力スキーマ
{
"type": "object",
"properties": {
"from": {
"description": "Start of the range, as text in the format the API accepts (ISO 8601).",
"type": "string"
},
"to": {
"description": "End of the range, as text in the format the API accepts (ISO 8601).",
"type": "string"
},
"lastModifiedFrom": {
"description": "Only receipts modified at or after this time (ISO 8601).",
"type": "string"
},
"deviceId": {
"description": "Only results from this cash register device (from list_devices).",
"type": "string"
},
"limit": {
"description": "Maximum number of results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page": {
"description": "Page number for pagination (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_get_receipt(receipt_id)
Get one receipt with its items, totals, payment type and cashier. Elementary POS API: POST /v1/receipt/get-receipt.
入力スキーマ
{
"type": "object",
"properties": {
"receipt_id": {
"type": "string",
"minLength": 1,
"description": "The receipt id."
}
},
"required": [
"receipt_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_list_open_bills
List the open bills (tabs) on the cash registers right now. Elementary POS API: POST /v1/bill/get-bills.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_get_bill(bill_id)
Get one open bill with its name, total, type and customer. Elementary POS API: POST /v1/bill/get-bill.
入力スキーマ
{
"type": "object",
"properties": {
"bill_id": {
"type": "string",
"minLength": 1,
"description": "The bill id."
}
},
"required": [
"bill_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_get_order(order_id)
Get one order (items added to a bill) with its state, quantity and note. Elementary POS API: POST /v1/order/get-order.
入力スキーマ
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"description": "The order id."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_list_cash_journal(from, to, lastCreatedFrom, deviceId, limit, ...)
List the cash journal: cash added to or removed from the drawer, with amount, note and cashier. Elementary POS API: POST /v1/cash-register/get-cash-journal.
入力スキーマ
{
"type": "object",
"properties": {
"from": {
"description": "Start of the range, as text in the format the API accepts (ISO 8601).",
"type": "string"
},
"to": {
"description": "End of the range, as text in the format the API accepts (ISO 8601).",
"type": "string"
},
"lastCreatedFrom": {
"description": "Only records created at or after this time (ISO 8601).",
"type": "string"
},
"deviceId": {
"description": "Only results from this cash register device (from list_devices).",
"type": "string"
},
"limit": {
"description": "Maximum number of results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page": {
"description": "Page number for pagination (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_list_devices
List the cash register devices of the account, with name, model, mode and whether each is active. Elementary POS API: POST /v1/cash-register/get-devices.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_list_items(category_id, category_name, color)
List the sales items (products and services) with price, currency, tax id, category and on-sale flag. Optional filter by category. Elementary POS API: POST /v1/item/get-sales-items.
入力スキーマ
{
"type": "object",
"properties": {
"category_id": {
"description": "Only items in this category (from list_categories).",
"type": "string"
},
"category_name": {
"description": "Only items in the category with this name.",
"type": "string"
},
"color": {
"description": "Only items with this colour number.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_list_categories
List the item categories with their parent category and visibility. Elementary POS API: POST /v1/category/get-categories.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_get_category(category_id)
Get one item category by id. Elementary POS API: POST /v1/category/get-category.
入力スキーマ
{
"type": "object",
"properties": {
"category_id": {
"type": "string",
"minLength": 1,
"description": "The category id."
}
},
"required": [
"category_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_get_tax_settings
Read the tax rates and tax ids the sales items use. Elementary POS API: POST /v1/tax/get-tax-settings.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_list_customers
List the customers with contact details, loyalty id and loyalty points. Elementary POS API: POST /v1/customer/get-customers.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_get_customer(customer_id)
Get one customer with contact details, loyalty points and last visit. Elementary POS API: POST /v1/customer/get-customer.
入力スキーマ
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"minLength": 1,
"description": "The customer id."
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴elementarypos_create_customer(name, email, phone, note, loyalty_id)
Create a new customer record. Creates a new record on every call, so check list_customers first. Elementary POS API: POST /v1/customer/create-customer.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Customer name."
},
"email": {
"description": "Customer e-mail address.",
"type": "string"
},
"phone": {
"description": "Customer phone number.",
"type": "string"
},
"note": {
"description": "Free-text note on the customer.",
"type": "string"
},
"loyalty_id": {
"description": "Loyalty card id.",
"type": "string"
}
},
"required": [
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡elementarypos_edit_customer(customer_id, name, email, phone, note, ...)
Change a customer's name, e-mail, phone, note or loyalty id. Sends only the fields you pass; the same values again give the same result. Elementary POS API: POST /v1/customer/edit-customer.
入力スキーマ
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"minLength": 1,
"description": "The customer id."
},
"name": {
"type": "string",
"minLength": 1,
"description": "Customer name (required by the API, also when unchanged)."
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"note": {
"type": "string"
},
"loyalty_id": {
"type": "string"
}
},
"required": [
"customer_id",
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_list_suppliers
List the suppliers with contact details. Elementary POS API: POST /v1/supplier/get-suppliers.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_get_supplier(supplier_id)
Get one supplier by id. Elementary POS API: POST /v1/supplier/get-supplier.
入力スキーマ
{
"type": "object",
"properties": {
"supplier_id": {
"type": "string",
"minLength": 1,
"description": "The supplier id."
}
},
"required": [
"supplier_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_get_stock
Read the actual stock quantity per item SKU, with unit and a low-stock flag. Elementary POS API: POST /v1/stock/get-actual-stock-data.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_list_stock_changes(last_sync_timestamp, skip_plugin_id)
List stock changes since a sync timestamp. Returns a new syncTimestamp to pass next time. Elementary POS API: POST /v1/stock/get-stock-changes.
入力スキーマ
{
"type": "object",
"properties": {
"last_sync_timestamp": {
"description": "Return changes after this timestamp (0 or omit for all).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"skip_plugin_id": {
"description": "Leave out changes made by this plugin id.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴elementarypos_add_stock_change(sku, quantity, request_id, unit, price, ...)
Add a stock movement for one SKU (quantity can be negative for a sale or write-off). Use a new request_id for every change: a repeated request_id can be rejected or counted twice. Elementary POS API: POST /v1/stock/add-stock-change.
入力スキーマ
{
"type": "object",
"properties": {
"sku": {
"type": "string",
"minLength": 1,
"description": "Item SKU, as in get_stock."
},
"quantity": {
"type": "number",
"description": "Quantity to add (positive) or remove (negative)."
},
"request_id": {
"type": "string",
"minLength": 1,
"description": "Unique id for this change, e.g. a new UUID per call."
},
"unit": {
"description": "Unit of the quantity, e.g. pcs.",
"type": "string"
},
"price": {
"description": "Unit purchase price.",
"type": "number"
},
"currency": {
"description": "Currency code of the price, e.g. CZK.",
"type": "string"
},
"note": {
"description": "Free-text note for the stock movement.",
"type": "string"
}
},
"required": [
"sku",
"quantity",
"request_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢elementarypos_get_webhook_status
Read whether the account's POS webhook is active, its URL and any error. Elementary POS API: POST /v1/webhook/get-webhook-status.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス