# Loyverse MCP for AI Agents AI Agent Connect

> Loyverse MCP lets you talk to your point-of-sale and inventory data. You can check stock levels, pull sales numbers, and manage customer records using your favorite AI client. It connects your retail backend directly to your agent so you can get answers in seconds without logging into a dashboard. It's built for store owners who need quick answers about their inventory or daily revenue without digging through menus.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_hA6jtb916nyiJTehWdpYYE3IIBGwj6z5EASMAaBt/ai-agent-connect
- **Tags:** point-of-sale, sales-tracking, inventory-control, retail-management, receipt-management, small-business-tools

## Description

Loyverse MCP lets you talk to your point-of-sale and inventory data. Imagine you're running a retail shop and need to know if you're low on a specific item across three different locations. Usually, that means opening a browser, logging into your POS dashboard, and clicking through several menus. This Connector changes that by letting your AI agent do the heavy lifting for you. You can just ask your agent for a status update on stock, and it'll pull that data instantly. It works the same way for checking yesterday's sales totals or finding a specific customer's history. Instead of manual data entry or constant tab-switching, you get a direct line to your store's data. You can even use it to keep your customer profiles updated or see where your best-selling items are sitting. It's one of the many tools available in the Vinkius catalog that turns your existing business software into a conversational workspace. You no longer have to worry about missing a low-stock alert because you're busy with a customer. You can get the facts you need about your revenue and inventory while you're on the move. You just get your data, make your decisions, and get back to running your business. The goal is to move away from the friction of manual dashboard navigation and toward a system where your data is always available through a simple conversation.

## Tools

### l_list_customers
View all registered customers in your Loyverse account. You can use this to see who your regular shoppers are.

### l_list_items
See all inventory items in your account with optional pagination. This helps you keep track of your full product catalog.

### l_list_locations
View all store locations and details associated with your account. Use it to manage data across multiple branches.

### l_list_receipts
Get a list of receipts from your POS system, filtered by date or pagination. This makes it easy to check past transactions quickly.

## Prompt Examples

**Prompt:** 
```
How many units of 'Honduras Dark Roast' do we have at the Main Street store?
```

**Response:** 
```
I checked the inventory at the Main Street location:

* **Item:** Honduras Dark Roast Coffee
* **Stock Level:** 45 units
* **Status:** Healthy

*Note: The low stock alert threshold for this item is 10 units.*
```

**Prompt:** 
```
Show me the total sales from all stores yesterday.
```

**Response:** 
```
Here is the sales summary for yesterday:

| Store Location | Total Sales | Receipts |
| :--- | :--- | :--- |
| Main Street | $2,150.00 | 85 |
| Downtown | $1,840.00 | 72 |
| Westside | $542.10 | 18 |
| **Total** | **$4,532.10** | **175** |
```

**Prompt:** 
```
Who are our top 3 registered customers?
```

**Response:** 
```
I found the following top registered customers in your Loyverse account:

1. **John Doe** (john@example.com)
2. **Jane Smith** (j.smith@provider.net)
3. **Alice Johnson** (alice.j@webmail.com)
```

## Capabilities

### Check real-time stock levels
Get an instant count of how many units you have left in your inventory.

### Pull aggregated sales numbers
See your total revenue and receipt counts for specific dates or locations.

### Search registered customer profiles
Find customer contact info and history using natural language queries.

### View store location details
See a list of all your branches and their specific details.

### List specific inventory items
Get a full list of your products across your entire account.

### Retrieve historical receipts
Look up past transactions to verify sales or check specific orders.

## Use Cases

### Low stock alert
A manager asks if 'Coffee Beans' are low at the downtown branch. The agent uses l_list_items to check the count and warns them if it's below the threshold.

### Daily wrap-up
An owner asks for the total sales from yesterday across all stores. The agent uses l_list_receipts to pull the numbers and provide a summary.

### Customer lookup
A staff member needs to see a VIP's past purchase history. They ask the agent to find the customer using l_list_customers.

### Inventory audit
A worker wants to see a full list of items available at a specific site. The agent pulls the list using l_list_items for that location.

## Benefits

- Stop clicking through menus to find stock levels by using l_list_items to get instant answers.
- Get a bird's-eye view of your revenue by pulling data with l_list_receipts.
- Keep your customer database organized by using l_list_customers to find profiles quickly.
- Manage multi-location retail operations easily with l_list_locations.
- Reduce manual data entry errors by letting your agent handle customer lookups.
- Get real-time inventory updates across all branches without opening your browser.

## How It Works

The bottom line is you get a conversational interface for your POS data without leaving your chat window.

1. Get your Access Token from the Loyverse Back Office.
2. Connect the Connector to your AI client.
3. Ask questions about your inventory or sales in plain English.

## Frequently Asked Questions

**Can the Loyverse MCP help me track my stock?**
Yes, it pulls live inventory data from your account. You can ask your agent to check the count of any item at specific locations to stay on top of your stock.

**Can I see my sales numbers with Loyverse MCP?**
Yes, you can pull receipts and total sales numbers. This is great for getting a quick summary of how your different branches are performing.

**Does Loyverse MCP work for multiple stores?**
Yes, it can see all store locations in your account. You can ask for reports or stock levels for specific branches or across your entire retail footprint.

**How do I get my data into my AI agent?**
You just need to generate an Access Token from your Loyverse Back Office. Once you have that, you can connect it to your AI client through the Vinkius catalog.

**Can I use Loyverse MCP to manage my customers?**
Yes, it allows your agent to search and list your registered customers. This helps you quickly find contact info or history when helping a shopper.

**Is Loyverse MCP good for small businesses?**
It's perfect for small businesses because it removes the need to constantly log into a complex dashboard. You can get the info you need through a simple chat.

**How do I get my Loyverse API token?**
Log in to your Loyverse Back Office. Navigate to the Integrations section, specifically 'Access Tokens'. Here, you can generate a new personal access token specifically for this AI integration.

**Can I query daily sales reports?**
Yes, you can use the `l_list_receipts` tool to retrieve sales data and individual receipts over any date range, and the AI agent can aggregate these into daily sales reports for you.

**Does the API support checking inventory?**
Absolutely. You can use the `l_list_items` tool to dynamically track item catalog details and stock presence across your system.

**Can I see all my registered customers?**
Yes. The `l_list_customers` tool lets the agent fetch your entire customer database, including their names, registration dates, and generated identifiers.