Decimal POS MCP by usefulapi

Read products, customers, orders, invoices, vendor bills and sale history in Decimal POS.

Should I use this

Quality & Safety

A
Description quality
95%
Schema completeness
95%
Naming quality
72%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (9)

  • LOWTool 'decimalpos_find_customer_by_phone' name length outside 3-30 rangein decimalpos_find_customer_by_phone
  • LOWTool 'decimalpos_get_order_by_external_id' name length outside 3-30 rangein decimalpos_get_order_by_external_id
  • LOWTool 'decimalpos_get_invoice_for_order' name length outside 3-30 rangein decimalpos_get_invoice_for_order
  • LOWTool 'decimalpos_get_invoice_by_external_order_id' name length outside 3-30 rangein decimalpos_get_invoice_by_external_order_id
  • LOWTool 'decimalpos_get_invoice_by_external_invoice_id' name length outside 3-30 rangein decimalpos_get_invoice_by_external_invoice_id
  • LOWTool 'decimalpos_list_sale_permissions' name length outside 3-30 rangein decimalpos_list_sale_permissions
  • LOWTool 'decimalpos_get_ticket_item_quantity' name length outside 3-30 rangein decimalpos_get_ticket_item_quantity
  • LOWTool 'decimalpos_list_vendor_products' name length outside 3-30 rangein decimalpos_list_vendor_products
  • LOWTool 'decimalpos_find_bills_by_invoice_number' name length outside 3-30 rangein decimalpos_find_bills_by_invoice_number

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,968Tokens (tool definitions)
~899 BTypical response size
Significant attention impact (2.32% of 128k context)

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-http

What it can do

Tool inventory

Tools (22)

๐ŸŸข Read-only๐ŸŸก Write๐Ÿ”ด Deleteโšช Unknown
๐ŸŸข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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded22 tools