Dotypos MCP by usefulapi is an MCP server published by io.usefulapi, hosted at dotypos.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 23 tools, including dotypos_list_branches, dotypos_get_branch, dotypos_list_categories, dotypos_get_category, dotypos_list_products.
Read orders, sales reports, stock and reservations; add customers, update products in Dotypos.
4,315 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 the branches (shops / points of sale) of the connected Dotypos cloud. Use the ids to filter orders, reservations and reports. GET /clouds/{cloud}/branches.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| limit | integer | Results per page, 1-100 (default 25). |
| deleted | string | Deleted records: exclude (default), only, or include (both). |
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.
{
"name": "dotypos_list_branches",
"title": "List branches",
"description": "List the branches (shops / points of sale) of the connected Dotypos cloud. Use the ids to filter orders, reservations and reports. GET /clouds/{cloud}/branches.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"deleted": {
"enum": [
"exclude",
"only",
"include"
],
"type": "string",
"description": "Deleted records: exclude (default), only, or include (both)."
}
}
},
"annotations": {
"title": "List branches",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One branch by id. GET /clouds/{cloud}/branches/{id}.
| Parameter | Type | Description |
|---|---|---|
| branch_id * | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
{
"name": "dotypos_get_branch",
"title": "Get branch",
"description": "One branch by id. GET /clouds/{cloud}/branches/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"branch_id"
],
"properties": {
"branch_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
}
}
},
"annotations": {
"title": "Get branch",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List product categories (name, VAT, colour, sort order). GET /clouds/{cloud}/categories.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only categories whose name contains this text. |
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| sort | string | Sort: attribute names, comma separated, a leading - for descending (e.g. -created,name). Only some attributes sort. |
| limit | integer | Results per page, 1-100 (default 25). |
| deleted | string | Deleted records: exclude (default), only, or include (both). |
{
"name": "dotypos_list_categories",
"title": "List categories",
"description": "List product categories (name, VAT, colour, sort order). GET /clouds/{cloud}/categories.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only categories whose name contains this text."
},
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"sort": {
"type": "string",
"pattern": "^-?[A-Za-z_][A-Za-z0-9_]*(,-?[A-Za-z_][A-Za-z0-9_]*)*$",
"maxLength": 200,
"description": "Sort: attribute names, comma separated, a leading - for descending (e.g. -created,name). Only some attributes sort."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"deleted": {
"enum": [
"exclude",
"only",
"include"
],
"type": "string",
"description": "Deleted records: exclude (default), only, or include (both)."
}
}
},
"annotations": {
"title": "List categories",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One product category by id. GET /clouds/{cloud}/categories/{id}.
| Parameter | Type | Description |
|---|---|---|
| category_id * | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
{
"name": "dotypos_get_category",
"title": "Get category",
"description": "One product category by id. GET /clouds/{cloud}/categories/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"category_id"
],
"properties": {
"category_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
}
}
},
"annotations": {
"title": "Get category",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List or search the product catalog: name, prices with and without VAT, VAT, category, EAN/PLU codes, unit, tags, stock-deduction setting. Filter by name text, category, EAN or PLU code, tag or visibility. GET /clouds/{cloud}/products.
| Parameter | Type | Description |
|---|---|---|
| ean | string | Only products with this exact EAN code. |
| plu | string | Only products with this exact PLU code. |
| tag | string | Only products carrying this tag. |
| name | string | Only products whose name contains this text (case insensitive). |
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| sort | string | Sort: attribute names, comma separated, a leading - for descending (e.g. -created,name). Only some attributes sort. |
| limit | integer | Results per page, 1-100 (default 25). |
| deleted | string | Deleted records: exclude (default), only, or include (both). |
| displayed | boolean | true = only products shown at the POS, false = only hidden ones. |
| category_id | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
{
"name": "dotypos_list_products",
"title": "List products",
"description": "List or search the product catalog: name, prices with and without VAT, VAT, category, EAN/PLU codes, unit, tags, stock-deduction setting. Filter by name text, category, EAN or PLU code, tag or visibility. GET /clouds/{cloud}/products.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ean": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only products with this exact EAN code."
},
"plu": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only products with this exact PLU code."
},
"tag": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only products carrying this tag."
},
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only products whose name contains this text (case insensitive)."
},
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"sort": {
"type": "string",
"pattern": "^-?[A-Za-z_][A-Za-z0-9_]*(,-?[A-Za-z_][A-Za-z0-9_]*)*$",
"maxLength": 200,
"description": "Sort: attribute names, comma separated, a leading - for descending (e.g. -created,name). Only some attributes sort."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"deleted": {
"enum": [
"exclude",
"only",
"include"
],
"type": "string",
"description": "Deleted records: exclude (default), only, or include (both)."
},
"displayed": {
"type": "boolean",
"description": "true = only products shown at the POS, false = only hidden ones."
},
"category_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
}
}
},
"annotations": {
"title": "List products",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One product by id with all its fields (prices, VAT, codes, allergens, packaging, notes). GET /clouds/{cloud}/products/{id}.
| Parameter | Type | Description |
|---|---|---|
| product_id * | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
{
"name": "dotypos_get_product",
"title": "Get product",
"description": "One product by id with all its fields (prices, VAT, codes, allergens, packaging, notes). GET /clouds/{cloud}/products/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product_id"
],
"properties": {
"product_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
}
}
},
"annotations": {
"title": "Get product",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List or search customers (name, company, email, phone, address, points, tags). All given filters must match. Contains personal data. GET /clouds/{cloud}/customers.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| sort | string | Sort: attribute names, comma separated, a leading - for descending (e.g. -created,name). Only some attributes sort. |
| string | E-mail contains this text. | |
| limit | integer | Results per page, 1-100 (default 25). |
| phone | string | Phone contains this text. |
| deleted | string | Deleted records: exclude (default), only, or include (both). |
| last_name | string | Last name contains this text. |
| first_name | string | First name contains this text. |
| company_name | string | Company name contains this text. |
{
"name": "dotypos_list_customers",
"title": "List customers",
"description": "List or search customers (name, company, email, phone, address, points, tags). All given filters must match. Contains personal data. GET /clouds/{cloud}/customers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"sort": {
"type": "string",
"pattern": "^-?[A-Za-z_][A-Za-z0-9_]*(,-?[A-Za-z_][A-Za-z0-9_]*)*$",
"maxLength": 200,
"description": "Sort: attribute names, comma separated, a leading - for descending (e.g. -created,name). Only some attributes sort."
},
"email": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "E-mail contains this text."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"phone": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Phone contains this text."
},
"deleted": {
"enum": [
"exclude",
"only",
"include"
],
"type": "string",
"description": "Deleted records: exclude (default), only, or include (both)."
},
"last_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Last name contains this text."
},
"first_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "First name contains this text."
},
"company_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Company name contains this text."
}
}
},
"annotations": {
"title": "List customers",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One customer by id. Contains personal data. GET /clouds/{cloud}/customers/{id}.
| Parameter | Type | Description |
|---|---|---|
| customer_id * | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
{
"name": "dotypos_get_customer",
"title": "Get customer",
"description": "One customer by id. Contains personal data. GET /clouds/{cloud}/customers/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id"
],
"properties": {
"customer_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
}
}
},
"annotations": {
"title": "Get customer",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List orders and receipts (documents): number, type, status, totals, customer, employee, table, branch, paid flag, created/completed dates. Filter by time, status, type, branch, customer, employee or paid state; newest first by default. Line items are in dotypos_list_order_items. GET /clouds/{cloud}/orders.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| paid | boolean | true = only paid orders, false = only unpaid. |
| sort | string | Sort, e.g. -created (default) or created. Orders are not counted: follow next_page until it is null. |
| limit | integer | Results per page, 1-100 (default 25). |
| status | string | Order status. |
| branch_id | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
| created_to | string | Only orders created before this moment (ISO 8601, exclusive). |
| customer_id | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
| employee_id | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
| created_from | string | Only orders created at or after this moment (ISO 8601). |
| document_type | string | Document type, e.g. RECEIPT or INVOICE. |
| document_number | string | Document number contains this text. |
{
"name": "dotypos_list_orders",
"title": "List orders",
"description": "List orders and receipts (documents): number, type, status, totals, customer, employee, table, branch, paid flag, created/completed dates. Filter by time, status, type, branch, customer, employee or paid state; newest first by default. Line items are in dotypos_list_order_items. GET /clouds/{cloud}/orders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"paid": {
"type": "boolean",
"description": "true = only paid orders, false = only unpaid."
},
"sort": {
"type": "string",
"pattern": "^-?[A-Za-z_][A-Za-z0-9_]*(,-?[A-Za-z_][A-Za-z0-9_]*)*$",
"maxLength": 200,
"description": "Sort, e.g. -created (default) or created. Orders are not counted: follow next_page until it is null."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"status": {
"enum": [
"new",
"parked",
"ready_to_pickup",
"ready_for_delivery",
"on_delivery",
"delivery_failed",
"canceled",
"closed"
],
"type": "string",
"description": "Order status."
},
"branch_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
},
"created_to": {
"type": "string",
"description": "Only orders created before this moment (ISO 8601, exclusive)."
},
"customer_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
},
"employee_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
},
"created_from": {
"type": "string",
"description": "Only orders created at or after this moment (ISO 8601)."
},
"document_type": {
"enum": [
"RECEIPT",
"INVOICE",
"INVOICE_FROM_RECEIPTS",
"CORRECTIVE_INVOICE",
"EXTERNAL_INVOICE_PAYMENT",
"CASH_IN",
"CASH_OUT"
],
"type": "string",
"description": "Document type, e.g. RECEIPT or INVOICE."
},
"document_number": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Document number contains this text."
}
}
},
"annotations": {
"title": "List orders",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One order / receipt by id: status, totals, document number, customer, employee, table, notes, tags. GET /clouds/{cloud}/orders/{id}.
| Parameter | Type | Description |
|---|---|---|
| order_id * | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
{
"name": "dotypos_get_order",
"title": "Get order",
"description": "One order / receipt by id: status, totals, document number, customer, employee, table, notes, tags. GET /clouds/{cloud}/orders/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
}
}
},
"annotations": {
"title": "Get order",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List sold line items: product, name, quantity, unit prices before and after discount, VAT, category, employee, order. Give order_id for one order's lines, or a time range for sales analysis. GET /clouds/{cloud}/order-items.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| sort | string | Sort: attribute names, comma separated, a leading - for descending (e.g. -created,name). Only some attributes sort. |
| limit | integer | Results per page, 1-100 (default 25). |
| order_id | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
| branch_id | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
| created_to | string | Only items created before this moment (ISO 8601, exclusive). |
| product_id | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
| category_id | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
| employee_id | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
| created_from | string | Only items created at or after this moment (ISO 8601). |
{
"name": "dotypos_list_order_items",
"title": "List order items",
"description": "List sold line items: product, name, quantity, unit prices before and after discount, VAT, category, employee, order. Give order_id for one order's lines, or a time range for sales analysis. GET /clouds/{cloud}/order-items.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"sort": {
"type": "string",
"pattern": "^-?[A-Za-z_][A-Za-z0-9_]*(,-?[A-Za-z_][A-Za-z0-9_]*)*$",
"maxLength": 200,
"description": "Sort: attribute names, comma separated, a leading - for descending (e.g. -created,name). Only some attributes sort."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"order_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
},
"branch_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
},
"created_to": {
"type": "string",
"description": "Only items created before this moment (ISO 8601, exclusive)."
},
"product_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
},
"category_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
},
"employee_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
},
"created_from": {
"type": "string",
"description": "Only items created at or after this moment (ISO 8601)."
}
}
},
"annotations": {
"title": "List order items",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The base sales report of one branch for a time range of at most 26 hours (one business day; Dotypos limits a report to 26 hours, so ask for one day at a time): sales and cancel counts and values, revenue with VAT and payment-type breakdown, discounts, cash in/out, sales by category, product, tag, employee and customer, tips and write-offs. For longer periods use dotypos_list_order_items with a time range. GET /clouds/{cloud}/branches/{id}/sales-report.
| Parameter | Type | Description |
|---|---|---|
| lang | string | 2-letter lowercase language code for names in the report (e.g. en, cs). |
| date_to * | string | End of the interval (ISO 8601 with a timezone); at most 26 hours after date_from. |
| branch_id * | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
| date_from * | string | Start of the interval (ISO 8601 with a timezone, e.g. 2026-10-01T00:00:00+02:00). |
| seller_id | any | Count only this seller: the _sellerId field of an employee in dotypos_list_employees (not the employee id). Default: all sellers. |
| vat_payer | boolean | Report as a VAT payer (default true). |
{
"name": "dotypos_get_sales_report",
"title": "Get sales report",
"description": "The base sales report of one branch for a time range of at most 26 hours (one business day; Dotypos limits a report to 26 hours, so ask for one day at a time): sales and cancel counts and values, revenue with VAT and payment-type breakdown, discounts, cash in/out, sales by category, product, tag, employee and customer, tips and write-offs. For longer periods use dotypos_list_order_items with a time range. GET /clouds/{cloud}/branches/{id}/sales-report.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"branch_id",
"date_from",
"date_to"
],
"properties": {
"lang": {
"type": "string",
"pattern": "^[a-z]{2}$",
"description": "2-letter lowercase language code for names in the report (e.g. en, cs)."
},
"date_to": {
"type": "string",
"description": "End of the interval (ISO 8601 with a timezone); at most 26 hours after date_from."
},
"branch_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
},
"date_from": {
"type": "string",
"description": "Start of the interval (ISO 8601 with a timezone, e.g. 2026-10-01T00:00:00+02:00)."
},
"seller_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Count only this seller: the _sellerId field of an employee in dotypos_list_employees (not the employee id). Default: all sellers."
},
"vat_payer": {
"type": "boolean",
"description": "Report as a VAT payer (default true)."
}
}
},
"annotations": {
"title": "Get sales report",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List employees (name, e-mail, phone, enabled flag, access levels). Login barcodes and PINs are never returned. GET /clouds/{cloud}/employees.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only employees whose name contains this text. |
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| limit | integer | Results per page, 1-100 (default 25). |
| deleted | string | Deleted records: exclude (default), only, or include (both). |
{
"name": "dotypos_list_employees",
"title": "List employees",
"description": "List employees (name, e-mail, phone, enabled flag, access levels). Login barcodes and PINs are never returned. GET /clouds/{cloud}/employees.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only employees whose name contains this text."
},
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"deleted": {
"enum": [
"exclude",
"only",
"include"
],
"type": "string",
"description": "Deleted records: exclude (default), only, or include (both)."
}
}
},
"annotations": {
"title": "List employees",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List restaurant tables: name, location, seats, branch, enabled flag. GET /clouds/{cloud}/tables.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| limit | integer | Results per page, 1-100 (default 25). |
| branch_id | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
{
"name": "dotypos_list_tables",
"title": "List tables",
"description": "List restaurant tables: name, location, seats, branch, enabled flag. GET /clouds/{cloud}/tables.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"branch_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
}
}
},
"annotations": {
"title": "List tables",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List table reservations: customer, table, branch, start and end time, seats, status, note. Filter by start time window, branch or customer; each reservation carries its status (NEW, CONFIRMED, CANCELLED). GET /clouds/{cloud}/reservations.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| sort | string | Sort: attribute names, comma separated, a leading - for descending (e.g. -created,name). Only some attributes sort. |
| limit | integer | Results per page, 1-100 (default 25). |
| start_to | string | Only reservations starting before this moment (ISO 8601, exclusive). |
| branch_id | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
| start_from | string | Only reservations starting at or after this moment (ISO 8601). |
| customer_id | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
{
"name": "dotypos_list_reservations",
"title": "List reservations",
"description": "List table reservations: customer, table, branch, start and end time, seats, status, note. Filter by start time window, branch or customer; each reservation carries its status (NEW, CONFIRMED, CANCELLED). GET /clouds/{cloud}/reservations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"sort": {
"type": "string",
"pattern": "^-?[A-Za-z_][A-Za-z0-9_]*(,-?[A-Za-z_][A-Za-z0-9_]*)*$",
"maxLength": 200,
"description": "Sort: attribute names, comma separated, a leading - for descending (e.g. -created,name). Only some attributes sort."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"start_to": {
"type": "string",
"description": "Only reservations starting before this moment (ISO 8601, exclusive)."
},
"branch_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
},
"start_from": {
"type": "string",
"description": "Only reservations starting at or after this moment (ISO 8601)."
},
"customer_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
}
}
},
"annotations": {
"title": "List reservations",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List warehouses (stock locations). Use the ids with dotypos_list_stock. GET /clouds/{cloud}/warehouses.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| limit | integer | Results per page, 1-100 (default 25). |
| deleted | string | Deleted records: exclude (default), only, or include (both). |
{
"name": "dotypos_list_warehouses",
"title": "List warehouses",
"description": "List warehouses (stock locations). Use the ids with dotypos_list_stock. GET /clouds/{cloud}/warehouses.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"deleted": {
"enum": [
"exclude",
"only",
"include"
],
"type": "string",
"description": "Deleted records: exclude (default), only, or include (both)."
}
}
},
"annotations": {
"title": "List warehouses",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Stock status of the products in one warehouse: each product with its quantity on hand (stockQuantityStatus), last stock change and purchase price. Filter by name or by maximum quantity to find low stock. GET /clouds/{cloud}/warehouses/{id}/products.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only products whose name contains this text. |
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| sort | string | Sort: attribute names, comma separated, a leading - for descending (e.g. -created,name). Only some attributes sort. |
| limit | integer | Results per page, 1-100 (default 25). |
| max_quantity | number | Only products with a stock quantity at or below this number (low-stock check). |
| warehouse_id * | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
{
"name": "dotypos_list_stock",
"title": "List stock levels",
"description": "Stock status of the products in one warehouse: each product with its quantity on hand (stockQuantityStatus), last stock change and purchase price. Filter by name or by maximum quantity to find low stock. GET /clouds/{cloud}/warehouses/{id}/products.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"warehouse_id"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only products whose name contains this text."
},
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"sort": {
"type": "string",
"pattern": "^-?[A-Za-z_][A-Za-z0-9_]*(,-?[A-Za-z_][A-Za-z0-9_]*)*$",
"maxLength": 200,
"description": "Sort: attribute names, comma separated, a leading - for descending (e.g. -created,name). Only some attributes sort."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"max_quantity": {
"type": "number",
"description": "Only products with a stock quantity at or below this number (low-stock check)."
},
"warehouse_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
}
}
},
"annotations": {
"title": "List stock levels",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List suppliers (name, company ids, contact and address). GET /clouds/{cloud}/suppliers.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| limit | integer | Results per page, 1-100 (default 25). |
| deleted | string | Deleted records: exclude (default), only, or include (both). |
{
"name": "dotypos_list_suppliers",
"title": "List suppliers",
"description": "List suppliers (name, company ids, contact and address). GET /clouds/{cloud}/suppliers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"deleted": {
"enum": [
"exclude",
"only",
"include"
],
"type": "string",
"description": "Deleted records: exclude (default), only, or include (both)."
}
}
},
"annotations": {
"title": "List suppliers",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List imported supplier delivery notes: document number, supplier, branch, dates, status, download URL. GET /clouds/{cloud}/delivery-notes.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| sort | string | Sort: attribute names, comma separated, a leading - for descending (e.g. -created,name). Only some attributes sort. |
| limit | integer | Results per page, 1-100 (default 25). |
| branch_id | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
{
"name": "dotypos_list_delivery_notes",
"title": "List delivery notes",
"description": "List imported supplier delivery notes: document number, supplier, branch, dates, status, download URL. GET /clouds/{cloud}/delivery-notes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"sort": {
"type": "string",
"pattern": "^-?[A-Za-z_][A-Za-z0-9_]*(,-?[A-Za-z_][A-Za-z0-9_]*)*$",
"maxLength": 200,
"description": "Sort: attribute names, comma separated, a leading - for descending (e.g. -created,name). Only some attributes sort."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"branch_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
}
}
},
"annotations": {
"title": "List delivery notes",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List tags used on products, customers and orders. GET /clouds/{cloud}/tags.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only tags whose name contains this text. |
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| limit | integer | Results per page, 1-100 (default 25). |
{
"name": "dotypos_list_tags",
"title": "List tags",
"description": "List tags used on products, customers and orders. GET /clouds/{cloud}/tags.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only tags whose name contains this text."
},
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List tags",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: create a customer record. At least one of first_name, last_name or company_name is required. Creates a new record every time (not idempotent). POST /clouds/{cloud}/customers.
| Parameter | Type | Description |
|---|---|---|
| zip | string | |
| city | string | |
| note | string | |
| tags | array | |
| string | ||
| phone | string | |
| vat_id | string | VAT id (CZ/SK: DIČ). |
| country | string | Country code. |
| last_name | string | |
| company_id | string | Company registration number (CZ/SK: IČO). |
| first_name | string | |
| company_name | string | |
| address_line1 | string |
{
"name": "dotypos_create_customer",
"title": "Create customer",
"description": "WRITE: create a customer record. At least one of first_name, last_name or company_name is required. Creates a new record every time (not idempotent). POST /clouds/{cloud}/customers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"zip": {
"type": "string",
"maxLength": 20
},
"city": {
"type": "string",
"maxLength": 255
},
"note": {
"type": "string",
"maxLength": 500
},
"tags": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[^,^?*()[\\]$]+$",
"maxLength": 255,
"minLength": 1
},
"maxItems": 20
},
"email": {
"type": "string",
"maxLength": 100
},
"phone": {
"type": "string",
"maxLength": 20
},
"vat_id": {
"type": "string",
"maxLength": 255,
"description": "VAT id (CZ/SK: DIČ)."
},
"country": {
"type": "string",
"maxLength": 10,
"description": "Country code."
},
"last_name": {
"type": "string",
"maxLength": 180
},
"company_id": {
"type": "string",
"maxLength": 255,
"description": "Company registration number (CZ/SK: IČO)."
},
"first_name": {
"type": "string",
"maxLength": 180
},
"company_name": {
"type": "string",
"maxLength": 180
},
"address_line1": {
"type": "string",
"maxLength": 180
}
}
},
"annotations": {
"title": "Create customer",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE: change fields of one customer; only the fields you pass are changed. The record is read first and updated with its ETag, so a concurrent change makes the update fail instead of overwriting it. PATCH /clouds/{cloud}/customers/{id}.
| Parameter | Type | Description |
|---|---|---|
| zip | string | |
| city | string | |
| note | string | |
| string | ||
| phone | string | |
| last_name | string | |
| first_name | string | |
| customer_id * | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
| company_name | string | |
| address_line1 | string | |
| internal_note | string |
{
"name": "dotypos_update_customer",
"title": "Update customer",
"description": "WRITE: change fields of one customer; only the fields you pass are changed. The record is read first and updated with its ETag, so a concurrent change makes the update fail instead of overwriting it. PATCH /clouds/{cloud}/customers/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id"
],
"properties": {
"zip": {
"type": "string",
"maxLength": 20
},
"city": {
"type": "string",
"maxLength": 255
},
"note": {
"type": "string",
"maxLength": 500
},
"email": {
"type": "string",
"maxLength": 100
},
"phone": {
"type": "string",
"maxLength": 20
},
"last_name": {
"type": "string",
"maxLength": 180
},
"first_name": {
"type": "string",
"maxLength": 180
},
"customer_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
},
"company_name": {
"type": "string",
"maxLength": 180
},
"address_line1": {
"type": "string",
"maxLength": 180
},
"internal_note": {
"type": "string",
"maxLength": 1000
}
}
},
"annotations": {
"title": "Update customer",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: change the name, net price, description or visibility of one product; only the fields you pass are changed. The price with VAT is derived by Dotypos from the net price and the product's VAT. The record is read first and updated with its ETag, so a concurrent change makes the update fail. PATCH /clouds/{cloud}/products/{id}.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| displayed | boolean | Show (true) or hide (false) the product at the POS. |
| product_id * | any | Numeric id (as in the replies; default items of a new cloud have negative ids such as -301). |
| description | string | |
| price_without_vat | number | New net price without VAT, in the cloud's currency. |
{
"name": "dotypos_update_product",
"title": "Update product",
"description": "WRITE: change the name, net price, description or visibility of one product; only the fields you pass are changed. The price with VAT is derived by Dotypos from the net price and the product's VAT. The record is read first and updated with its ETag, so a concurrent change makes the update fail. PATCH /clouds/{cloud}/products/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product_id"
],
"properties": {
"name": {
"type": "string",
"maxLength": 400,
"minLength": 1
},
"displayed": {
"type": "boolean",
"description": "Show (true) or hide (false) the product at the POS."
},
"product_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string",
"pattern": "^-?\\d{1,19}$"
}
],
"description": "Numeric id (as in the replies; default items of a new cloud have negative ids such as -301)."
},
"description": {
"type": "string",
"maxLength": 1000
},
"price_without_vat": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "New net price without VAT, in the cloud's currency."
}
}
},
"annotations": {
"title": "Update product",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for Dotypos, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "What were yesterday's sales per payment type in my main branch?"; "Which products in the main warehouse are down to 5 or fewer units?"; "List all unpaid invoices from this month.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Dotypos data. Free plan: 50 tool calls per month. Run dotypos_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 dotypos_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 dotypos_upgrade without a plan: it returns both plans, each with a payment link for the user to open. dotypos_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.