Loyverse MCP server

Connect Loyverse to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Loyverse MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list discounts tool in Loyverse
  • Use the create refund tool in Loyverse
  • Use the create or update tax tool in Loyverse
  • Use the delete discount tool in Loyverse
  • Use the delete tax tool in Loyverse
  • Use the delete item tool in Loyverse

Supported Tools

list_discounts

List Discounts

Retrieve discount configurations. Discounts can be fixed or variable percentages or amounts, or discounts by loyalty points, applied at receipt or line-item level.

create_refund

Create Refund

Create a refund receipt for line items of an existing sales receipt. Refunded items are automatically restocked. Identify each line by its line item ID from Get Receipt, or by variant ID when the variant appears on only one line of the sale.

create_or_update_tax

Create or Update Tax

Create a new tax rate or update an existing one. Taxes can be configured as included in or added to item prices. When updating, fields you omit keep their current values.

delete_discount

Delete Discount

Delete a discount by its ID.

delete_tax

Delete Tax

Delete a tax configuration by its ID.

delete_item

Delete Item

Delete an item (product) from the catalog by its ID.

get_receipt

Get Receipt

Retrieve a single sales or refund receipt by its receipt number, including full line items (with line item IDs needed for refunds), payment details, taxes, discounts, and modifiers.

create_receipt

Create Receipt

Create a new sales receipt (transaction) in a store. The receipt includes line items (by variant ID), one payment, and optionally a customer, order reference, taxes, discounts, and modifiers. Totals are calculated by Loyverse. Use this to record sales made in another system.

list_shifts

List Shifts

Retrieve closed cash register shifts, newest first, including open/close times, cash drawer totals, sales totals, and the employees who opened and closed them. Filter by store or by the time the shift was opened.

create_or_update_supplier

Create or Update Supplier

Create a new supplier or update an existing one. Suppliers are used for inventory sourcing and can be linked to items. When updating, fields you omit keep their current values.

update_inventory

Update Inventory

Set the stock level of item variants at store locations. Supports batch updates for multiple variants and stores in a single request. The value replaces the current stock (it is not added to it).

delete_category

Delete Category

Delete a category by its ID.

list_payment_types

List Payment Types

Retrieve all configured payment types (e.g., cash, card, custom). Payment type IDs are needed when creating receipts.

list_categories

List Categories

Retrieve item categories. Categories are used to organize items in the catalog.

list_modifiers

List Modifiers

Retrieve item modifiers (e.g., "Size" with options Small/Medium/Large). Modifiers add selectable options with price adjustments to items.

create_or_update_customer

Create or Update Customer

Create a new customer or update an existing one. If a **customerId** is provided, the customer is updated and fields you omit keep their current values; otherwise a new customer is created. Customers can be looked up by email using the List Customers tool before updating.

delete_supplier

Delete Supplier

Delete a supplier record by its ID.

list_employees

List Employees

Retrieve employee records. Employees can only be read via the API; create/update/delete operations must be done through the Loyverse Back Office.

get_item

Get Item

Retrieve a single item (product) by its ID, including full variant details, pricing, and configuration.

delete_customer

Delete Customer

Delete a customer record by its ID.

delete_modifier

Delete Modifier

Delete a modifier by its ID.

create_or_update_category

Create or Update Category

Create a new category or update an existing one. Categories organize items in the Loyverse catalog. When updating, fields you omit keep their current values.

list_stores

List Stores

Retrieve all store locations. Store IDs are needed for receipts, inventory, and shifts.

list_items

List Items

Retrieve items (products) from the Loyverse catalog, newest first. Supports filtering by item IDs and by created/updated time for syncing recently changed products. Returns paginated results with variants, pricing, stock tracking, and category assignments. To find a product by SKU, use List Variants.

list_customers

List Customers

Retrieve customer records from Loyverse, newest first. Supports filtering by customer IDs, email, and created/updated date ranges for syncing customer data. Returns paginated results.

create_or_update_item

Create or Update Item

Create a new item (product) or update an existing one in the catalog. If an **itemId** is provided, the item is updated and fields you omit keep their current values; otherwise a new item is created. Supports setting variants, pricing, categories, taxes, and modifiers.

list_taxes

List Taxes

Retrieve tax configurations. Taxes can be applied to items and receipts.

