# Loyverse MCP

> Loyverse connects your AI agent directly to your Point-of-Sale system. You can manage store inventory, track detailed sales data, and look up customer profiles using natural language prompts. Quickly check stock levels across multiple branches, retrieve full receipts for auditing, or pull daily revenue figures without ever opening the dashboard.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** point-of-sale, sales-tracking, inventory-control, retail-management, receipt-management, small-business-tools

## Description

This MCP lets you run your entire retail operation through conversation. Instead of jumping between separate dashboards to track sales numbers or check if a product is in stock, you ask your AI client and get the answer immediately. You can programmatically manage inventory levels, pull detailed receipts for any date range, and access full customer history just by talking to your agent.

The system consolidates data from multiple store locations so you don't have to worry about siloed information anymore. By connecting this MCP via Vinkius, your AI client treats the entire Loyverse platform like one single source of truth, making complex tasks—like calculating total sales across three stores yesterday—as simple as asking a question.

## Tools

### l_list_customers
Lists every registered customer from your Loyverse POS system.

### l_list_items
Provides a list of inventory items in your account, with options to narrow down the search.

### l_list_locations
Retrieves details for all store locations linked to your Loyverse account.

### l_list_receipts
Lists generated receipts from the POS system, letting you filter by a specific date range.

## Prompt Examples

**Prompt:** 
```
Fetch the total sales numbers for all locations yesterday.
```

**Response:** 
```
Retrieved yesterday's sales figures: A total of $4,532.10 across 3 stores with 120 individual receipts.
```

**Prompt:** 
```
Check the current inventory level for the item 'Honduras Dark Roast Coffee' at the Main Street location.
```

**Response:** 
```
The item 'Honduras Dark Roast Coffee' has 45 units in stock at the Main Street location. The low stock alert threshold is 10 units.
```

**Prompt:** 
```
Create a new customer profile for John Doe with the email john@example.com.
```

**Response:** 
```
Customer profile for 'John Doe' (john@example.com) has been successfully created and linked to your customer database.
```

## Capabilities

### Retrieve Sales and Receipts
Get aggregated sales metrics or detailed receipts for any date range.

### Manage Stock Levels
List specific items in your inventory and check stock levels across different store locations.

### Find Customer Records
Search and retrieve detailed profiles for registered customers in the system.

### Map Store Locations
List all operational store locations to coordinate tasks across different branches.

## Use Cases

### End-of-Day Reconciliation
A store manager needs to confirm the total sales from yesterday across three different sites. Instead of logging into three separate dashboards and exporting reports, they ask their agent to retrieve all relevant receipts using `l_list_receipts`, getting a single consolidated summary.

### Checking for Missing Product Data
A customer service rep needs to know if an obscure product is stocked in the nearest location. They use their agent to call `l_list_items` and check inventory, confirming stock levels immediately without needing a physical walk-through.

### Auditing Account Activity
A retail owner needs to pull transaction details for a specific date range due to an audit. They use the agent's capability to retrieve receipts with `l_list_receipts`, providing comprehensive data quickly.

### Training New Staff
A supervisor trains new staff on locating customer records. Instead of showing them where to click, they prompt the agent using `l_list_customers` and demonstrate how fast the system can pull up a profile by email.

## Benefits

- Audit sales instantly: You can call `l_list_receipts` to get full records for any date range, eliminating the need to manually search through physical ledgers or multiple reports.
- Know your stock in seconds: Use `l_list_items` to check inventory across all locations, getting immediate counts without navigating deep into the inventory dashboard.
- Support customers better: When you need a customer's history, simply use `l_list_customers` and retrieve their full profile data for quick service resolutions.
- Multi-branch coordination: By using `l_list_locations`, your agent coordinates tasks across every store branch, treating all locations as one network.
- Quick Reporting: Pull aggregate sales metrics or daily revenue figures through conversation, saving time previously spent compiling spreadsheets.

## How It Works

The bottom line is, you talk to your agent once, and it handles the complex back-end calls to Loyverse for you.

1. Subscribe to this MCP and then generate an Access Token from your Loyverse Back Office.
2. Connect your preferred AI client (Claude, Cursor, etc.) using the Vinkius connection details.
3. Ask your agent a question about sales or inventory; the system executes the appropriate tool call and returns the data.

## Frequently Asked Questions

**How do I find out what customers Loyverse MCP can list?**
You use `l_list_customers` to retrieve a full roster of all registered store customers. This gives you the necessary data for marketing or service follow-up.

**Can I check stock levels using the Loyverse MCP?**
Yes, call `l_list_items`. You can list specific inventory items and get their current stock count across different locations in one command.

**Does the Loyverse MCP handle online sales? **
This MCP focuses on POS and physical store data. While it handles transactions, its core functions deal with in-store sales records via `l_list_receipts`.

**What if I need to find multiple store locations?**
You use the `l_list_locations` tool. It retrieves details for all store branches, allowing you to run reports or check inventory across your whole chain.

**How do I get sales data for a specific date range with Loyverse MCP?**
Use `l_list_receipts`. This tool lets you specify minimum and maximum dates, ensuring you only pull the relevant transaction records.