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.
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.
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 + Microsoft Copilot
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.
- 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).
- Paste the token into
CLOVER_API_TOKEN. It is sent asAuthorization: Bearer <token>. - Set
CLOVER_MERCHANT_IDto the 13-character merchant id (mId). It is in the dashboard address.../merchants/<mId>/...and under Account and setup, Merchants. - Set
CLOVER_API_URLto the region of the merchant:https://api.clover.com(North America),https://api.eu.clover.com(Europe),https://api.la.clover.com(Latin America) orhttps://apisandbox.dev.clover.com(sandbox). - 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 Microsoft Copilot
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 showsYOUR_SERVER_ID.
Microsoft Copilot uses MCP servers through agents built in Copilot Studio: you add AnythingMCP to an agent as a tool, then publish the agent to Microsoft 365 Copilot and Teams. Copilot Studio connects from Microsoft's cloud over Streamable HTTP, which AnythingMCP supports.
- In Copilot Studio, open your agent (or create one), go to Tools and choose Add a tool → New tool → Model Context Protocol.
- Enter a Server name (for example
AnythingMCP), a Server description that says what the connector does, and the Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio uses the description to decide when to call the server. - Under authentication, choose API key, set Type to Header and the header name to
X-API-Key, then select Create. - In Add tool, choose Create a new connection, paste an MCP API key from AnythingMCP (MCP Servers → your server → API keys) and select Add to agent.
- Try it in the agent's Test pane: ask for something that needs the
Clovertools. - Select Publish, then Channels → Microsoft 365 and Microsoft Teams, keep Make agent available in Microsoft Copilot selected and choose Add channel. See agent in Teams installs it for you; in Microsoft 365 Copilot, type @ and pick the agent.
Prefer per-user sign-in? Choose OAuth 2.0 → Dynamic discovery instead of an API key: each user then signs in to AnythingMCP the first time the agent calls it.
Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Copilot Studio connects from Microsoft's cloud, so localhost does not work.
Available tools
| Tool | What it does |
|---|---|
clover_get_merchant | Get the merchant behind the token: business name, address, phone, website, owner and default currency |
clover_get_merchant_address | Get the business address of the merchant: street lines, city, state, zip and country, as stored in Clover |
clover_get_merchant_properties | Get merchant settings: default currency, time zone, locale, tips and tax settings, receipt and order options |
clover_list_order_types | List order types of the merchant (dine in, take out, delivery and custom ones) with label, taxable flag, fee and hours |
clover_list_roles | List the employee roles of the merchant (admin, manager, employee and custom roles) with their system role and employees |
clover_list_items | List inventory items with name, price, price type, SKU, code, cost, stock tracking and visibility |
clover_get_item | Get one inventory item by id with price, price type, SKU, code, cost and, when expanded, categories, tax rates, modifier groups and stock |
clover_create_item | Create an inventory item. price is in cents (1999 = 19.99) and required; priceType FIXED, VARIABLE (entered at sale) or PER_UNIT |
clover_update_item | Update an inventory item (Clover updates with POST): name, price in cents, SKU, code, cost, visibility or categories |
clover_list_item_stocks | List the stock of all inventory items: item id, quantity on hand (decimal) and the low-stock alert threshold |
clover_get_item_stock | Get the stock of one inventory item: quantity on hand, stock alert threshold and when it last changed |
clover_update_item_stock | Set the stock of an inventory item to a new absolute quantity (not a change) |
clover_list_categories | List item categories with name, sort order and colour; expand items to get the items in each category |
clover_get_category | Get one item category by id with name, sort order and colour; expand items to list its items |
clover_list_category_items | List the items in one category with price, SKU and, when expanded, stock, tax rates and modifier groups |
clover_create_category | Create an item category shown on the register, with a name, sort order and colour |
clover_update_category | Rename a category or change its sort order or colour (Clover updates with POST). name is required by the API |
clover_list_tax_rates | List 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_discounts | List the predefined discounts of the merchant: name, amount in cents (negative) or percentage |
clover_list_modifier_groups | List modifier groups (e.g |
clover_list_orders | List orders with state, total in cents, payment state, employee, order type and times |
clover_get_order | Get one order by id with total, state, payment state and, when expanded, line items, discounts, payments, refunds and customers |
clover_create_atomic_order | Create a complete order in one call from an order cart: line items (inventory items or ad hoc), modifiers, discounts and service charge… |
clover_calculate_order | Calculate an order cart without saving it: totals, taxes, discounts and service charges for the same cart as clover_create_atomic_order |
clover_create_order | Create an empty custom order (title, note, state, order type), then add lines with clover_add_line_item |
clover_update_order | Update an order (Clover updates with POST): title, note, state, order type or tax removal |
clover_list_order_line_items | List the line items of an order with name, price in cents, quantity, discounts, modifications and refund state |
clover_get_order_line_item | Get one line item of an order with name, price in cents, unit quantity, note, discounts and modifications |
clover_add_line_item | Add 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_item | Remove (void) a line item from an order |
clover_list_order_discounts | List the order-level discounts applied to an order with name, amount in cents or percentage and approver |
clover_add_order_discount | Apply 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_order | Delete an order |
clover_list_payments | List payments with amount, tip and tax in cents, result (SUCCESS, FAIL and so on), tender, card type, order and employee |
clover_get_payment | Get one payment by id with amount, tip, tax, cash back in cents, result, tender, card transaction details and refunds |
clover_list_order_payments | List the payments made on one order with amount, tip and tax in cents, result, tender and card details |
clover_list_employee_payments | List the payments taken by one employee, with amount, tip and tax in cents, result and tender |
clover_list_refunds | List refunds with amount and tax in cents, the payment and order they belong to, employee and time |
clover_get_refund | Get one refund by id with amount, tax and tip in cents, the refunded payment, line items and employee |
clover_list_tenders | List tenders (payment methods such as cash, credit card, debit card, check, gift card, external) with label, label key and whether enabled |
clover_get_tender | Get one tender (payment method) by id with label, label key, instructions and whether it opens the cash drawer |
clover_list_customers | List customers with name, customer since and marketing consent; expand emailAddresses, phoneNumbers and addresses for contact data |
clover_get_customer | Get one customer by id with name, customer since, marketing consent and, when expanded, emails, phone numbers, addresses and notes |
clover_create_customer | Create a customer with name, email addresses, phone numbers, addresses and marketing consent |
clover_update_customer | Update a customer (Clover updates with POST): name, marketing consent or metadata such as business name and note |
clover_delete_customer | Delete a customer with their contact data |
clover_list_employees | List employees with name, nickname, email, role, PIN-protected flags and custom id; expand roles or shifts |
clover_get_employee | Get one employee by id with name, nickname, email, role and, when expanded, roles and shifts |
clover_list_shifts | List clock-in and clock-out shifts of all employees with in time, out time and overrides |
clover_list_employee_shifts | List 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
Which Copilot is this for? Microsoft 365 Copilot at work, through agents built in Copilot Studio. The Microsoft Copilot app for personal accounts has no option to add your own MCP server.
What do I need? A work account with access to Copilot Studio (a license or a trial) to build the agent. People who use it in Microsoft 365 Copilot or Teams need access to the agent: share it with them, or ask an admin to publish it to the organization. If your organization applies data policies to Power Platform connectors, they cover MCP servers too.
The agent doesn't call the tools. Check that the header name is exactly X-API-Key and that the key belongs to the same MCP server as the URL, and make the server description specific: Copilot Studio uses it to decide when to call the server. Publish the agent again after each change; in an open chat, type "start over" to get the new version.
Next steps
- Connector landing page
- Connect to Claude
- Connect to ChatGPT
- Connect to Cursor
- Connect to Gemini
- Connect to Meta Muse
Was this guide helpful?