create_or_update_discount

Create or Update Discount

Create a new discount or update an existing one. Supports fixed percentage, fixed amount, variable (entered at sale), and loyalty-points discounts. When updating, fields you omit keep their current values.

list_suppliers

List Suppliers

Retrieve supplier records used for inventory sourcing.

get_merchant

Get Merchant

Retrieve account-level merchant information for the connected Loyverse account, including business name, email, country, and currency.

get_inventory

Get Inventory

Retrieve inventory (stock) levels for item variants across store locations. Filter by stores, variants, or update time to check specific stock levels. Use this instead of the item tools to get stock information.

create_or_update_modifier

Create or Update Modifier

Create a new modifier or update an existing one. Modifiers define selectable options (e.g., Size: S/M/L) with optional price adjustments. When updating, fields you omit keep their current values.

list_receipts

List Receipts

Retrieve sales and refund receipts (transactions) from Loyverse, newest first. Filter by store, receipt numbers, order, source, or created/updated date ranges for syncing sales data. Returns line items, payments, discounts, and tax details.

list_variants

List Variants

Retrieve item variants (the sellable units of items, each with its own SKU, barcode, and price). Filter by SKU to look up a product code, or by item IDs, variant IDs, and created/updated time. Variant IDs are needed for receipts and inventory updates.

get_customer

Get Customer

Retrieve a single customer by ID, including contact details, visit history, total spent, and loyalty points balance.

list_pos_devices

List POS Devices

Retrieve POS devices and their store assignments and activation status. Use device IDs to identify the registers associated with receipts and shifts. Call list_stores to discover store IDs.

Connect Loyverse to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Loyverse in Metorial. In your Metorial portal, enable the Loyverse MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Loyverse tools.

Run Loyverse through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Loyverse and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Loyverse tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Loyverse

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Apolloio

Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.

Hubspot

Create, read, update, and delete CRM objects including contacts, companies, deals, tickets, and custom objects. Manage associations between CRM records. Track engagements such as calls, emails, meetings, notes, and tasks. Send transactional and marketing emails, manage campaigns, and handle subscription preferences. Build and manage marketing workflows, sequences, and automation actions. Manage CMS content including blog posts, landing pages, and HubDB tables. Handle commerce data including products, orders, invoices, quotes, and payments. Create and manage contact lists for segmentation. Configure deal, ticket, and order pipelines with custom stages. Search and filter CRM records. Bulk import and export CRM data. Manage users, teams, and account settings.

Linkedin

Authenticate LinkedIn members with OpenID Connect, fetch the authenticated member profile, and create self-serve LinkedIn shares with text, article links, and uploaded images. Organization and Community Management workflows should move to a separate slate because LinkedIn restricts combining those products in one app.

Calendly

List, retrieve, and cancel scheduled events. Book meetings programmatically on behalf of invitees using available time slots. Retrieve event types and their configurations. Query user availability, available time slots, busy times, and availability schedules. Create single-use scheduling links with optional overrides. List and manage invitees, mark no-shows, and access custom question responses and UTM tracking data. Manage organization memberships, invite or remove users. Retrieve routing form configurations and submissions. Subscribe to webhooks for new bookings, cancellations, and routing form submissions.

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Technical notes for Loyverse

Manage a cloud-based point-of-sale system for retail stores, cafes, and restaurants. Manage items, categories, modifiers, and item variants in the product catalog, including composite items. Look up variants by SKU and track and update inventory stock levels across multiple store locations. Create sales receipts and process refunds. Manage customer records and loyalty balances with lookup by ID or email. Create and configure discounts, tax rates, and suppliers. Read employee and shift data. Retrieve store locations, POS devices, payment types, and merchant information. Filter catalog, employee, and store records by IDs or supported creation/update dates for synchronization.

Frequently asked questions

Common questions about connecting Loyverse to AI agents with Metorial.

  1. How many tools does the Loyverse MCP server have?
    The Loyverse MCP server exposes 36 tools, including List Discounts, Create Refund, Create or Update Tax. Each one is governed and traced through Metorial.
  2. Loyverse exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Loyverse MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Loyverse and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Loyverse MCP server yourself or use the hosted gateway.

Connect Loyverse to production AI agents

See how Metorial gives your team governed access to Loyverse, with tracing and security controls built in.