Loyverse

io.usefulapiv1.0.0Updated Sep 30, 2026

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

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Lets an assistant read Loyverse POS data — receipts, shifts, items, inventory, customers — and update customers, categories, suppliers and stock levels.

What it does
A hosted MCP server for the Loyverse point-of-sale platform. Read tools cover the merchant, stores, employees, receipts, shifts, items and variants, categories, inventory levels, customers, payment types, discounts, taxes and suppliers. Write tools create or update customers, categories and suppliers, and set inventory levels. Two meta tools report usage and manage the subscription.
When to use it
Useful when an assistant should answer questions about store sales, receipts, shifts or stock, or make small catalog and stock corrections without opening the Loyverse Back Office. It fits merchants and staff who already run Loyverse and want conversational access to their own data.
Requirements
A remote streamable HTTP endpoint; no local install. Requires a Loyverse personal access token, created in the Loyverse Back Office under Integrations > Access tokens, supplied on first connect. Network access to the hosted endpoint is needed.
Before you install
The access token is a credential granting access to your Loyverse account; it is validated and stored per user by the provider. Write tools mutate data — upserting customers, categories and suppliers, and setting inventory levels — so confirm them before running. The service is metered: 100 tool calls per month free, then $9/mo or $90/yr for unlimited, and meta tools can change the subscription.

Installation

In SourceWeft

  1. Open Loyverse in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

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

README

Loyverse MCP by usefulapi

Use Loyverse from Claude, Cursor, or any MCP client — review receipts, shifts, items, inventory and customers, and update customers, categories, suppliers and stock levels. Hosted, no local install: connect with your own Loyverse credentials.

Live endpoint: https://loyverse.usefulapi.io/mcp · Homepage: https://usefulapi.io/loyverse

Add to Claude

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

On first connect you'll provide your Loyverse personal access token (Back Office > Integrations > Access tokens). They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
loyverse_get_merchantreadGet the merchant
loyverse_list_storesreadList stores
loyverse_list_employeesreadList employees
loyverse_list_receiptsreadList receipts
loyverse_get_receiptreadGet one receipt
loyverse_list_shiftsreadList shifts
loyverse_list_itemsreadList items
loyverse_get_itemreadGet one item
loyverse_list_variantsreadList item variants
loyverse_list_categoriesreadList categories
loyverse_list_inventoryreadList inventory levels
loyverse_list_customersreadList customers
loyverse_get_customerreadGet one customer
loyverse_list_payment_typesreadList payment types
loyverse_list_discountsreadList discounts
loyverse_list_taxesreadList taxes
loyverse_list_suppliersreadList suppliers
loyverse_upsert_customerwriteCreate or update a customer
loyverse_upsert_categorywriteCreate or update a category
loyverse_upsert_supplierwriteCreate or update a supplier
loyverse_set_inventory_levelswriteSet inventory levels
loyverse_usage_statusmetaUsage status (free-tier meter)
loyverse_upgrademetaUpgrade to Pro (unlimited)

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage or manage your subscription.

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited

License

MIT © usefulapi. Not affiliated with or endorsed by Loyverse.

Source: servers/loyverse/README.md at commit 1ec23c2

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestSep 30, 2026