MCP server

Loyverse MCP by usefulapi

io.usefulapi/loyverse

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

21

Token cost

About 5,815 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.loyverse]
url = "https://loyverse.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"loyverse":{"httpUrl":"https://loyverse.usefulapi.io/mcp"}}}

Cursor

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

VS Code

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

Antigravity

agy mcp add loyverse https://loyverse.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"loyverse","server_url":"https://loyverse.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"loyverse","server_url":"https://loyverse.usefulapi.io/mcp"}

Tools

• loyverse_get_customer ~110 tokens
  Fetch a single customer by id, with visits, total spent and points balance. Loyverse: GET /customers/{customer_id}.
• loyverse_get_item ~96 tokens
  Fetch a single catalog item by id, with its variants. Loyverse: GET /items/{item_id}.
• loyverse_get_merchant ~90 tokens
  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_get_receipt ~126 tokens
  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_categories ~182 tokens
  List item categories. Loyverse: GET /categories.
• loyverse_list_customers ~358 tokens
  List loyalty customers, newest first, with visits, total spent and points balance. Filter by email or ids. Loyverse: GET /customers.
• loyverse_list_discounts ~302 tokens
  List configured discounts (fixed/variable percent or amount, discount-by-points) and where they apply. Loyverse: GET /discounts.
• loyverse_list_employees ~360 tokens
  List employees, with the stores each can access and whether they are the owner. Loyverse: GET /employees.
• loyverse_list_inventory ~276 tokens
  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_items ~366 tokens
  List catalog items with their variants (SKU, barcode, price, cost, per-store pricing), category, taxes and modifiers. Loyverse: GET /items.
• loyverse_list_payment_types ~316 tokens
  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_receipts ~501 tokens
  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_list_shifts ~267 tokens
  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_stores ~305 tokens
  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_suppliers ~188 tokens
  List suppliers with their contact details. Loyverse: GET /suppliers/.
• loyverse_list_taxes ~299 tokens
  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_variants ~422 tokens
  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_set_inventory_levels ~264 tokens
  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.
• loyverse_upsert_category ~169 tokens
  Create an item category, or rename/recolor one by passing its `id`. Loyverse: POST /categories.
• loyverse_upsert_customer ~399 tokens
  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_supplier ~419 tokens
  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/.

Browse

• Email
• Payments

Related MCP servers

• TicketSpice MCP by usefulapi
  Read TicketSpice forms, orders, tickets, customers, coupons; create or delete coupons.
• Sapo MCP by usefulapi
  Read Sapo store products, orders, customers and stock levels; edit order notes and stock.
• Hiboutik MCP by usefulapi
  Read Hiboutik products, stock, customers, sales and turnover; edit customers and sale comments.
• SpellBook Finance
  Magic: The Gathering card prices, movers, arbitrage, sealed box EV, and seller inventory tools.
• PHP Point of Sale MCP by usefulapi
  Read PHP Point of Sale items, sales, customers and 138 reports; manage customers, items, expenses.
• Finale Inventory MCP by usefulapi
  Read Finale Inventory products, stock, orders and shipments; create draft purchase orders.
• Lightspeed Retail (R-Series) MCP by usefulapi
  Read Lightspeed R-Series items, stock, sales, customers and POs; create customers and set stock.
• Farmbrite MCP by usefulapi
  Read Farmbrite livestock, crops, tasks, inventory and orders; log records and tasks.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/loyverse.svg)](https://aptlynx.net/servers/io.usefulapi/loyverse)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents