Connector guide10-minute read50 MCP tools7 languages

How to Connect Clover to Claude via MCP

Clover point of sale (Fiserv) for one merchant: business details and settings, inventory items with stock, categories, tax rates, discounts and modifiers, orders with line items, payments, refunds and tenders, customers, employees and shifts. It creates and updates items, stock, categories, orders and customers. North America, Europe, Latin America or sandbox.

HCBy HelpCode teamUpdated 10 min read Open-source on GitHub

No credit card Β· 7-day trial Β· Self-host alternative available

Clover

Clover

Clover point of sale (Fiserv): merchant details and settings, inventory items with stock, categories, tax rates, discounts and modifiers, orders with line items, payments, refunds and tenders, customers, employees, roles and shifts. North America, Europe, Latin America or sandbox.

tools

50

Region

INTL

Category

Payments

Authentication

Bearer Token

Required env vars

CLOVER_API_TOKENCLOVER_MERCHANT_IDCLOVER_API_URL
Install in one click on Cloud

7-day free trial Β· No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source Β· AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Skip the install. Get this working in under 2 minutes.

Start a free trial on cloud.anythingmcp.com, add the Clover in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.

Start free trial

AnythingMCP is listed in Claude's connector directory: add it to Claude in one click (opens in a new tab), then sign in and choose which MCP servers Claude may use.

Summary

Clover point of sale (Fiserv) for one merchant: business details and settings, inventory items with stock, categories, tax rates, discounts and modifiers, orders with line items, payments, refunds and tenders, customers, employees and shifts. It creates and updates items, stock, categories, orders and customers. North America, Europe, Latin America or sandbox.

Try asking

Example prompts for Clover

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Clover Β· live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

πŸ’‘ No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors β†’ Clover, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Clover + Claude

Clover point of sale (Fiserv) for one merchant: business details and settings, inventory items with stock, categories, tax rates, discounts and modifiers, orders with line items, payments, refunds and tenders, customers, employees and shifts. It creates and updates items, stock, categories, orders and customers. North America, Europe, Latin America or sandbox.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

CLOVER_API_TOKEN, CLOVER_MERCHANT_ID, CLOVER_API_URL

Step 1 β€” Get credentials

Setting up takes about 5 minutes. You need a Clover merchant account (or a test merchant) and an admin user who can create API tokens.

  1. Sign in to the Clover Merchant Dashboard as an admin and open Settings, View all settings, API tokens (under Account and setup, Business operations). Create a token and tick the permissions the tools need: Merchant read, Inventory read and write, Orders read and write, Payments read, Customers read and write, Employees read. For a test merchant, do the same from the Global Developer Dashboard (Test merchants, Launch dashboard).
  2. Paste the token into CLOVER_API_TOKEN. It is sent as Authorization: Bearer <token>.
  3. Set CLOVER_MERCHANT_ID to the 13-character merchant id (mId). It is in the dashboard address .../merchants/<mId>/... and under Account and setup, Merchants.
  4. Set CLOVER_API_URL to the region of the merchant: https://api.clover.com (North America), https://api.eu.clover.com (Europe), https://api.la.clover.com (Latin America) or https://apisandbox.dev.clover.com (sandbox).
  5. Install the connector and run clover_get_merchant: it shows the business name and confirms the token.

What it reads: the merchant with clover_get_merchant, clover_get_merchant_address and clover_get_merchant_properties (currency, time zone, locale, tips and tax settings), order types and employee roles; inventory items with clover_list_items and clover_get_item (price, price type, SKU, code, cost; expand categories, tax rates, modifier groups or stock), stock with clover_list_item_stocks and clover_get_item_stock, categories with clover_list_categories, clover_get_category and clover_list_category_items, plus tax rates, predefined discounts and modifier groups; orders with clover_list_orders and clover_get_order (expand lineItems and payments), their line items and order discounts; payments with clover_list_payments, clover_get_payment, clover_list_order_payments and clover_list_employee_payments (handy for tips and sales per employee), refunds with clover_list_refunds and clover_get_refund, tenders with clover_list_tenders and clover_get_tender; customers with clover_list_customers and clover_get_customer (expand emailAddresses, phoneNumbers and addresses); employees with clover_list_employees and clover_get_employee, and clock-in shifts with clover_list_shifts and clover_list_employee_shifts.

What it writes: items with clover_create_item and clover_update_item; stock with clover_update_item_stock, which sets an absolute quantity, not a difference, so the AI reads the current stock first; categories with clover_create_category and clover_update_category; customers with clover_create_customer and clover_update_customer. Orders in one call: clover_calculate_order returns totals, taxes, discounts and service charges without saving, then clover_create_atomic_order creates the same cart. Step by step: clover_create_order, clover_add_line_item, clover_add_order_discount and clover_update_order. Clover updates a record with a POST to its address. Orders and stock changes show up on the merchant's devices and in the reports at once, so the AI shows you what it will change and waits for your yes.

Switched off at install: clover_void_line_item, clover_delete_order and clover_delete_customer. They cannot be undone, so a workspace admin switches them on when the team needs them.

Filters: filter takes a list of conditions, each field operator value, for example ["createdTime>=1767225600000", "createdTime<1767830400000"]; they are combined with AND. Time filters on orders, payments and refunds cover at most 90 days per request, so the AI splits longer periods into 90-day windows. expand adds related records in the same call (comma-separated).

Data formats: lists come as {elements: [...], href}. Money is an integer in cents of the merchant currency (1999 = 19.99); discounts are negative amounts. Line item quantities (unitQty) are multiplied by 1000. Tax rates are multiplied by 100000 (825000 = 8.25%). Times are Unix epoch milliseconds in UTC; the AI converts them with the time zone from clover_get_merchant_properties. Ids are 13-character strings.

Paging: limit (100 by default, at most 1000) and offset. When a page holds limit elements, the AI asks again with offset plus limit. Nested expanded lists stop at 100 entries.

Limits and common errors: 16 requests per second and 5 concurrent requests per token; above that Clover answers 429 with retry-after. 401 means a wrong or revoked token or the wrong region in CLOVER_API_URL (a sandbox token only works on apisandbox.dev.clover.com). 403 means the token lacks the permission for that data: edit the token in the Merchant Dashboard and tick it. 404 means a wrong merchant id or record id. 400 usually means an invalid filter field.

The connector does not take card payments or issue refunds: those happen on the Clover device or through the Clover Ecommerce API. It reads tax rates, discounts, modifier groups, employees and shifts but does not change them, and with the tools on at install it deletes nothing.

Step 2 β€” Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 β€” Add the connector in Claude

Your server URL: in AnythingMCP, open MCP Servers β†’ the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Recommended path: works on claude.ai web without editing any config file.

  1. In Claude, open Customize β†’ Connectors.
  2. Click +, then Add custom connector.
  3. Enter a name, e.g. Clover, and the remote MCP server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, then click Add.
  4. Click Connect and sign in to AnythingMCP (OAuth) to allow access.

All tools below appear in your chat: start typing prompts.

Available tools

