How to integrate Clover MCP with Atomic Agent

Applies a modifier to an order line item and snapshots the modifier's current name and price as a modification record.

Applies a configured merchant service charge or creates an ad-hoc order-fee line item on an order.

Calculates and previews an order cart, including totals, taxes, discounts, and service charges, without persisting an order.

Adds a postal address to an existing customer record; it does not create the customer.

Records metered app usage and bills the merchant at the configured price; `count` defaults to 1.

Creates an order with line items, modifiers, discounts, and service charges while Clover calculates inventory-based totals and taxes.

Creates an inventory variant attribute within an item group, optionally with its initial options.

Create an authorization for a payment.

Creates a customer record for the connected merchant with the supplied identity and contact details.

Creates a vaulted credit or debit card record for a customer.

Creates a merchant inventory discount with a fixed amount or percentage for later application.

Applies a named fixed-amount or percentage discount to one order line item.

Applies a named fixed-amount or percentage discount to an order subtotal, not a specific line item.

Adds an email address to an existing customer record; it does not create the customer.

Creates a merchant employee profile with a required name and optional login, contact, and role details.

Creates an inventory item.

Creates an inventory category used to organize items in Clover Register.

Creates one or more associations between inventory items and categories or subcategories.

Creates an item group for related inventory variants and their attributes.

Creates an association between an inventory item and a modifier group so the group's modifiers can be applied to that item.

Creates one or more associations between Clover options and inventory items.

Creates the stock quantity and optional low-stock alert threshold for one inventory item.

Creates one or more associations between inventory items and tax rates.

Creates merchant opening hours.

Creates a named modifier with a price adjustment inside a specific modifier group.

Creates a new modifier group.

Creates multiple inventory items in one request; use Update Inventory Items to patch existing items instead.

Send a message to devices that have the connected Clover app installed and are listening for notifications.

Push a message to a device that has the connected Clover app installed and is listening for notifications.

Creates a named option within an inventory attribute, such as `Small` for a `Size` attribute.

Creates one line item for a standard or Multiple Service Charges order; provide `price` or `item.

Creates up to 100 priced line items for either a standard or Multiple Service Charges order.

Creates associations that limit an order type to specific merchant categories.

Creates a custom order type for the merchant, such as dine-in, delivery, or takeout.

Records an externally processed payment on an order for bookkeeping; it does not process a Clover credit or debit payment.

Adds a phone number to an existing customer record; it does not create the customer.

Creates a merchant employee role based on a Clover system role.

Creates a time-clock shift for one employee, including clock-in/out times, cash tips, or override details.

Creates a subcategory within a parent inventory category; it inherits the parent's color when one is set.

Creates an inventory tag for reporting, with optional item and printer associations.

Creates one or more associations between Clover tags and inventory items.

Creates a merchant tax rate as a percentage or flat amount, optionally making it the default or associating items.

Creates a merchant-level custom tender and returns its generated identifier.

Deletes every line item from an order.

Deletes an unbilled app metered event.

Deletes an inventory variant attribute.

Permanently delete a payment authorization.

Permanently deletes the categories identified by a comma-separated list of category IDs.

Deletes a customer from the connected merchant.

Deletes one address from a customer.

Deletes one vaulted card record from a customer.

Deletes one email address from a customer.

Deletes one phone number from a customer.

Deletes an employee from the connected merchant.

Deletes a merchant inventory discount.

Deletes an inventory item.

Deletes an inventory category.

Deletes an inventory item group.

Deletes the stock record for an inventory item.

Removes a discount from an order line item.

Deletes one merchant opening-hours interval.

Deletes one modifier from a modifier group.

Deletes a modifier group and every modifier in it.

Permanently deletes the modifier groups identified by a comma-separated list of IDs, including every modifier in those groups.

Permanently deletes the inventory items identified by a comma-separated list of item IDs.

Deletes an option from an inventory attribute.

Deletes an order.

Removes a discount from an order.

Deletes a line item from an order.

Deletes a merchant order type.

Deletes a merchant employee role.

Deletes one employee shift.

Deletes a subcategory and reassigns its items to the parent category.

Deletes an inventory tag.

Permanently deletes the tags identified by a comma-separated list of tag IDs.

Deletes a merchant tax rate.

Deletes a merchant tender.

Creates a replacement line item under the client-supplied `line_item_id` and exchanges `old_line_item_id` for it.

Exports customers as CSV.

Exports merchant shifts as CSV for a required effective clock-in time window.

Returns one metered billing event recorded for a merchant's app subscription.

Returns one inventory variant attribute with the item-group and option references present in Clover's response.

Retrieve one Clover payment authorization by identifier.

Returns one inventory category, including its Register sort order and optional item expansion.

Returns one service charge configured for the merchant, identified by `service_charge_id`.

Retrieve one Clover credit refund, including its credit, order, device, employee, and transaction details.

Returns one customer profile, with addresses, email addresses, phone numbers, cards, or metadata when expanded.

Returns the merchant's default configured service charge.

Returns one Clover device provisioned to the connected merchant.

Returns one merchant inventory discount, including its fixed amount or percentage.

Returns one merchant employee profile, with assigned roles or related shifts, payments, and orders when expanded.

Returns one inventory item with pricing, availability, SKU, and requested related resources.

Returns one inventory item group and its related variants or attributes when expanded.

Returns the current stock quantity and alert threshold for one inventory item.

Returns an inventory item and, with `expand=categories.

