Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the Loyverse in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
Loyverse point of sale back office: sales and refund receipts, shifts and cash, items with variants, categories, modifiers, discounts and taxes, stock per store, loyalty customers, employees, stores, POS devices, payment types, suppliers and webhooks. Refunds and deletes install switched off.
Try asking
Example prompts for Loyverse
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Loyverse, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Loyverse + Meta Muse
Loyverse point of sale back office: sales and refund receipts, shifts and cash, items with variants, categories, modifiers, discounts and taxes, stock per store, loyalty customers, employees, stores, POS devices, payment types, suppliers and webhooks. Refunds and deletes install switched off.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
LOYVERSE_ACCESS_TOKEN
Step 1 — Get credentials
Setting up takes about 2 minutes. You need the owner login of a Loyverse account.
- Sign in to the Loyverse Back Office as the owner and open Settings, Access tokens (
https://r.loyverse.com/dashboard/#/integrations/tokens). On some plans access tokens are part of the Integrations add-on. - Click Add access token, give it a name and, if you like, an expiry date, and save. Copy the token.
- Paste it into
LOYVERSE_ACCESS_TOKEN. It is sent asAuthorization: Bearer <token>and has full access to the account, so keep it private. - Install the connector and run
loyverse_get_merchant: it shows the business name and currency and confirms the token.
The connector talks to the Loyverse API v1.0 at https://api.loyverse.com/v1.0, the back office API of the Loyverse point of sale.
What it reads: the account with loyverse_get_merchant (currency and its decimal places), stores with loyverse_list_stores and loyverse_get_store, and POS devices with loyverse_list_pos_devices. Sales: loyverse_list_receipts by store and date range (created_at_min/created_at_max) or receipt numbers, newest first, with line items, discounts, taxes, payments, employee and customer; loyverse_get_receipt reads one receipt by its number. Shifts and cash: loyverse_list_shifts and loyverse_get_shift (cash movements, expected and actual cash, gross and net sales, taxes, payments per type). Payment types with loyverse_list_payment_types and loyverse_get_payment_type. Catalog: loyverse_list_items, loyverse_get_item, variants with SKU, barcode and per-store price with loyverse_list_variants (search by sku) and loyverse_get_variant, categories, modifiers, discounts, taxes and suppliers. Stock: loyverse_list_inventory gives in_stock per variant and store. Customers with loyverse_list_customers (search by email) and loyverse_get_customer, with visits, total spent and loyalty points; employees with loyverse_list_employees and loyverse_get_employee; webhooks with loyverse_list_webhooks.
What it writes: loyverse_create_receipt records a sale made elsewhere, for example in another channel: it reduces stock for tracked items and counts in the reports, and its payments must add up to the receipt total. The save tools create a record without id and update it with id: loyverse_save_item, loyverse_save_variant, loyverse_save_category, loyverse_save_discount, loyverse_save_tax and loyverse_save_customer (total_points sets the loyalty balance). An update replaces the whole record, so the AI reads it first and sends every field you want to keep. loyverse_set_inventory takes the new absolute quantity in stock_after, not a difference. loyverse_create_webhook subscribes an HTTPS URL to one event (receipts, items, customers, inventory changes or closed shifts); event type plus URL must be unique. Before a receipt or a stock change the AI shows you the lines, amounts or new levels and waits for your yes.
Switched off at install: loyverse_refund_receipt, loyverse_delete_item and loyverse_delete_customer. They cannot be undone, so a workspace admin switches them on when the team needs them.
Data formats: ids are UUIDs; receipts are addressed by receipt_number (e.g. 1-1001). Money is a decimal number in the account currency (see loyverse_get_merchant). Receipts have receipt_type SALE or REFUND; refunds carry positive amounts, so the AI subtracts them when it adds up sales, and cancelled_at marks cancelled receipts. All times are UTC (ISO 8601); the AI converts them to the store's time zone before grouping by day. Records deleted in the Back Office are hidden unless show_deleted is true.
Paging: list tools return limit records (50 by default, at most 250) and a cursor while more exist; the AI passes it as cursor until it is missing. Stores, POS devices, payment types, discounts and taxes come back all at once.
Limits and common errors: 300 requests per 300 seconds per account; above that Loyverse answers 429 RATE_LIMITED. Errors come as errors: [{code, details, field}]. 401 UNAUTHORIZED means a wrong or expired token: copy it again or create a new one. 402 PAYMENT_REQUIRED means the subscription or the add-on that includes the API has lapsed. 403 FORBIDDEN, 404 NOT_FOUND a wrong id, 400 INVALID_VALUE or MISSING_REQUIRED_PARAMETER with the field named.
With the tools on at install, the connector does not refund receipts and deletes nothing. It reads stores, POS devices, payment types, employees, modifiers and suppliers but does not create or change them, and it does not remove webhooks.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Muse
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Muse adds remote MCP servers as custom connectors and signs in to them with OAuth.
- In Muse, open Settings → Connectors and choose Add custom connector.
- Paste the MCP server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse opens the AnythingMCP sign-in page: sign in and approve access.
- In a chat, ask Muse for something that needs the
Loyversetools.
You can also set it up from a chat, on the web, in the iOS and Android apps or in WhatsApp. Send Muse this message:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Muse connects from Meta's cloud, so localhost does not work.
Available tools
| Tool | What it does |
|---|---|
loyverse_get_merchant | Get the Loyverse account (merchant) behind the token: business name, email, country and currency with its decimal places |
loyverse_list_stores | List the stores of the account with name, address, phone and description |
loyverse_get_store | Get one store by its id (UUID) with name, address, phone number and description, as shown in the Back Office |
loyverse_list_pos_devices | List the POS devices (registers) of the account, optionally for one store, with name, store id and whether the device is activated |
loyverse_list_receipts | List sales and refund receipts, newest first, with line items, discounts, taxes, payments, totals, store, employee, customer and POS device |
loyverse_get_receipt | Get one receipt by its receipt number (e.g. 1-1001) with all line items, modifiers, discounts, taxes, payments and the refund link |
loyverse_create_receipt | Record a sales receipt in Loyverse (e.g. a sale made in another channel) |
loyverse_refund_receipt | Create a refund receipt for some or all lines of a sales receipt |
loyverse_list_shifts | List closed cash register shifts with opening and closing time, cash movements, expected and actual cash, gross and net sales, taxes and… |
loyverse_get_shift | Get one shift by id with cash drawer amounts, cash movements, sales totals, taxes and payment totals per payment type |
loyverse_list_payment_types | List payment types (cash, card, check and custom ones) with their id and type |
loyverse_get_payment_type | Get one payment type by id with its name, type (CASH, NONINTEGRATEDCARD, CHECK, OTHER and so on) and stores |
loyverse_list_items | List items of the catalog with category, taxes, modifiers, options and their variants (SKU, barcode, cost, default price and price per… |
loyverse_get_item | Get one item by id with its variants, prices per store, category, tax ids, modifier ids, stock tracking and composite components |
loyverse_save_item | Create an item, or update it when id is given (Loyverse upserts with POST) |
loyverse_delete_item | Delete an item and its variants from the catalog |
loyverse_list_variants | List item variants with SKU, barcode, option values, cost, default price and per-store price and availability |
loyverse_get_variant | Get one item variant by id with SKU, barcode, option values, cost and the price and availability in each store |
loyverse_save_variant | Create a variant of an existing item, or update it when variant_id is given (upsert with POST) |
loyverse_list_categories | List item categories with name and colour |
loyverse_get_category | Get one item category by id (UUID) with its name, colour and creation and deletion times |
loyverse_save_category | Create an item category, or rename or recolour it when id is given (Loyverse upserts with POST) |
loyverse_list_modifiers | List modifiers (e.g |
loyverse_list_discounts | List discounts with type (fixed or variable, percent or amount, by points), value, stores and whether access is restricted |
loyverse_get_discount | Get one discount by id (UUID) with its type, amount or percent, stores and restricted access flag |
loyverse_save_discount | Create a discount, or update it when id is given (upsert with POST) |
loyverse_list_taxes | List taxes with rate, type (included in the price or added to it) and stores |
loyverse_get_tax | Get one tax by id (UUID) with its name, rate in percent, type (INCLUDED or ADDED) and stores |
loyverse_save_tax | Create a tax, or update it when id is given (upsert with POST) |
loyverse_list_suppliers | List suppliers with contact name, email, phone, website, address and note |
loyverse_list_inventory | List stock levels per item variant and store (in_stock) |
loyverse_set_inventory | Set the stock of item variants in stores. stock_after is the new absolute quantity, not a change: read the current level first and confirm… |
loyverse_list_customers | List loyalty customers with contact details, customer code, note, first and last visit, total visits, total spent and points balance |
loyverse_get_customer | Get one customer by id with contact details, address, customer code, visits, total spent and loyalty points |
loyverse_save_customer | Create a customer, or update one when id is given (upsert with POST). total_points sets the loyalty balance |
loyverse_delete_customer | Delete a customer with their loyalty points |
loyverse_list_employees | List employees with name, email, phone, role and the stores they work in |
loyverse_get_employee | Get one employee by id (UUID) with name, email, phone number, owner flag and the stores they work in |
loyverse_list_webhooks | List the webhooks of the account with event type, target URL and status (ENABLED or DISABLED after failed deliveries) |
loyverse_create_webhook | Subscribe an HTTPS URL to one event: receipts, items, customers or inventory changes, or closed shifts |
Example prompts
- "What were the net sales per store yesterday, with refunds subtracted?"
- "Show me the last closed shift at the Downtown store with expected and actual cash."
- "Which variants have fewer than 5 in stock at the Downtown store?"
- "Set the stock of SKU LATTE-CUP-12 at the Downtown store to 200. Show me the current level first."
- "Find the customer with the email [email protected] and show his visits, total spent and points."
FAQ
Where is Muse available? Meta currently offers Muse in the US and Canada, on the web, in the iOS and Android apps and in WhatsApp.
Does Meta review this connector? No. Meta doesn't review custom connectors. Muse sees only the tools you switched on for this MCP server in AnythingMCP, and you can disconnect it anytime under Settings → Connectors.
Next steps
- Connector landing page
- Connect to Claude
- Connect to ChatGPT
- Connect to Cursor
- Connect to Gemini
- Connect to Microsoft Copilot
Was this guide helpful?