Elementary POS MCP by usefulapi is an MCP server published by io.usefulapi, hosted at elementary-pos.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 21 tools, including elementarypos_list_receipts, elementarypos_get_receipt, elementarypos_list_open_bills, elementarypos_get_bill, elementarypos_get_order.
List receipts, stock and customers, edit customers and add stock changes in Elementary POS.
4,289 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| to | string | End of the range, as text in the format the API accepts (ISO 8601). |
| from | string | Start of the range, as text in the format the API accepts (ISO 8601). |
| page | integer | Page number for pagination (default 1). |
| limit | integer | Maximum number of results per page. |
| deviceId | string | Only results from this cash register device (from list_devices). |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| lastModifiedFrom | string | Only receipts modified at or after this time (ISO 8601). |
{
"name": "elementarypos_list_receipts",
"title": "List receipts",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"to": {
"type": "string",
"description": "End of the range, as text in the format the API accepts (ISO 8601)."
},
"from": {
"type": "string",
"description": "Start of the range, as text in the format the API accepts (ISO 8601)."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number for pagination (default 1).",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Maximum number of results per page.",
"exclusiveMinimum": 0
},
"deviceId": {
"type": "string",
"description": "Only results from this cash register device (from list_devices)."
},
"lastModifiedFrom": {
"type": "string",
"description": "Only receipts modified at or after this time (ISO 8601)."
}
}
},
"annotations": {
"title": "List receipts",
"readOnlyHint": true
}
}Get one receipt with its items, totals, payment type and cashier. Elementary POS API: POST /v1/receipt/get-receipt.
| Parameter | Type | Description |
|---|---|---|
| receipt_id * | string | The receipt id. |
{
"name": "elementarypos_get_receipt",
"title": "Get a receipt",
"description": "Get one receipt with its items, totals, payment type and cashier. Elementary POS API: POST /v1/receipt/get-receipt.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"receipt_id"
],
"properties": {
"receipt_id": {
"type": "string",
"minLength": 1,
"description": "The receipt id."
}
}
},
"annotations": {
"title": "Get a receipt",
"readOnlyHint": true
}
}List the open bills (tabs) on the cash registers right now. Elementary POS API: POST /v1/bill/get-bills.
No parameters.
{
"name": "elementarypos_list_open_bills",
"title": "List open bills",
"description": "List the open bills (tabs) on the cash registers right now. Elementary POS API: POST /v1/bill/get-bills.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List open bills",
"readOnlyHint": true
}
}Get one open bill with its name, total, type and customer. Elementary POS API: POST /v1/bill/get-bill.
| Parameter | Type | Description |
|---|---|---|
| bill_id * | string | The bill id. |
{
"name": "elementarypos_get_bill",
"title": "Get a bill",
"description": "Get one open bill with its name, total, type and customer. Elementary POS API: POST /v1/bill/get-bill.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"bill_id"
],
"properties": {
"bill_id": {
"type": "string",
"minLength": 1,
"description": "The bill id."
}
}
},
"annotations": {
"title": "Get a bill",
"readOnlyHint": true
}
}Get one order (items added to a bill) with its state, quantity and note. Elementary POS API: POST /v1/order/get-order.
| Parameter | Type | Description |
|---|---|---|
| order_id * | string | The order id. |
{
"name": "elementarypos_get_order",
"title": "Get an order",
"description": "Get one order (items added to a bill) with its state, quantity and note. Elementary POS API: POST /v1/order/get-order.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"description": "The order id."
}
}
},
"annotations": {
"title": "Get an order",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| to | string | End of the range, as text in the format the API accepts (ISO 8601). |
| from | string | Start of the range, as text in the format the API accepts (ISO 8601). |
| page | integer | Page number for pagination (default 1). |
| limit | integer | Maximum number of results per page. |
| deviceId | string | Only results from this cash register device (from list_devices). |
| lastCreatedFrom | string | Only records created at or after this time (ISO 8601). |
{
"name": "elementarypos_list_cash_journal",
"title": "List cash journal",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"to": {
"type": "string",
"description": "End of the range, as text in the format the API accepts (ISO 8601)."
},
"from": {
"type": "string",
"description": "Start of the range, as text in the format the API accepts (ISO 8601)."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number for pagination (default 1).",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Maximum number of results per page.",
"exclusiveMinimum": 0
},
"deviceId": {
"type": "string",
"description": "Only results from this cash register device (from list_devices)."
},
"lastCreatedFrom": {
"type": "string",
"description": "Only records created at or after this time (ISO 8601)."
}
}
},
"annotations": {
"title": "List cash journal",
"readOnlyHint": true
}
}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.
No parameters.
{
"name": "elementarypos_list_devices",
"title": "List cash register devices",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List cash register devices",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| color | integer | Only items with this colour number. |
| category_id | string | Only items in this category (from list_categories). |
| category_name | string | Only items in the category with this name. |
{
"name": "elementarypos_list_items",
"title": "List sales items",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"color": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Only items with this colour number."
},
"category_id": {
"type": "string",
"description": "Only items in this category (from list_categories)."
},
"category_name": {
"type": "string",
"description": "Only items in the category with this name."
}
}
},
"annotations": {
"title": "List sales items",
"readOnlyHint": true
}
}List the item categories with their parent category and visibility. Elementary POS API: POST /v1/category/get-categories.
No parameters.
{
"name": "elementarypos_list_categories",
"title": "List categories",
"description": "List the item categories with their parent category and visibility. Elementary POS API: POST /v1/category/get-categories.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List categories",
"readOnlyHint": true
}
}Get one item category by id. Elementary POS API: POST /v1/category/get-category.
| Parameter | Type | Description |
|---|---|---|
| category_id * | string | The category id. |
{
"name": "elementarypos_get_category",
"title": "Get a category",
"description": "Get one item category by id. Elementary POS API: POST /v1/category/get-category.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"category_id"
],
"properties": {
"category_id": {
"type": "string",
"minLength": 1,
"description": "The category id."
}
}
},
"annotations": {
"title": "Get a category",
"readOnlyHint": true
}
}Read the tax rates and tax ids the sales items use. Elementary POS API: POST /v1/tax/get-tax-settings.
No parameters.
{
"name": "elementarypos_get_tax_settings",
"title": "Get tax settings",
"description": "Read the tax rates and tax ids the sales items use. Elementary POS API: POST /v1/tax/get-tax-settings.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get tax settings",
"readOnlyHint": true
}
}List the customers with contact details, loyalty id and loyalty points. Elementary POS API: POST /v1/customer/get-customers.
No parameters.
{
"name": "elementarypos_list_customers",
"title": "List customers",
"description": "List the customers with contact details, loyalty id and loyalty points. Elementary POS API: POST /v1/customer/get-customers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List customers",
"readOnlyHint": true
}
}Get one customer with contact details, loyalty points and last visit. Elementary POS API: POST /v1/customer/get-customer.
| Parameter | Type | Description |
|---|---|---|
| customer_id * | string | The customer id. |
{
"name": "elementarypos_get_customer",
"title": "Get a customer",
"description": "Get one customer with contact details, loyalty points and last visit. Elementary POS API: POST /v1/customer/get-customer.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id"
],
"properties": {
"customer_id": {
"type": "string",
"minLength": 1,
"description": "The customer id."
}
}
},
"annotations": {
"title": "Get a customer",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Customer name. |
| note | string | Free-text note on the customer. |
| string | Customer e-mail address. | |
| phone | string | Customer phone number. |
| loyalty_id | string | Loyalty card id. |
{
"name": "elementarypos_create_customer",
"title": "Create a customer",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Customer name."
},
"note": {
"type": "string",
"description": "Free-text note on the customer."
},
"email": {
"type": "string",
"description": "Customer e-mail address."
},
"phone": {
"type": "string",
"description": "Customer phone number."
},
"loyalty_id": {
"type": "string",
"description": "Loyalty card id."
}
}
},
"annotations": {
"title": "Create a customer",
"readOnlyHint": false,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Customer name (required by the API, also when unchanged). |
| note | string | |
| string | ||
| phone | string | |
| loyalty_id | string | |
| customer_id * | string | The customer id. |
{
"name": "elementarypos_edit_customer",
"title": "Edit a customer",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id",
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Customer name (required by the API, also when unchanged)."
},
"note": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"loyalty_id": {
"type": "string"
},
"customer_id": {
"type": "string",
"minLength": 1,
"description": "The customer id."
}
}
},
"annotations": {
"title": "Edit a customer",
"readOnlyHint": false,
"idempotentHint": true
}
}List the suppliers with contact details. Elementary POS API: POST /v1/supplier/get-suppliers.
No parameters.
{
"name": "elementarypos_list_suppliers",
"title": "List suppliers",
"description": "List the suppliers with contact details. Elementary POS API: POST /v1/supplier/get-suppliers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List suppliers",
"readOnlyHint": true
}
}Get one supplier by id. Elementary POS API: POST /v1/supplier/get-supplier.
| Parameter | Type | Description |
|---|---|---|
| supplier_id * | string | The supplier id. |
{
"name": "elementarypos_get_supplier",
"title": "Get a supplier",
"description": "Get one supplier by id. Elementary POS API: POST /v1/supplier/get-supplier.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"supplier_id"
],
"properties": {
"supplier_id": {
"type": "string",
"minLength": 1,
"description": "The supplier id."
}
}
},
"annotations": {
"title": "Get a supplier",
"readOnlyHint": true
}
}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.
No parameters.
{
"name": "elementarypos_get_stock",
"title": "Get current stock",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get current stock",
"readOnlyHint": true
}
}List stock changes since a sync timestamp. Returns a new syncTimestamp to pass next time. Elementary POS API: POST /v1/stock/get-stock-changes.
| Parameter | Type | Description |
|---|---|---|
| skip_plugin_id | string | Leave out changes made by this plugin id. |
| last_sync_timestamp | integer | Return changes after this timestamp (0 or omit for all). |
{
"name": "elementarypos_list_stock_changes",
"title": "List stock changes",
"description": "List stock changes since a sync timestamp. Returns a new syncTimestamp to pass next time. Elementary POS API: POST /v1/stock/get-stock-changes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"skip_plugin_id": {
"type": "string",
"description": "Leave out changes made by this plugin id."
},
"last_sync_timestamp": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Return changes after this timestamp (0 or omit for all)."
}
}
},
"annotations": {
"title": "List stock changes",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| sku * | string | Item SKU, as in get_stock. |
| note | string | Free-text note for the stock movement. |
| unit | string | Unit of the quantity, e.g. pcs. |
| price | number | Unit purchase price. |
| currency | string | Currency code of the price, e.g. CZK. |
| quantity * | number | Quantity to add (positive) or remove (negative). |
| request_id * | string | Unique id for this change, e.g. a new UUID per call. |
{
"name": "elementarypos_add_stock_change",
"title": "Add a stock change",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sku",
"quantity",
"request_id"
],
"properties": {
"sku": {
"type": "string",
"minLength": 1,
"description": "Item SKU, as in get_stock."
},
"note": {
"type": "string",
"description": "Free-text note for the stock movement."
},
"unit": {
"type": "string",
"description": "Unit of the quantity, e.g. pcs."
},
"price": {
"type": "number",
"description": "Unit purchase price."
},
"currency": {
"type": "string",
"description": "Currency code of the price, e.g. CZK."
},
"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."
}
}
},
"annotations": {
"title": "Add a stock change",
"readOnlyHint": false,
"destructiveHint": true
}
}Read whether the account's POS webhook is active, its URL and any error. Elementary POS API: POST /v1/webhook/get-webhook-status.
No parameters.
{
"name": "elementarypos_get_webhook_status",
"title": "Get webhook status",
"description": "Read whether the account's POS webhook is active, its URL and any error. Elementary POS API: POST /v1/webhook/get-webhook-status.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get webhook status",
"readOnlyHint": true
}
}Tools for Elementary POS, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "What were our total sales yesterday, by cash register?"; "Which items are low on stock right now?"; "Show the cash journal entries for today and who added or removed the cash.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Elementary POS data. Free plan: 50 tool calls per month. Run elementarypos_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run elementarypos_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run elementarypos_upgrade without a plan: it returns both plans, each with a payment link for the user to open. elementarypos_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.