Returns the connected merchant's business profile and requested related resources.

Returns the connected merchant's business address.

Returns a merchant's app-billing status, including the current subscription tier and trial status.

Returns one merchant opening-hours interval by identifier.

Returns the connected merchant's payment-gateway configuration and supported capabilities.

Returns the connected merchant's operational properties and feature settings.

Returns one modifier from a specific modifier group, including its name and price adjustment.

Returns one modifier group and its configuration, with related modifiers or items when expanded.

Returns one option from a specific inventory attribute, including its item references.

Returns one order with totals, state, and any related resources requested through `expand`.

Returns one line item from any order, including age-restriction or Multiple Service Charges fields when Clover provides them.

Returns one merchant order type, including taxability and category-filter settings.

Retrieve one Clover payment, including amount, tax, tip, and result status.

Get a print event for the connected Clover merchant by event ID.

Retrieve one Clover refund, including associated payment, tax, tip, and transaction details.

Returns one merchant employee role and its base system role.

Returns one service-charge line item already applied to an order.

Retrieves one shift by ID.

Returns one inventory tag and its item or printer associations when expanded.

Returns one tax exemption rule that links order types and items to excluded tax rates.

Returns one merchant tax rate, including its rate, type, and default status.

Returns one merchant tender and its payment-handling settings.

Returns one merchant tip suggestion, including its percentage or flat amount.

Returns deleted line-item and order totals for a required caller-supplied deletedTime window.

Lists billing events recorded for one app metered-event type, such as `reservation`.

Lists inventory variant attributes, such as size or color.

List payment authorizations for the connected merchant.

List cash events for the merchant, one device, or one employee.

Lists inventory categories in Register sort order, optionally with associated items.

Retrieves all categories of an item.

