# Tillhub MCP by usefulapi

> Tillhub MCP by usefulapi is an MCP server. Read Tillhub products, stock, transactions, customers and retail reports from your AI assistant. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/tillhub/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/tillhub
- **MCP Registry name:** io.usefulapi/tillhub
- **Listing updated:** 2026-11-13

## About

Read Tillhub products, stock, transactions, customers and retail reports from your AI assistant.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tillhub https://tillhub.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://tillhub.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tillhub": {
      "url": "https://tillhub.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tillhub": {
      "type": "http",
      "url": "https://tillhub.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tillhub": {
      "serverUrl": "https://tillhub.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tillhub": {
      "type": "http",
      "url": "https://tillhub.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `tillhub_get_account`: The Tillhub user behind the API key: role, scopes, account id and name (no credentials). GET /api/v0/me.
- `tillhub_list_products`: List products (articles, variants, vouchers) with name, number, barcode, prices, taxes and product group. Filter by type, group, tag, barcode or custom id (barcode and custom_id are fast exact lookups and ignore the other filters). Page with next_query. GET /api/v1/products/{account}.
- `tillhub_search_products`: Fuzzy search products by name and description (max 20 hits per page, with relevance score). GET /api/v2/products/{account}/search.
- `tillhub_get_product`: One product by id, optionally with the stock and prices of one branch. GET /api/v1/products/{account}/{id}.
- `tillhub_list_product_groups`: List product groups (categories) with id and name. GET /api/v0/product_groups/{account}.
- `tillhub_list_tags`: List product tags. GET /api/v1/tags/{account}.
- `tillhub_list_transactions`: List sales and other register transactions (type, date, branch, register, staff, customer, amounts, payments, cart items). Always pass a date range for busy shops. Page with next_query. GET /api/v1/transactions/{account}.
- `tillhub_get_transaction`: One transaction by id with its full cart, payments and taxes. GET /api/v1/transactions/{account}/{id}.
- `tillhub_transactions_report`: Detailed transactions report for a period, filterable by branch, register, staff, customer, type and currency. GET /api/v3/analytics/{account}/reports/transactions/overview.
- `tillhub_list_receipts`: List receipts (printed or digital) of the account. Page with next_query. GET /api/v1/receipts/{account}.
- `tillhub_revenue_sum`: Total revenue between two points in time, optionally for one branch number. GET /api/v0/analytics/{account}/aggregates/revenues/sum.
- `tillhub_sales_aggregate`: Sales and revenue aggregated per hour or per day between two points in time. GET /api/v0/analytics/{account}/aggregates/sales.
- `tillhub_top_products`: Best-selling products in a period, optionally for one branch number. GET /api/v0/analytics/{account}/reports/products/top.
- `tillhub_list_balances`: List cash-register closings (balances / Z-reports) with totals per register and day. Filter by branch, register or staff. Page with next_query. GET /api/v0/analytics/{account}/reports/balances.
- `tillhub_list_customers`: List customers with name, company, email, phone numbers and addresses. Filter by text, name, email, company or customer number. Page with next_query. GET /api/v1/customers/{account}.
- `tillhub_search_customers`: Fuzzy search customers by name, email and description (max 100 hits, with relevance score). GET /api/v2/customers/{account}/search.
- `tillhub_get_customer`: One customer by id. GET /api/v1/customers/{account}/{id}.
- `tillhub_list_branches`: List branches (shops) with number, name and address. Use the ids to filter transactions, stock and prices. Page with next_query. GET /api/v1/branches/{account}.
- `tillhub_list_registers`: List cash registers with number, name and branch. GET /api/v1/registers/{account}.
- `tillhub_list_staff`: List staff members (cashiers) with name, number and branch. PINs and passwords are never returned. GET /api/v1/staff/{account}.
- `tillhub_list_payment_options`: List payment options (cash, card, voucher, ...) configured for the account. GET /api/v0/payment_options/{account}.
- `tillhub_list_taxes`: List tax (VAT) references with rates. GET /api/v0/taxes/{account}.
- `tillhub_list_discounts`: List configured discounts. GET /api/v0/discounts/{account}.
- `tillhub_list_stock`: Current stock per product and location. Filter by location (branch/warehouse id) or product id. GET /api/v0/stock/{account}.
- `tillhub_list_stock_locations`: List stock locations (branches and warehouses) with their ids. GET /api/v0/stock/{account}/locations.
- `tillhub_list_stock_book`: Stock book: every stock movement (sale, delivery, correction, transfer) with product, location, quantity and date. Filter by product, location, period or text. Page with next_query. GET /api/v1/stock/{account}/book.
- `tillhub_list_orders`: List incoming or outgoing orders (goods orders between locations/suppliers). Page with next_query. GET /api/v0/orders/{account}.

## FAQ

### How do I add Tillhub MCP by usefulapi to Claude Code?

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

---
Source: https://ai-powered.com/mcp/tillhub-mcp-by-usefulapi
