Square MCP server for your AI

Returns a paginated list of Timecard records for a business.

Returns a single CatalogItem as a CatalogObject based on the provided ID.

Searches for catalog items or item variations by matching supported search attribute values, including custom attribute values, against one or more of the specified query filters.

Creates a new or updates the specified CatalogObject.

Returns current counts for the provided CatalogObjects at the requested Locations.

Creates a booking.

Retrieve a collection of bookings.

Searches for availabilities for booking.

Creates a new customer for a business.

Returns details for a single customer.

Lists customer profiles associated with a Square account.

Returns a paginated list of TeamMember objects for a business.

Updates a customer profile.

Retrieves an invoice by invoice ID.

Returns a list of invoices for a given location.

Creates a Square-hosted checkout page.

Returns a list of disputes associated with a particular account.

Retrieves an Order by ID.

Search all orders for one or more locations.

Creates a payment using the provided source.

Retrieves details for a specific payment.

Retrieves a list of payments taken by the account making the request.

Bill a customer in one call: finds the customer by email (creating them when new) or takes customer_id, creates the order from line items given in normal money (25.50, not cents), creates the invoice due on due_date (default 7 days from today) and, unless send is false, publishes it so Square emails it.

Find customers by name, email or phone in one call.

Sales totals for a period, ready to report: completed payments per currency with sales, tips, the total collected, refunds, Square's fees and net, broken down by day (default), location or payment type, across every active location.

Set the counted stock of one item variation at a location (a physical count, as after a stock take): give variation_id or sku, the quantity on hand, and location_id unless the business has one location.

Stock on hand per item variation and location in one call: finds items (by text in the name, description or SKU, or every item), then reads their IN_STOCK counts.

Change the price of one item variation, keeping everything else about the item: give variation_id or sku and the new price in normal money ("12.50", not cents).

Provides details about all of the seller's locations, including those with an inactive status.

Retrieves a list of all payouts for the default location.

Retrieves a list of refunds for the account making the request.

Refunds a payment.

Publishes 1 - 100 scheduled shifts.

Creates a new BreakType.

Creates a scheduled shift by providing draft shift details such as job ID, team member assignment, and start and end times.

Creates a new Timecard.

Deletes an existing BreakType.

Deletes a Timecard.

Returns a single BreakType specified by id.

Retrieves a scheduled shift by ID.

Returns a single TeamMemberWage specified by id.

Returns a single Timecard specified by id.

Returns a paginated list of BreakType instances for a business.

Returns a paginated list of TeamMemberWage instances for a business.

Returns a list of WorkweekConfig instances for a business.

Publishes a scheduled shift.

Returns a paginated list of scheduled shifts, with optional filter and sort settings.

Updates an existing BreakType.

Updates the draft shift details for a scheduled shift.

Updates an existing Timecard.

Updates a WorkweekConfig.

Adds points earned from a purchase to a loyalty account.

Adds points to or subtracts points from a buyer's account.

Calculates the number of points a buyer can earn from a purchase.

Cancels a loyalty promotion.

Creates a loyalty account.

Creates a loyalty promotion for a loyalty program.

Creates a loyalty reward.

Deletes a loyalty reward by doing the following: - Returns the loyalty points back to the loyalty account.

Retrieves a loyalty account.

Retrieves the loyalty program in a seller's account, specified by the program ID or the keyword main.

Retrieves a loyalty promotion.

Retrieves a loyalty reward.

Lists the loyalty promotions associated with a loyalty program.

Redeems a loyalty reward.

Searches for loyalty accounts in a loyalty program.

Searches for loyalty events.

Searches for loyalty rewards.

Cancels a Terminal action request if the status of the request permits it.

Cancels a Terminal checkout request if the status of the request permits it.

Cancels an Interac Terminal refund request by refund request ID if the status of the request permits it.

Creates a Terminal action request and sends it to the specified device.

Creates a Terminal checkout request and sends it to the specified device to take a payment for the requested amount.

Creates a request to refund an Interac payment completed on a Square Terminal.

Dismisses a Terminal action request if the status and type of the request permits it.

