# Loyverse MCP by usefulapi

> Loyverse MCP by usefulapi is an MCP server. Query Loyverse POS receipts, shifts, items, inventory and customers, and update stock and customers. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Query Loyverse POS receipts, shifts, items, inventory and customers, and update stock and customers.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `loyverse_get_merchant`: Fetch the merchant account this token belongs to — business name, email, country and currency. A cheap way to confirm the token works. Loyverse: GET /merchant/.
- `loyverse_list_stores`: List the merchant's stores (locations) with their addresses. Store ids are what the receipt, shift and inventory filters take. Loyverse: GET /stores.
- `loyverse_list_employees`: List employees, with the stores each can access and whether they are the owner. Loyverse: GET /employees.
- `loyverse_list_receipts`: List sales and refund receipts, newest first, with line items, payments, discounts and taxes. Filter by store, time range or receipt numbers — the core of any sales question. Loyverse: GET /receipts.
- `loyverse_get_receipt`: Fetch a single receipt by its receipt number (e.g. 2-1008), with line items, modifiers, discounts, taxes and payments. Loyverse: GET /receipts/{receipt_number}.
- `loyverse_list_shifts`: List cash-register shifts with their cash, gross/net sales, refunds, discounts, taxes, per-payment-type totals and pay-in/pay-out movements — the end-of-day view. Loyverse: GET /shifts.
- `loyverse_list_items`: List catalog items with their variants (SKU, barcode, price, cost, per-store pricing), category, taxes and modifiers. Loyverse: GET /items.
- `loyverse_get_item`: Fetch a single catalog item by id, with its variants. Loyverse: GET /items/{item_id}.
- `loyverse_list_variants`: List item variants — the sellable SKUs — optionally for given items or one SKU. Variant ids are what inventory levels are keyed on. Loyverse: GET /variants.
- `loyverse_list_categories`: List item categories. Loyverse: GET /categories.
- `loyverse_list_inventory`: List current stock (`in_stock`) per variant per store. Filter by stores and/or variants — the answer to 'what is running low?'. Loyverse: GET /inventory.
- `loyverse_list_customers`: List loyalty customers, newest first, with visits, total spent and points balance. Filter by email or ids. Loyverse: GET /customers.
- `loyverse_get_customer`: Fetch a single customer by id, with visits, total spent and points balance. Loyverse: GET /customers/{customer_id}.
- `loyverse_list_payment_types`: List the payment types (cash, card, integrated terminals…) and the stores where each is available. Receipt payments reference these ids. Loyverse: GET /payment_types.
- `loyverse_list_discounts`: List configured discounts (fixed/variable percent or amount, discount-by-points) and where they apply. Loyverse: GET /discounts.
- `loyverse_list_taxes`: List taxes with their rate, whether they are INCLUDED in or ADDED to the price, and the stores they apply in. Loyverse: GET /taxes.
- `loyverse_list_suppliers`: List suppliers with their contact details. Loyverse: GET /suppliers/.
- `loyverse_upsert_customer`: Create a loyalty customer, or update one by passing its `id`. Loyverse does not document whether omitted fields survive an update, so on update fetch the customer first and send the full record. Loyverse: POST /customers.
- `loyverse_upsert_category`: Create an item category, or rename/recolor one by passing its `id`. Loyverse: POST /categories.
- `loyverse_upsert_supplier`: Create a supplier, or update one by passing its `id`. Loyverse does not document whether omitted fields survive an update, so on update send the full record. Loyverse: POST /suppliers/.
- `loyverse_set_inventory_levels`: Set the ABSOLUTE stock (`stock_after`) of one or more variants at given stores — e.g. after a stock count. This overwrites the current level rather than adding to it; read the current levels with loyverse_list_inventory first so they can be restored. Loyverse: POST /inventory.

## FAQ

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

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

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