Returns a category with its subcategories expanded by default; use `subCategories.

Lists service charges configured for the merchant; use the applied-service-charge tools for charges already attached to an order.

List credit refunds for the connected merchant, including associated tax and transaction details.

Lists customer records for the connected merchant, optionally filtered or expanded with related contact data.

Lists Clover devices provisioned to the connected merchant, optionally filtered by documented device fields.

Lists the merchant's inventory discounts.

Lists discounts currently applied at the order level; line-item discounts are returned by the line-item tools.

Lists one employee's orders through Clover's exact `/employees/{empId}/orders` route, which requires `Read employees`, while preserving a caller-supplied custom `filter`.

List employees for the connected Clover merchant, optionally filtered or expanded.

Lists inventory items for the connected merchant.

Lists inventory items that have no revenue-class tag.

Lists item groups used to organize related inventory variants and attributes.

Lists inventory items associated with the specified tax rate.

Lists inventory items associated with one tag.

Retrieves all items in a category.

Retrieves a list of all items in a single modifier group.

Lists stock quantities and alert thresholds for the merchant's inventory items.

Lists inventory tags associated with one item.

Lists the connected merchant's opening-hours intervals.

Lists modifier groups that organize selectable item modifiers.

Retrieves all modifiers from all modifier groups.

Retrieves a list of modifiers in a single modifier group.

Lists options across all inventory variant attributes.

Retrieves all available variants or options associated with an attribute.

Lists line items from any order, including age-restriction or Multiple Service Charges fields when Clover provides them.

Lists orders through Clover's merchant `/orders` route, which requires `Read orders`, with filtering, expansion, and offset pagination.

Lists merchant-defined order types and their system-type or category settings.

List payments for the merchant, one order, or one employee.

List merchant refunds, including taxes and tips.

Retrieves all system and employee roles for a merchant's business.

Lists service-charge line items already applied to an order; use configured-service-charge tools for merchant templates.

List shifts for the connected merchant or, when `employee_id` is provided, for one employee.

Lists Clover's system order-type categories used to classify merchant-defined order types, such as takeout.

Lists every association between the merchant's inventory tags and items.

Lists the merchant's inventory tags.

Lists tax exemption rules that link order types and items to tax rates excluded from those items.

Lists percentage and flat-amount tax rates.

Retrieves all tenders for a merchant.

Retrieves all tip suggestions for a merchant, for example: flat tip or percentage.

Records voided line items on an order for reporting, including their quantities and reasons.

Permanently removes specific item-category associations or all associations on one supplied side.

Permanently removes a specific item-modifier-group association or all associations on one supplied side.

Permanently removes specific option-item associations or all associations on one supplied side.

Permanently removes specific item-tax-rate associations or all associations on one supplied side.

Removes an applied modifier snapshot from an order line item.

Permanently removes a configured service charge or order-fee line item from an order.

Permanently removes specific tag-item associations or all associations on one supplied side.

Queues content for the merchant's default order printer.

Updates one postal address on an existing customer record.

Updates an inventory variant attribute, including its name, item group, or option references.

Update a payment authorization.

Updates an inventory category's name, Register sort order, color, or item associations.

Updates Register menu sort positions for up to 1,000 inventory categories in one request.

Updates one customer's identity, contact, marketing, or metadata fields using the supplied values.

Updates a customer's vaulted credit or debit card record.

Updates a merchant inventory discount's name, fixed amount, percentage, or approval reference.

Updates one email address on an existing customer record.

Updates one employee's name, login, contact, or role details using the supplied fields.

Updates one inventory item's supplied fields.

Patches multiple existing inventory items in one request without replacing omitted fields; use Create Multiple Inventory Items for new records.

Updates an inventory item group's name, member items, or variant attributes.

Updates the stock quantity or low-stock alert threshold for one inventory item.

Updates the connected merchant's business profile using the supplied fields.

Updates one merchant opening-hours interval, including its day and start or end time.

Updates the connected merchant's operational properties and feature settings.

Updates a modifier's name, price adjustment, or availability; Clover does not allow moving it to another modifier group.

Updates a modifier group's name, selection rules, or item references.

Update the priorities for a collection of up to 200 modifier groups at a time.

Updates a named option within a specific inventory attribute, including its item associations.

Updates one order using the supplied order fields; omitted fields remain unchanged.

Updates one line item on either a standard or Multiple Service Charges order using the supplied fields.

Updates a merchant order type's label, taxability, system classification, or category settings.

Update payment line-item allocations or the employee on an uncaptured preauthorization.

Updates one phone number on an existing customer record.

Updates a merchant employee role's name, base system role, or employee references.

Updates one employee shift's clock-in/out times, cash tips, or override details.

Updates a subcategory's name or color within its parent inventory category.

Updates an inventory tag's name, reporting behavior, or item and printer associations.

Updates a merchant tax rate's name, rate, type, or default status.

Updates a merchant tender's label, availability, cash-drawer, tipping, or processing settings.

Updates a merchant tip suggestion's name, percentage, flat amount, or enabled status.

Creates or updates a customer's note, birthday, and business-name metadata.

Creates or updates a custom order for merchants with or without Multiple Service Charges.