# Clover POS MCP for AI Agents MCP

> Clover POS connects your AI agent directly to Clover's entire suite of merchant services. You can monitor live business operations—from checking daily orders and managing current inventory levels to auditing customer profiles and processing payment history—all through natural conversation with your preferred AI client.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** pos-system, order-tracking, merchant-services, inventory-control, customer-data, api-integration

## Description

This MCP lets your AI agent talk shop, giving you real-time visibility into everything happening at your physical store. Forget jumping between different browser tabs or logging into the main Clover dashboard just to check a few numbers. Your agent handles all that for you.

Need to know if you're out of organic coffee? Just ask. Want to see which employees worked on an order last week? It’ll pull that data. You can track down customer transaction histories or review the latest processed payments and tax rates without lifting a finger. Because this MCP is hosted on Vinkius, you gain access not just to Clover, but to thousands of other services too. Managing your entire store's backend—orders, inventory, customers, staff—gets simplified into natural conversation.

## Tools

### get_merchant_info
Pulls basic business information, including the merchant's physical address and currency details.

### get_order_details
Retrieves all detailed information for one specific customer order.

### list_inventory_categories
Generates a list of all high-level categories used to organize the store's inventory.

### list_customers
Fetches a complete roster of customers linked to the merchant account.

### list_device_access_tokens
Lists all active access tokens associated with different hardware devices at the store.

### list_employees
Retrieves a list of employees and their assigned roles within the system.

### list_inventory_items
Provides a comprehensive listing of every stocked item, including quantity available.

### list_orders
Retrieves a list summarizing all orders placed at the merchant location.

### list_payments
Gets a summary of recently processed payments and their status.

### list_tax_rates
Retrieves all configured sales tax rates for the merchant location.

## Prompt Examples

**Prompt:** 
```
Can you give me a summary of all orders placed yesterday?
```

**Response:** 
```
**Order Summary: Yesterday (2024-10-27)**

*   **Total Orders:** 18
*   **Total Value Processed:** $3,150.00
*   **Status Breakdown:**
    *   Paid: 16
    *   Open/Pending: 2

[Detailed Order List Snippet]
- #ORD-987 (Items: Coffee Blend, Pastry Box) - Status: Paid | Total: $55.00
- #ORD-988 (Item: Green Tea only) - Status: Open | Total: $12.00
```

**Prompt:** 
```
What's the status of our staff and what was the highest paid order?
```

**Response:** 
```
**Staffing Report:**
*   John Doe (Manager): Active since 2023-01-15.
*   Jane Smith (Associate): Active since 2024-06-01. (Role: Cashier)
**Top Order Details:** The highest value order was #ORD-722, totaling $98.50. It was placed by customer 'Michael B.' and included the premium espresso blend.
```

**Prompt:** 
```
Check out our current stock levels for all pastry items.
```

**Response:** 
```
**Inventory Report: Pastry Items**

| Item Name | Category | Stock Level | Unit Price |
| :--- | :--- | :--- | :--- |
| Croissant Pack | Pastries | 45 units | $12.00 |
| Seasonal Tart | Pastries | 18 units | $25.00 |
| Muffin Mix | Pastries | 72 units | $5.00 |

*Tip: Consider reordering the Seasonal Tart soon, as stock is getting low.*
```

## Capabilities

### Retrieve basic merchant details
Get basic setup information for the merchant, including currency details and physical address data.

### List all current store orders
Retrieve a full list of recent orders processed through the system.

### Check live inventory levels
View all items available in stock, organized by their established categories.

### Lookup customer records and history
Pull up specific customer profiles and a complete record of their previous transactions.

### Audit payments and tax rates
Review lists of processed payments or check the configured sales tax rates for your business.

### Manage staff records
Retrieve a list of employees and their assigned roles within the system.

## Use Cases

### Running a quick end-of-day reconciliation
An accountant asks their agent, 'Show me the payments and tax rates for yesterday.' The agent runs list_payments and list_tax_rates, giving them two reports instantly to close books.

### Investigating a missing item sale
A store manager asks the agent about a specific order ID. The system uses get_order_details and can cross-reference it with list_inventory_items to see if the product was recorded as sold.

### Onboarding a new employee
A manager asks, 'Who are our staff members?' The agent runs list_employees, providing names and current roles without needing physical access to the payroll system.

### Checking inventory before restocking
The owner needs a quick count. They ask to see all items (list_inventory_items) categorized by their groups (list_inventory_categories) in seconds, without running a full report.

## Benefits

- Quickly check current stock levels or review the details of a specific order using list_order_details. No need to navigate multiple menus.
- Stop manually compiling reports. Your agent can pull payment histories (list_payments) and tax rates (list_tax_rates) in one request, saving hours of spreadsheet work.
- Operational staff get immediate access to employee lists via list_employees, making shift management and task assignment much faster than checking the dashboard.
- Need to know if a customer is new or returning? Use list_customers to pull up their profile and transaction history instantly.
- Inventory control gets simple. Listing all items (list_inventory_items) combined with listing categories gives you an immediate view of what needs restocking.

## How It Works

The bottom line is that you manage complex store operations by simply having a conversation with your AI client.

1. Subscribe to this MCP on Vinkius and input your Clover Access Token along with your Merchant ID (mId).
2. Your AI client establishes a secure connection, allowing it access to the core business data.
3. You start talking naturally to your agent. For example: 'List all open orders from yesterday.' The agent runs the query and delivers actionable data.

## Frequently Asked Questions

**How does Clover POS MCP help me track my daily sales and inventory?**
It gives your agent real-time access to all your transaction data. You can ask for a list of orders, or check specific item counts (list_inventory_items), without ever leaving your chat window. This keeps your operational checks fast and efficient.

**Can I use Clover POS MCP to audit my tax rates?**
Yes, you can retrieve all configured sales tax rates using list_tax_rates. This is crucial for accounting, letting you quickly verify that the correct taxes are applied to every transaction type.

**Is Clover POS MCP better than manually checking my online dashboard?**
Absolutely. Instead of logging into a separate platform and clicking through menus, your agent pulls all this information—from customer names (list_customers) to payment details (list_payments)—and delivers it right here in plain text.

**Does Clover POS MCP show me employee schedules or roles?**
It can pull up a list of employees and their assigned roles using list_employees. This is great for managers needing to know who was working on shift when certain sales occurred.

**What if I need to find details about a specific order? Is it possible with Clover POS MCP?**
Yes, you can ask the agent to get_order_details for any given order ID. It pulls up everything: items sold, who bought it, and when it was paid for.