Elementary POS MCP by usefulapi

List receipts, stock and customers, edit customers and add stock changes in Elementary POS.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
71%
이름 품질
77%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

발견 사항 (3)

  • LOWTool 'elementarypos_list_cash_journal' name length outside 3-30 rangeelementarypos_list_cash_journal에서
  • LOWTool 'elementarypos_list_stock_changes' name length outside 3-30 rangeelementarypos_list_stock_changes에서
  • LOWTool 'elementarypos_get_webhook_status' name length outside 3-30 rangeelementarypos_get_webhook_status에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,771토큰 (도구 정의)
~827 B일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 2.16%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`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"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 21개