Dismisses a Terminal checkout request if the status and type of the request permits it.

Dismisses a Terminal refund request if the status and type of the request permits it.

Retrieves a Terminal action request by action_id.

Retrieves a Terminal checkout request by checkout_id.

Retrieves an Interac Terminal refund object by ID.

Retrieves a filtered list of Terminal action requests created by the account making the request.

Returns a filtered list of Terminal checkout requests created by the application making the request.

Retrieves a filtered list of Interac Terminal refund requests created by the seller making the request.

Deletes a set of CatalogItems based on the provided list of target IDs and returns a set of successfully deleted IDs in the response.

Returns a set of objects based on the provided ID.

Creates or updates up to 10,000 target objects based on the provided list of objects.

Uploads an image file to be represented by a CatalogImage object that can be linked to an existing CatalogObject instance.

Deletes a single CatalogObject based on the provided ID and returns the set of successfully deleted IDs in the response.

Retrieves information about the Square Catalog API, such as batch size limits that can be used by the BatchUpsertCatalogObjects endpoint.

Returns a list of all CatalogObjects of the specified types in the catalog.

Searches for CatalogObject of any type by matching supported search attribute values, excluding custom attribute values on items or item variations, against one or more of the specified query filters.

Uploads a new image file to replace the existing one in the specified CatalogImage object.

Updates the CatalogModifierList objects that apply to the targeted CatalogItem without having to perform an upsert on the entire item.

Updates the CatalogTax objects that apply to the targeted CatalogItem without having to perform an upsert on the entire item.

Applies adjustments and counts to the provided item quantities.

Returns historical physical counts and adjustments based on the provided filter criteria.

Bulk-Retrieves a list of bookings by booking IDs.

Retrieves one or more team members' booking profiles.

Cancels an existing booking.

Creates a custom inventory adjustment reason.

Soft deletes a custom inventory adjustment reason.

Retrieves a booking.

Retrieves a seller's booking profile.

Returns the InventoryAdjustment object with the provided adjustment_id.

Returns the inventory adjustment reason identified by the provided reason_id.

Retrieves the current calculated stock count for a given CatalogObject at a given set of Locations.

Returns the InventoryPhysicalCount object with the provided physical_count_id.

Retrieves a seller's location booking profile.

Retrieves a team member's booking profile.

Returns the standard and custom inventory adjustment reasons available to the seller.

Lists location booking profiles of a seller.

Lists booking profiles for team members.

Restores a soft-deleted custom inventory adjustment reason.

Updates a booking.

Applies an update to the provided adjustment.

Updates a custom inventory adjustment reason.

Adds a group membership to a customer.

Creates multiple customer profiles for a business.

Creates multiple TeamMember objects.

Deletes multiple customer profiles.

Retrieves multiple customer profiles.

Schedules a plan variation change for all active subscriptions under a given plan variation.

Updates multiple customer profiles.

Updates multiple TeamMember objects.

Schedules a CANCEL action to cancel an active subscription.

Changes the billing anchor date for a subscription.

Enrolls a customer in a subscription.

Creates a job in a seller account.

Creates a single TeamMember object.

Deletes a customer profile from a business.

Deletes a scheduled action for a subscription.

Retrieves a specific subscription.

Retrieves a specified job.

Retrieves a TeamMember object for the given TeamMember.id.

Retrieves a WageSetting object for a team member specified by TeamMember.id.

Lists all events for a specific subscription.

Lists jobs in a seller account.

Schedules a PAUSE action to pause an active subscription.

Removes a group membership from a customer.

Schedules a RESUME action to resume a paused or a deactivated subscription.

Searches the customer profiles associated with a Square account using one or more supported query filters.

Searches for subscriptions.

Schedules a SWAP_PLAN action to swap a subscription plan variation in an existing subscription.

Updates a subscription by modifying or clearing subscription field values.

Updates the title or tip eligibility of a job.

Updates a single TeamMember object.

Creates or updates a WageSetting object.

Bulk deletes bookings custom attributes.

Deletes custom attributes for locations as a bulk operation.

