Skip to content
MCP server

Dotypos MCP by usefulapi

Read orders, sales reports, stock and reservations; add customers, update products in…

Install
Runs
Remotely
Version
1.4.0
Listing updated
4 days ago

About Dotypos MCP by usefulapi

Dotypos MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read orders, sales reports, stock and reservations; add customers, update products in Dotypos.

Install

Run in a terminal

claude mcp add --transport http dotypos https://dotypos.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://dotypos.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "dotypos": {
      "url": "https://dotypos.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "dotypos": {
      "type": "http",
      "url": "https://dotypos.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "dotypos": {
      "serverUrl": "https://dotypos.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "dotypos": {
      "type": "http",
      "url": "https://dotypos.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (23)

Read directly from the server.

dotypos_list_branches
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.
dotypos_get_branch
One branch by id. GET /clouds/{cloud}/branches/{id}.
dotypos_list_categories
List product categories (name, VAT, colour, sort order). GET /clouds/{cloud}/categories.
dotypos_get_category
One product category by id. GET /clouds/{cloud}/categories/{id}.
dotypos_list_products
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.
dotypos_get_product
One product by id with all its fields (prices, VAT, codes, allergens, packaging, notes). GET /clouds/{cloud}/products/{id}.
dotypos_list_customers
List or search customers (name, company, email, phone, address, points, tags). All given filters must match. Contains personal data. GET /clouds/{cloud}/customers.
dotypos_get_customer
One customer by id. Contains personal data. GET /clouds/{cloud}/customers/{id}.
dotypos_list_orders
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.
dotypos_get_order
One order / receipt by id: status, totals, document number, customer, employee, table, notes, tags. GET /clouds/{cloud}/orders/{id}.
dotypos_list_order_items
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.
dotypos_get_sales_report
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 tim
dotypos_list_employees
List employees (name, e-mail, phone, enabled flag, access levels). Login barcodes and PINs are never returned. GET /clouds/{cloud}/employees.
dotypos_list_tables
List restaurant tables: name, location, seats, branch, enabled flag. GET /clouds/{cloud}/tables.
dotypos_list_reservations
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.
dotypos_list_warehouses
List warehouses (stock locations). Use the ids with dotypos_list_stock. GET /clouds/{cloud}/warehouses.
dotypos_list_stock
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.
dotypos_list_suppliers
List suppliers (name, company ids, contact and address). GET /clouds/{cloud}/suppliers.
dotypos_list_delivery_notes
List imported supplier delivery notes: document number, supplier, branch, dates, status, download URL. GET /clouds/{cloud}/delivery-notes.
dotypos_list_tags
List tags used on products, customers and orders. GET /clouds/{cloud}/tags.
dotypos_create_customer
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.
dotypos_update_customer
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}.
dotypos_update_product
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}.

Dotypos MCP by usefulapi FAQ

How do I add Dotypos MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http dotypos https://dotypos.usefulapi.io/mcp