ToolWhat it does
clover_get_merchantGet the merchant behind the token: business name, address, phone, website, owner and default currency
clover_get_merchant_addressGet the business address of the merchant: street lines, city, state, zip and country, as stored in Clover
clover_get_merchant_propertiesGet merchant settings: default currency, time zone, locale, tips and tax settings, receipt and order options
clover_list_order_typesList order types of the merchant (dine in, take out, delivery and custom ones) with label, taxable flag, fee and hours
clover_list_rolesList the employee roles of the merchant (admin, manager, employee and custom roles) with their system role and employees
clover_list_itemsList inventory items with name, price, price type, SKU, code, cost, stock tracking and visibility
clover_get_itemGet one inventory item by id with price, price type, SKU, code, cost and, when expanded, categories, tax rates, modifier groups and stock
clover_create_itemCreate an inventory item. price is in cents (1999 = 19.99) and required; priceType FIXED, VARIABLE (entered at sale) or PER_UNIT
clover_update_itemUpdate an inventory item (Clover updates with POST): name, price in cents, SKU, code, cost, visibility or categories
clover_list_item_stocksList the stock of all inventory items: item id, quantity on hand (decimal) and the low-stock alert threshold
clover_get_item_stockGet the stock of one inventory item: quantity on hand, stock alert threshold and when it last changed
clover_update_item_stockSet the stock of an inventory item to a new absolute quantity (not a change)
clover_list_categoriesList item categories with name, sort order and colour; expand items to get the items in each category
clover_get_categoryGet one item category by id with name, sort order and colour; expand items to list its items
clover_list_category_itemsList the items in one category with price, SKU and, when expanded, stock, tax rates and modifier groups
clover_create_categoryCreate an item category shown on the register, with a name, sort order and colour
clover_update_categoryRename a category or change its sort order or colour (Clover updates with POST). name is required by the API
clover_list_tax_ratesList tax rates with name, rate (in units of 1/100000, so 825000 = 8.25%), flat amount, type and whether it is the default
clover_list_discountsList the predefined discounts of the merchant: name, amount in cents (negative) or percentage
clover_list_modifier_groupsList modifier groups (e.g
clover_list_ordersList orders with state, total in cents, payment state, employee, order type and times
clover_get_orderGet one order by id with total, state, payment state and, when expanded, line items, discounts, payments, refunds and customers
clover_create_atomic_orderCreate a complete order in one call from an order cart: line items (inventory items or ad hoc), modifiers, discounts and service charge…
clover_calculate_orderCalculate an order cart without saving it: totals, taxes, discounts and service charges for the same cart as clover_create_atomic_order
clover_create_orderCreate an empty custom order (title, note, state, order type), then add lines with clover_add_line_item
clover_update_orderUpdate an order (Clover updates with POST): title, note, state, order type or tax removal
clover_list_order_line_itemsList the line items of an order with name, price in cents, quantity, discounts, modifications and refund state
clover_get_order_line_itemGet one line item of an order with name, price in cents, unit quantity, note, discounts and modifications
clover_add_line_itemAdd a line item to an order: an inventory item by id, or an ad hoc line with name and price in cents. unitQty is quantity x 1000 for…
clover_void_line_itemRemove (void) a line item from an order
clover_list_order_discountsList the order-level discounts applied to an order with name, amount in cents or percentage and approver
clover_add_order_discountApply a discount to a whole order: a name plus an amount in cents (negative, e.g. -500) or a percentage, or a predefined discount by id
clover_delete_orderDelete an order
clover_list_paymentsList payments with amount, tip and tax in cents, result (SUCCESS, FAIL and so on), tender, card type, order and employee
clover_get_paymentGet one payment by id with amount, tip, tax, cash back in cents, result, tender, card transaction details and refunds
clover_list_order_paymentsList the payments made on one order with amount, tip and tax in cents, result, tender and card details
clover_list_employee_paymentsList the payments taken by one employee, with amount, tip and tax in cents, result and tender
clover_list_refundsList refunds with amount and tax in cents, the payment and order they belong to, employee and time
clover_get_refundGet one refund by id with amount, tax and tip in cents, the refunded payment, line items and employee
clover_list_tendersList tenders (payment methods such as cash, credit card, debit card, check, gift card, external) with label, label key and whether enabled
clover_get_tenderGet one tender (payment method) by id with label, label key, instructions and whether it opens the cash drawer
clover_list_customersList customers with name, customer since and marketing consent; expand emailAddresses, phoneNumbers and addresses for contact data
clover_get_customerGet one customer by id with name, customer since, marketing consent and, when expanded, emails, phone numbers, addresses and notes
clover_create_customerCreate a customer with name, email addresses, phone numbers, addresses and marketing consent
clover_update_customerUpdate a customer (Clover updates with POST): name, marketing consent or metadata such as business name and note
clover_delete_customerDelete a customer with their contact data
clover_list_employeesList employees with name, nickname, email, role, PIN-protected flags and custom id; expand roles or shifts
clover_get_employeeGet one employee by id with name, nickname, email, role and, when expanded, roles and shifts
clover_list_shiftsList clock-in and clock-out shifts of all employees with in time, out time and overrides
clover_list_employee_shiftsList the clock-in and clock-out shifts of one employee with in time, out time and overrides, newest first

Example prompts

  • "What were our total sales and tips yesterday, split by tender? Use our merchant time zone."
  • "Which items with stock tracking have fewer than 10 left? Show name, SKU and quantity."
  • "Change the price of the item Cappuccino to 4.20. Show me the old and the new price before saving."
  • "Calculate an order with 2 Margherita pizzas and 1 lemonade with our staff discount, show me the total and then create it."
  • "List the refunds of the last 30 days with amount, the original order and the employee."

FAQ

Does it work with Claude Code as well as Claude Desktop? Yes, point both at https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Next steps

Was this guide helpful?

Your Clover agent is one click away.

Install the connector, paste the key, prompt Claude. Free for 7 days, no credit card.

Related guides

Connectors

Clover to MCP: Orders, Payments, Inventory, Stock and Customers in any AI Agent

Clover point of sale (Fiserv) for one merchant: business details and settings, inventory items with stock, categories, tax rates, discounts and modifiers, orders with line items, payments, refunds and tenders, customers, employees and shifts. It creates and updates items, stock, categories, orders and customers. North America, Europe, Latin America or sandbox.

Connectors

How to Connect Clover to ChatGPT via MCP

Clover point of sale (Fiserv) for one merchant: business details and settings, inventory items with stock, categories, tax rates, discounts and modifiers, orders with line items, payments, refunds and tenders, customers, employees and shifts. It creates and updates items, stock, categories, orders and customers. North America, Europe, Latin America or sandbox.

Connectors

How to Connect Clover to Cursor via MCP

Clover point of sale (Fiserv) for one merchant: business details and settings, inventory items with stock, categories, tax rates, discounts and modifiers, orders with line items, payments, refunds and tenders, customers, employees and shifts. It creates and updates items, stock, categories, orders and customers. North America, Europe, Latin America or sandbox.

Connectors

How to Connect Clover to Gemini via MCP

Clover point of sale (Fiserv) for one merchant: business details and settings, inventory items with stock, categories, tax rates, discounts and modifiers, orders with line items, payments, refunds and tenders, customers, employees and shifts. It creates and updates items, stock, categories, orders and customers. North America, Europe, Latin America or sandbox.

Connectors

How to Connect Clover to Meta Muse via MCP

Clover point of sale (Fiserv) for one merchant: business details and settings, inventory items with stock, categories, tax rates, discounts and modifiers, orders with line items, payments, refunds and tenders, customers, employees and shifts. It creates and updates items, stock, categories, orders and customers. North America, Europe, Latin America or sandbox.

Connectors

How to Connect Clover to Microsoft Copilot via MCP

Clover point of sale (Fiserv) for one merchant: business details and settings, inventory items with stock, categories, tax rates, discounts and modifiers, orders with line items, payments, refunds and tenders, customers, employees and shifts. It creates and updates items, stock, categories, orders and customers. North America, Europe, Latin America or sandbox.