Deletes custom attributes for a merchant as a bulk operation.

Deletes order custom attributes as a bulk operation.

Bulk upserts bookings custom attributes.

Creates or updates custom attributes for locations as a bulk operation.

Creates or updates custom attributes for a merchant as a bulk operation.

Creates or updates order custom attributes as a bulk operation.

Creates a bookings custom attribute definition.

Creates a location-related custom attribute definition for a Square seller account.

Creates a merchant-related custom attribute definition for a Square seller account.

Creates an order-related custom attribute definition.

Deletes a bookings custom attribute.

Deletes a bookings custom attribute definition.

Deletes a custom attribute associated with a location.

Deletes a location-related custom attribute definition from a Square seller account.

Deletes a custom attribute associated with a merchant.

Deletes a merchant-related custom attribute definition from a Square seller account.

Deletes a custom attribute associated with a customer profile.

Deletes an order-related custom attribute definition from a Square seller account.

Retrieves a bookings custom attribute.

Retrieves a bookings custom attribute definition.

Retrieves a custom attribute associated with a location.

Retrieves a location-related custom attribute definition from a Square seller account.

Retrieves a custom attribute associated with a merchant.

Retrieves a merchant-related custom attribute definition from a Square seller account.

Retrieves a custom attribute associated with an order.

Retrieves an order-related custom attribute definition from a Square seller account.

Get all bookings custom attribute definitions.

Lists a booking's custom attributes.

Lists the location-related custom attribute definitions that belong to a Square seller account.

Lists the custom attributes associated with a location.

Lists the merchant-related custom attribute definitions that belong to a Square seller account.

Lists the custom attributes associated with a merchant.

Lists the order-related custom attribute definitions that belong to a Square seller account.

Lists the custom attributes associated with an order.

Updates a bookings custom attribute definition.

Updates a location-related custom attribute definition for a Square seller account.

Updates a merchant-related custom attribute definition for a Square seller account.

Updates an order-related custom attribute definition for a Square seller account.

Upserts a bookings custom attribute.

Creates or updates a custom attribute for a location.

Creates or updates a custom attribute for a merchant.

Creates or updates a custom attribute for an order.

Creates or updates custom attributes for customer profiles as a bulk operation.

Cancels an invoice.

Creates a customer-related custom attribute definition for a Square seller account.

Creates a draft invoice for an order created using the Orders API.

Uploads a file and attaches it to an invoice.

Deletes a custom attribute associated with a customer profile.

Deletes a customer-related custom attribute definition from a Square seller account.

Deletes the specified invoice.

Removes an attachment from an invoice and permanently deletes the file.

Retrieves a custom attribute associated with a customer profile.

Retrieves a customer-related custom attribute definition from a Square seller account.

Lists the customer-related custom attribute definitions that belong to a Square seller account.

Lists the custom attributes associated with a customer profile.

Publishes the specified draft invoice.

Searches for invoices from a location specified in the filter.

Updates a customer-related custom attribute definition for a Square seller account.

Updates an invoice.

Creates or updates a custom attribute for a customer profile.

Accepts the loss on a dispute.

Uploads a file to use as evidence in a dispute challenge.

Uploads text to use as evidence for a dispute challenge.

Removes specified evidence from a dispute.

Deletes a payment link.

Retrieves the location-level settings for a Square-hosted checkout page.

Retrieves the merchant-level settings for a Square-hosted checkout page.

Returns details about a specific dispute.

Returns the metadata for the evidence specified in the request URL path.

Retrieves a payment link.

Returns a list of evidence associated with a dispute.

Lists all payment links.

Submits evidence to the cardholder's bank.

Updates the location-level settings for a Square-hosted checkout page.

Updates the merchant-level settings for a Square-hosted checkout page.

Updates a payment link.

Retrieves a set of orders by their IDs.

Enables applications to preview order pricing without creating an order.

Cancels a transfer order in STARTED or PARTIALLY_RECEIVED status.

Creates a new order, in the DRAFT state, by duplicating an existing order.

