Decimal POS MCP by usefulapi
Read products, customers, orders, invoices, vendor bills and sale history in Decimal POS.
Should I use this
Quality & Safety
Findings (9)
- LOWin decimalpos_find_customer_by_phone
- LOWin decimalpos_get_order_by_external_id
- LOWin decimalpos_get_invoice_for_order
- LOWin decimalpos_get_invoice_by_external_order_id
- LOWin decimalpos_get_invoice_by_external_invoice_id
- LOWin decimalpos_list_sale_permissions
- LOWin decimalpos_get_ticket_item_quantity
- LOWin decimalpos_list_vendor_products
- LOWin decimalpos_find_bills_by_invoice_number
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": {
"decimal-pos": {
"url": "https://decimal-pos.usefulapi.io/mcp"
}
}
}Remote endpoints
https://decimal-pos.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (22)
๐ขdecimalpos_list_products(take, cursor, lastMod, lastSold, includeInactive)
List products (item catalog: code, description, price, stock) sorted by product id. Costs 1 credit per request. Use lastMod for incremental sync. Requires the product:get scope.
Input Schema
{
"type": "object",
"properties": {
"take": {
"description": "Records per page, 1-100 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "Cursor from the previous page. Send all other parameters again.",
"type": "string"
},
"lastMod": {
"description": "ISO 8601: only products changed since this time.",
"type": "string"
},
"lastSold": {
"description": "ISO 8601: only products sold since this time.",
"type": "string"
},
"includeInactive": {
"description": "Include inactive products (default false).",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_get_product(id)
Get one product by its numeric id. Costs 1 credit. Unit price = price รท priceQty. Requires product:get.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Numeric product id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_get_product_by_code(code)
Get one product by its SKU or item code (UPC). Costs 1 credit. Requires product:get.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Product SKU or item code, e.g. 012345678905."
}
},
"required": [
"code"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_list_customers(take, cursor, lastMod)
List all customers, sorted by last change. Needs customer:get with all access (a sensitive scope; an own-access key gets 403). Costs 1 credit per request. Personal data: request only what the task needs.
Input Schema
{
"type": "object",
"properties": {
"take": {
"description": "Records per page, 1-100 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "Cursor from the previous page. Send all other parameters again.",
"type": "string"
},
"lastMod": {
"description": "ISO 8601: only customers changed since this time.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_get_customer(id)
Get one customer by id (name, contact, address). Costs 1 credit. Requires customer:get.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Customer id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_find_customer_by_phone(phoneNumber)
Find one customer by phone number (10 digits). Costs 1 credit. Requires customer:get.
Input Schema
{
"type": "object",
"properties": {
"phoneNumber": {
"type": "string",
"pattern": "^\\d{10}$",
"description": "Customer phone number, 10 digits."
}
},
"required": [
"phoneNumber"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_get_order(id)
Get one order by its internal id, with items and payment. Free. Only orders created with this key.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Internal order id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_get_order_by_external_id(externalOrderId)
Get one order by the external order id your system set. Free. Only orders created with this key.
Input Schema
{
"type": "object",
"properties": {
"externalOrderId": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "External order id."
}
},
"required": [
"externalOrderId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_get_invoice(id)
Get one invoice by its id, with lines, taxes and payments. Free. Only invoices of orders created with this key.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Invoice id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_get_invoice_for_order(orderId)
Get the invoice of one order by the order's internal id. Free.
Input Schema
{
"type": "object",
"properties": {
"orderId": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Internal order id."
}
},
"required": [
"orderId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_get_invoice_by_external_order_id(externalOrderId)
Get the invoice of one order by the external order id your system set. Free.
Input Schema
{
"type": "object",
"properties": {
"externalOrderId": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "External order id."
}
},
"required": [
"externalOrderId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_get_invoice_by_external_invoice_id(externalInvoiceId)
Get one invoice by the external invoice id your system set. Free.
Input Schema
{
"type": "object",
"properties": {
"externalInvoiceId": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "External invoice id."
}
},
"required": [
"externalInvoiceId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_list_sale_permissions(take, cursor)
List the item codes this key may query for sale history (GET /permissionlist). Free. Needs the store owner's sale-record grant; an empty list returns 403.
Input Schema
{
"type": "object",
"properties": {
"take": {
"description": "Records per page, 1-100 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "Cursor from the previous page. Send all other parameters again.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_list_sale_records(itemCode, startDate, endDate, take, cursor)
List invoice lines that sold one item in a date window (max 31 days). Costs 0.1 credit per row. The itemCode must be on the permission list. Sale lines carry no ticket total.
Input Schema
{
"type": "object",
"properties": {
"itemCode": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Item code from the permission list, or an alias of it."
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Inclusive start, YYYY-MM-DD. Not in the future."
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Inclusive end, YYYY-MM-DD. At most 31 days after startDate. Not in the future."
},
"take": {
"description": "Records per page, 1-100 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "Cursor from the previous page. Send all other parameters again.",
"type": "string"
}
},
"required": [
"itemCode",
"startDate",
"endDate"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_get_ticket_item_quantity(ticket, itemCode)
Get how many units of one item were sold on one ticket (net of returns). Costs 1 credit. A missing ticket or line returns quantity 0.
Input Schema
{
"type": "object",
"properties": {
"ticket": {
"type": "string",
"pattern": "^\\d+$",
"description": "Ticket (invoice) number from the receipt."
},
"itemCode": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Item code from the permission list, or an alias of it."
}
},
"required": [
"ticket",
"itemCode"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_list_vendors(take, cursor)
List suppliers, ordered by vendor code. Costs 1 credit per request. Needs the vendor:get scope with all access.
Input Schema
{
"type": "object",
"properties": {
"take": {
"description": "Records per page, 1-100 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "Cursor from the previous page. Send all other parameters again.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_get_vendor(vendorCode)
Get one vendor by its vendor code, with address, contact and payment terms. Costs 1 credit.
Input Schema
{
"type": "object",
"properties": {
"vendorCode": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Vendor code."
}
},
"required": [
"vendorCode"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_list_vendor_products(vendorCode, take, cursor)
List one vendor's catalog: item numbers, pack sizes and prices (pricedPer Case or Each). Costs 1 credit per request. Paginated: send cursor back unchanged.
Input Schema
{
"type": "object",
"properties": {
"vendorCode": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Vendor code."
},
"take": {
"description": "Records per page, 1-100 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "Cursor from the previous page. Send all other parameters again.",
"type": "string"
}
},
"required": [
"vendorCode"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_list_bills(vendor, invoiceDateFrom, invoiceDateTo, take, cursor)
List vendor bills (purchase invoices) with items; credit memos included. Free. Only bills created with this key. Send the same filters with every cursor.
Input Schema
{
"type": "object",
"properties": {
"vendor": {
"description": "Vendor code filter.",
"type": "string"
},
"invoiceDateFrom": {
"description": "Invoice date from, inclusive.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"invoiceDateTo": {
"description": "Invoice date to, inclusive.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"take": {
"description": "Records per page, 1-100 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "Cursor from the previous page. Send all other parameters again.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_get_bill(id)
Get one vendor bill by id, with items, amounts paid and balance. Free. Only bills created with this key.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Bill id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_find_bills_by_invoice_number(vendor, invoiceNumber)
Find every bill with one vendor's invoice number. Free. Returns all matches; 404 when none.
Input Schema
{
"type": "object",
"properties": {
"vendor": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Vendor code."
},
"invoiceNumber": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The vendor's invoice number."
}
},
"required": [
"vendor",
"invoiceNumber"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}๐ขdecimalpos_list_payment_terms
List every payment terms code the store defined (for example NET30), in one page. Costs 1 credit.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence