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.
Ask your agent in plain language. Each of these maps to a real tool on the server.
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 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 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 a discount by its ID.
delete_tax
Delete a tax configuration by its ID.
delete_item
Delete an item (product) from the catalog by its ID.
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 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
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 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
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 a category by its ID.
list_payment_types
Retrieve all configured payment types (e.g., cash, card, custom). Payment type IDs are needed when creating receipts.
list_categories
Retrieve item categories. Categories are used to organize items in the catalog.
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 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 a supplier record by its ID.
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
Retrieve a single item (product) by its ID, including full variant details, pricing, and configuration.
delete_customer
Delete a customer record by its ID.
delete_modifier
Delete a modifier by its ID.
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
Retrieve all store locations. Store IDs are needed for receipts, inventory, and shifts.
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
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 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
Retrieve tax configurations. Taxes can be applied to items and receipts.
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
Retrieve supplier records used for inventory sourcing.
get_merchant
Retrieve account-level merchant information for the connected Loyverse account, including business name, email, country, and currency.
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 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
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
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
Retrieve a single customer by ID, including contact details, visit history, total spent, and loyalty points balance.
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.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
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.
Common questions about connecting Loyverse to AI agents with Metorial.