Creates a new order that can include information about products for purchase and settings to apply to the purchase.

Creates a new transfer order in DRAFT status.

Creates a webhook subscription.

Deletes a transfer order in DRAFT status.

Deletes a webhook subscription.

Retrieves a specific TransferOrder by ID.

Retrieves a webhook subscription identified by its ID.

Lists all webhook event types that can be subscribed to.

Lists all webhook subscriptions owned by your application.

Pay for an order using one or more approved payments or settle an order with a total of 0.

Records receipt of CatalogItemVariations for a transfer order.

Searches for transfer orders using filters.

Changes a DRAFT transfer order to STARTED status.

Tests a webhook subscription by sending a test event to the notification URL.

Updates an open order by adding, replacing, or deleting fields.

Updates an existing transfer order.

Updates a webhook subscription.

Updates a webhook subscription by replacing the existing signature key with a new one.

Creates one or more Vendor objects to represent suppliers to a seller.

Retrieves one or more vendors of specified Vendor IDs.

Updates one or more of existing Vendor objects as suppliers to a seller.

Cancels (voids) a payment.

Cancels (voids) a payment identified by the idempotency key that is specified in the request.

Completes (captures) a payment.

Creates a digital gift card or registers a physical (plastic) gift card.

Creates a single Vendor object to represent a supplier to a seller.

Retrieves a gift card using the gift card ID.

Retrieves a gift card using the gift card account number (GAN).

Retrieves a gift card using a secure payment token that represents the gift card.

Retrieves the vendor of a specified Vendor ID.

Links a customer to a gift card, which is also referred to as adding a card on file.

Lists all gift cards.

Searches for vendors using a filter against supported Vendor properties and a supported sorter.

Unlinks a customer from a gift card, which is also referred to as removing a card on file.

Updates a payment with the APPROVED status.

Updates an existing Vendor object as a supplier to a seller.

Store a bank account on file for a square account.

Creates a new customer group for a business.

Creates a DeviceCode that can be used to login to a Square Terminal device to enter the connected terminal mode.

Deletes a customer group as identified by the group_id value.

Disable a bank account.

Retrieve details of a BankAccount bank account linked to a Square account.

Returns details of a BankAccount identified by V1 bank account ID.

Retrieves a specific customer group as identified by the group_id value.

Retrieves Device with the associated device_id.

Retrieves DeviceCode with the associated ID.

Returns a list of BankAccount objects linked to a Square account.

Retrieves the list of customer groups of a business.

Lists all DeviceCodes associated with the merchant.

List devices associated with the merchant.

Updates a customer group as identified by the group_id value.

Adds a card on file to an existing merchant.

Creates a location.

Disables the card, preventing any further updates or charges.

Disables events to prevent them from being searchable.

Enables events to make them searchable.

Retrieves details for a specific Card.

Retrieves details of a single location.

Retrieves a list of cards owned by the account making the request.

Lists all event types that you can subscribe to as webhooks or query using the Events API.

Search for Square API events that occur within a 28-day timeframe.

Updates a location.

bulk get channels.

Removes your snippet from a Square Online site.

Provides the summary details for a single cash drawer shift.

get channel.

Retrieves details of a specific payout identified by a payout ID.

Retrieves a specific refund using the refund_id.

Retrieves your snippet from a Square Online site.

Provides a paginated list of events for a single cash drawer shift.

Provides the details for all of the cash drawer shifts for a location in a date range.

list channels.

Retrieves a list of all payout entries for a specific payout.

Adds a snippet to a Square Online site or updates the existing snippet on the site.

Creates a gift card activity to manage the balance or state of a gift card.

Retrieves a specific customer segment as identified by the segment_id value.

Retrieves the Merchant object for the given merchant_id.

Retrieves the list of customer segments of a business.

Lists gift card activities.

Provides details about the merchant associated with a given access token.

Returns what this connection's access token is: its permissions (scopes), when it expires (empty for a personal access token, which does not expire), the application id and the merchant id.

Activates a domain for use with Apple Pay on the Web and Square.

Lists the Square Online sites that belong to a seller.