Loyverse
Loyverse is a point-of-sale (POS) system designed for small businesses, offering features like sales management, inventory tracking, and customer engagement tools.
Verdict
Common use cases
- Check stock levels before ordering supplies
- Create new suppliers from vendor emails
- Audit active discounts across all stores
- Update product categories during inventory review
- Retrieve employee records for shift planning
Integration
- Vendor
- Loyverse
- Category
- other
- Auth
- API_KEY
- Tools
- 24
- Composio slug
loyverse
Tools
- Create Supplier
Tool to create a new supplier. use when you need to register a supplier in loyverse before purchases.
- Delete Categorydestructive
Tool to delete a single category by id. use when you need to remove an unused or deprecated category.
- Delete Supplierdestructive
Tool to delete a specific supplier by id. use after confirming the supplier id to remove an existing supplier.
- Get Category
Tool to get a single category by id. use when you need to fetch details of an existing category in loyverse.
- Get Discount
Tool to get a single discount by id. use after confirming the discount id to retrieve its details.
- Get Employee
Tool to get a single employee by id. use after confirming the employee id to fetch its details.
- Get JWKS
Tool to fetch json web key set for openid connect. use when verifying loyverse id token signatures.
- Get Merchant Info
Tool to get merchant information. use after authenticating to retrieve merchant account details.
- Get OpenID Connect Discovery Document
Tool to retrieve the openid connect discovery document. use when integrating authentication and need endpoints and supported features.
- Get Payment Type
Tool to get a single payment type by its id. use when you need to fetch full details of a specific payment method before processing a transaction.
- Get Store
Tool to retrieve details of a specific store by its id. use when you need store metadata (address, contact) after obtaining the store id.
- List Categories
Tool to list categories with optional filtering and pagination.
- List Customers
Tool to get a list of customers. use when you need paginated customer lists with optional filters.
- List Discounts
Tool to list discounts. use when fetching a paginated set of discounts for display or sync.
- List Employees
Tool to get a list of employees. use when you need paginated employee lists with optional filters. works after authenticating.
- List Items
Tool to list items with filtering and pagination. use when you need to retrieve inventory items with optional filters and handle pagination for large result sets.
- List Modifiers
Tool to list modifiers. use when you need a paginated list of modifiers with optional filters.
- List Payment Types
Tool to list payment types. use when you need to fetch available payment methods with optional filters and pagination.
- List Receipts
Tool to retrieve a list of receipts. use when you need to fetch receipts with optional filters and handle pagination.
- List Shifts
Tool to list shifts. use when you need to retrieve shift records for reporting or auditing with optional filters.
- List Suppliers
Tool to retrieve a list of suppliers. use when you need a paginated supplier directory with optional filters.
- List Taxes
Tool to list taxes. use when you need to fetch tax configurations with pagination for reporting or synchronization purposes. example: "list taxes with limit 100 and offset 0".
- List Variants
Tool to list variants. use when you need to retrieve item variants with optional filtering by item and pagination.
- List Webhooks
Tool to list webhooks. use when you need to retrieve all configured webhooks.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Search for Loyverse and click Connect. 3. You'll be prompted to enter your Loyverse API access token — generate one by logging into your Loyverse Back Office at loyverse.com, going to Settings > API Tokens, and creating a new token with read and write permissions for Inventory, Employees, and Discounts. 4. Paste the token into Switchy and click Authorize. 5. Switchy will verify the connection by fetching your merchant info. 6. To test, open any Space and type '@Loyverse get merchant info' — you should see your store name and account details. 7. From there, you can invoke any of the 24 tools by @mentioning Loyverse followed by your request.
What teammates see: by default, memories from Loyverse are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Inventory Snapshot
@Loyverse list all products with their current stock quantities and flag any items below 10 unitsOpen in a Space →
Add New Supplier
@Loyverse create a new supplier named 'Acme Wholesale' with email acme@example.com and phone 555-1234Open in a Space →
Discount Audit
@Loyverse list all discounts currently active and show their percentage or fixed amount valuesOpen in a Space →
Category Cleanup
@Loyverse show all product categories and tell me which ones have zero products assignedOpen in a Space →
Employee Lookup
@Loyverse get the details for employee ID 12345 including their name and assigned storeOpen in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Loyverse show me all active discounts and their current redemption rates across our stores
Based on your Loyverse account, here are the active discounts: '10% Off Coffee' (redeemed 47 times this week, applied to 8.2% of eligible transactions), 'Happy Hour 2-for-1' (redeemed 23 times, 12% redemption rate), and 'Loyalty Member 15%' (redeemed 156 times, 31% redemption rate). The loyalty member discount shows the highest engagement. Note: redemption data reflects completed transactions only; abandoned carts aren't included.
This example demonstrates read-heavy data retrieval across multiple discount records. Requires API key with read access to discounts and receipts. Redemption rate calculations depend on transaction history scope—accounts with limited history may see incomplete metrics. Rate limits apply to bulk discount queries.
@Loyverse create a new supplier called 'Blue Mountain Coffee Co' with contact email orders@bluemountain.com and payment terms Net 30
Supplier created successfully. 'Blue Mountain Coffee Co' has been added to your Loyverse account with ID sup_8x4k2m9p. Contact email set to orders@bluemountain.com, payment terms configured as Net 30 days. You can now link this supplier to purchase orders and inventory items. The supplier appears immediately in your Loyverse POS and back-office systems.
This write operation showcases supplier management—a prerequisite for inventory purchasing workflows. Requires API key with write permissions to suppliers. The created supplier persists across all connected Loyverse devices. Consider validating supplier details before creation; the MCP doesn't verify email deliverability or duplicate names.
@Loyverse analyze our employee sales performance this month and suggest which team members should get recognition
Reviewing employee data: Sarah Chen leads with $18,400 in sales (127 transactions, $144 avg ticket), followed by Marcus Liu at $16,200 (98 transactions, $165 avg ticket). Marcus shows higher per-transaction value despite fewer sales. Recommendation: recognize Sarah for volume consistency and Marcus for upselling effectiveness. Note: Emily Rodriguez shows 89% customer return rate—consider highlighting her service quality even though her sales rank third at $12,800.
This synthesis example pairs Loyverse employee and receipt data with AI reasoning to surface performance insights. Requires read access to employees and receipts. The analysis quality depends on transaction history depth—newer accounts may lack sufficient data for meaningful patterns. Employee metrics don't capture non-sales contributions like inventory management.
Use-case deep-dives
When Loyverse wins for retail chains under 10 stores
A 3-location coffee shop chain runs daily inventory checks across stores and needs to sync supplier orders, discount rules, and employee access in one workspace. Loyverse's 24-tool MCP handles this well because the API key auth is simple to share across the team and the supplier/category/discount tools cover the core retail ops loop. The sweet spot is 2-10 locations: below that, a spreadsheet is faster; above 10, you hit rate limits on bulk category updates and need a dedicated POS integration layer. If your team is already in Loyverse for transactions and you're doing weekly supplier reconciliation or seasonal discount rollouts, this MCP turns those tasks into prompted workflows instead of manual portal clicks. Best for retail or hospitality teams where one ops person manages inventory across sites.
Loyverse for seasonal hiring in food service
A quick-service restaurant hires 15-20 seasonal workers every summer and needs to provision POS access, assign discount permissions, and track employee IDs without logging into the Loyverse dashboard 20 times. The Get Employee and merchant info tools let a manager pull current rosters into a shared Switchy thread, compare against a hiring spreadsheet, and script the onboarding checklist. This works if you're hiring in batches (not one-off) and your POS permissions are standardized by role. If every employee needs custom discount rules or you're onboarding across multiple merchant accounts, the MCP becomes tedious because you're looping through single-record tools. The threshold is about 10+ hires per quarter: below that, manual entry is fine; above that, you want this automated. Ideal for seasonal retail or event-based hospitality.
When Loyverse handles vendor reconciliation for wholesale buyers
A small grocery distributor sources from 30-50 suppliers and needs to audit which vendors are active, which categories they supply, and whether discount agreements are current. The Create/Delete Supplier and Get Category tools let a buyer pull the full supplier list into a Switchy workspace, cross-reference it with a contract tracker, and flag duplicates or deprecated entries. This scenario works if your supplier count is under 100 and you're doing quarterly audits, not daily procurement. Above 100 suppliers, the single-record Get tools slow down and you need batch export instead of MCP calls. If your team is already using Loyverse for purchase orders and you're spending an afternoon each quarter cleaning up the supplier database, this MCP turns that into a 20-minute prompted review. Best for wholesale or distribution teams with stable vendor rosters.
Frequently asked
What does the Loyverse MCP do in Switchy?
It connects your Loyverse POS data to Switchy's AI workspace. Your team can query sales, inventory, employees, suppliers, and discounts without opening the Loyverse dashboard. The MCP exposes 24 tools covering categories, merchants, receipts, and supplier management. Useful for retail teams who want AI to answer questions like 'which products sold best last week' or 'create a new supplier for this vendor'.
Do I need admin access to connect Loyverse?
You need a Loyverse API key, which requires account owner or manager permissions in Loyverse. Generate the key from your Loyverse backend settings, then paste it into Switchy's credential form. The key grants read and write access to your store data, so only share it with team members who should manage inventory and suppliers. Standard cashier accounts cannot create API keys.
Can the Loyverse MCP process refunds or void transactions?
No. The MCP reads receipt data and manages catalog entities like categories, discounts, and suppliers. It cannot modify completed transactions, issue refunds, or void sales. For transaction edits, use the Loyverse POS app directly. The MCP is designed for reporting, inventory setup, and supplier workflows—not point-of-sale operations or payment reversals.
How does this compare to exporting CSV reports from Loyverse?
The MCP lets AI query live data on demand instead of waiting for scheduled exports. Your team asks natural-language questions and gets current answers—no manual CSV downloads or spreadsheet pivots. However, Loyverse's native analytics dashboard offers richer visualizations for trend analysis. Use the MCP when you want conversational access to POS data; use Loyverse reports when you need charts and historical comparisons.
Who on the team should connect the Loyverse integration?
Your store manager or inventory lead—whoever already manages suppliers and product categories in Loyverse. They understand which data matters and can validate AI responses against actual stock levels. Connecting this MCP does not count against Switchy seat limits, but the API key holder is responsible for any catalog changes the AI makes through tools like Create Supplier or Delete Category.