---
title: "Square MCP server for AI agents - actionlake"
description: "Give Claude 308 Square actions through one MCP server: customers, bookings, POS, inventory. Your agent never holds the credential. 100,000 calls a month free."
canonical: https://actionlake.com/connectors/square
updated: 2026-10-11
---

Connectors · Accounting & finance

# Square MCP server for AI agents.

actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Square and the rest of your systems. It gives your agent 308 Square actions (142 reads, 114 writes and 52 that wait for a confirmation) and holds the Square credential itself, so the agent never does. It paces Square's limits and records every call.

[Connect Square free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing)

100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.

`claude mcp add --transport http actionlake https://connect.actionlake.com/mcp`

the first call

```
do {
  action: "square.catalog.list_catalog",
  intent: "check which Square account is connected"
}
# List Catalog · read · 1 upstream call
```

- 308 actions in one signed file
- 142 read look, never change
- 114 write create and update
- 52 wait for a yes destructive, confirmed first

Set up

## Connect Square in three steps.

1. 01
   ### Add actionlake to Claude.
   Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.
   `https://connect.actionlake.com/mcp`
2. 02
   ### Connect Square.
   Bearer token. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key.
   - `access_token` Square access token
   - `api_host` Where your Square lives: your api host
   ```
   account { op: "connections.requirements", service: "square" }
   # free: exactly what to paste, and what is found for you
   ```
3. 03
   ### Make the first call. Check before a write.
   Ask in plain words; Claude picks the action. Before anything changes, `check` validates the call and prices it, for free.
   ```
   do    { action: "square.catalog.list_catalog" }
   # list catalog · read · 1 upstream call
   check { action: "square.orders.clone_order", input: { … } }
   # free: inputs, permissions, cost and confirmations, nothing sent
   ```

Square at a glance

**Sign-in**

Bearer token. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead.

**You provide**

`access_token`

**Setup fields**

`api_host`

**Limits we pace to**

100 calls a minute, per connection

**API covered**

Square API 2026-08-19`connect.squareup.com/v2`

**Built from**

Square's documentation, read 15 September 2026[OpenAPI spec (GitHub)](https://raw.githubusercontent.com/square/connect-api-specification/master/api.json)

**Service file**

Version 2.0.0, signed (Ed25519)

**Cached reads**

141 of 142 reads, for up to an hour; a write clears what it affects

**Ready-made plans**

9 in the store

**Shared entities**

9, so ask can line Square up with your other systems

**Data**

Processed and stored in Sydney, Australia. No US region yet

Capabilities

## What an AI agent can do in Square.

308 actions in 24 areas. Every one carries its effect, so a key can allow the reads and hold the rest.

- **142** read look, never change
- **114** write create and update
- **52** destructive wait for a confirmation

1. ### Customers
   29
   12 read · 11 write · 6 destructive
   List Customers · Create Customer · Retrieve Customer · Bulk Update Customers
2. ### Bookings
   24
   14 read · 6 write · 4 destructive
   Retrieve Business Booking Profile · List Bookings · Create Booking · Retrieve Booking
3. ### POS
   23
   13 read · 3 write · 7 destructive
   Create Terminal Checkout · Create Terminal Refund · Get Terminal Checkout · Get Terminal Refund
4. ### Inventory
   21
   9 read · 9 write · 3 destructive
   Batch Change Inventory · Receive Transfer Order · Create Transfer Order · Retrieve Inventory Count
5. ### Labor
   20
   9 read · 9 write · 2 destructive
   List Break Types · Create Scheduled Shift · Create Timecard · List Team Member Wages
6. ### Orders
   19
   8 read · 7 write · 4 destructive
   Clone Order · Create Order · Retrieve Order · Search Orders
7. ### Loyalty
   17
   9 read · 6 write · 2 destructive
   Create Loyalty Promotion · List Loyalty Promotions · Retrieve Loyalty Promotion · Cancel Loyalty Promotion
8. ### Payments
   17
   9 read · 3 write · 5 destructive
   List Payments · List Payouts · Create Payment · Get Payment

**16 more areas · 138 actions**

- Locations **15**
- Catalog **14**
- Accounts **13**
- Billing **12**
- Team **12**
- Invoicing **10**
- Checkout **9**
- Gift cards **9**
- Disputes **9**
- Webhooks **8**
- Purchasing **7**
- Banking **5**
- Auth **4**
- Events **4**
- Sites **4**
- Channels **3**

Square's own MCP server

## Square's MCP server, or actionlake?

Square runs a remote MCP server at mcp.squareup.com, in beta, signed in with OAuth, and a local one that takes an access token.

Use Square's server when one person wants to work in Square from their own AI client. Use actionlake when you also want Square behind the same endpoint as your other systems: a key per agent with allowed actions and a spending cap, a named person's approval before destructive actions, a sealed record of every call, and one ask across Square and another system.

Source: [Square's documentation](https://developer.squareup.com/docs/mcp), checked 22 October 2026.

Top actions

## The Square API, shaped for agents.

The ids your agent types, what each does, and the one name it shares with other systems. 204 of Square's 221 action names are shared with at least one other connector, so an agent learns them once.

| Action | What it does | Effect | Same name in |
| --- | --- | --- | --- |
| `square.catalog.list_catalog` List Catalog | ListCatalog | read | `commerce.product.list` 112 connectors |
| `square.customers.list_customers` List Customers | ListCustomers | read | `commerce.customer.list` 45 connectors |
| `square.locations.list_locations` List Locations | ListLocations | read | `commerce.warehouse.list` 32 connectors |
| `square.invoices.list_invoices` List Invoices | ListInvoices | read | `finance.invoice.list` 101 connectors |
| `square.payments.list_payments` List Payments | ListPayments | read | `finance.payment.list` 75 connectors |
| `square.orders.clone_order` Clone Order | CloneOrder | write | `commerce.order.create` 67 connectors |
| `square.orders.create_order` Create Order | CreateOrder | write | `commerce.order.create` 67 connectors |
| `square.catalog.retrieve_catalog_object` Retrieve Catalog Object | RetrieveCatalogObject | read | `commerce.product.get` 112 connectors |
| `square.customers.create_customer` Create Customer | CreateCustomer | write | `commerce.customer.create` 43 connectors |
| `square.locations.create_location` Create Location | CreateLocation | write | `commerce.warehouse.create` 20 connectors |
| `square.catalog.delete_catalog_object` Delete Catalog Object | DeleteCatalogObject | destructive | `commerce.product.delete` 80 connectors |
| `square.invoices.create_invoice` Create Invoice | CreateInvoice | write | `finance.invoice.create` 74 connectors |

Try it

## Prompts to paste into Claude.

Each one names the Square actions it will call, so you know what it reads and what it changes before you send it.

1. Read read
   Which Square invoices are more than 30 days overdue? Group them by customer with the total owed.
   calls `square.invoices.list_invoices`
2. Plan read
   Daily payments and payouts report in Square.
   calls `square.locations.retrieve_location` `square.payments.list_payments` `square.refunds.list_payment_refunds` `square.payouts.list_payouts` `square.payouts.get_payout`
3. Plan write
   Build an evidence package for a dispute in Square. Ask me before anything is sent or changed.
   calls `square.disputes.retrieve_dispute` `square.payments.get_payment` `square.disputes.list_dispute_evidence` `square.disputes.create_dispute_evidence_text` `square.disputes.accept_dispute`
4. Write write
   Clone Order in Square. Show me exactly what you will send before you save it.
   calls `square.orders.clone_order`

The plan store

## Ready-made plans for Square.

9 plans in the store. Install one and your agent runs it by name; the reply says which connections are still missing. A schedule can run a plan on a timetable. There are no triggers or webhooks, by design.

1. ### Daily payments and payouts report
   Use it when Someone wants a single end-of-day view of Square takings, refunds and bank deposits for a location.
   **Effect**
   read
   **Steps**
   5 · loops
   **Needs**
   begin time, end time and location id
   **Install**
   `square-daily-payments-and-payouts-report`
2. ### Onboard a customer and store their card
   Use it when A new customer needs a Square profile with a card kept on file for later billing.
   **Effect**
   write
   **Steps**
   4
   **Needs**
   card, email address, family name, given name, idempotency key and source id
   **Install**
   `square-onboard-customer-with-card`
3. ### Review low stock and open a restock order
   Use it when Stock is running low at a Square location and someone wants the shortfall listed and a restock payment link raised.
   A person decides Raise a Square payment link to restock _number of items_ low or out of stock items at location _location id_.
   **Effect**
   write
   **Steps**
   5 · loops
   **Needs**
   location id and restock description
   **Install**
   `square-low-stock-restock-review`
4. ### Build an evidence package for a dispute
   Use it when A Square chargeback has come in and you want the supporting evidence filed, with a human deciding whether to fight or accept it.
   A person decides Accept Square dispute _dispute id_ and forfeit _amount_ rather than contest it.
   **Effect**
   write
   **Steps**
   6
   **Needs**
   dispute id, evidence text and idempotency key
   **Install**
   `square-dispute-evidence-package`
5. ### Draft an invoice and publish it after approval
   Use it when You need to bill a Square customer but a person must review the draft before it is sent.
   A person decides Publish Square invoice _id_ to _email address_ at _name_.
   **Effect**
   write
   **Steps**
   6
   **Needs**
   customer id, idempotency key, invoice and location id
   **Install**
   `square-invoice-and-publish-with-approval`
6. ### Adjust a loyalty balance after review
   Use it when A loyalty balance needs a manual correction or goodwill credit and a person must approve the points before they are granted.
   A person decides Adjust loyalty account _account id_ by _points_ points on program _id_.
   **Effect**
   write
   **Steps**
   6
   **Needs**
   account id, adjust points, idempotency key and program id
   **Install**
   `square-loyalty-points-adjustment`
7. ### Refund a payment after approval
   Use it when A customer has asked for a refund on a specific Square payment and a person must sign off before the money moves.
   A person decides Refund _amount_ against Square payment _payment id_ for reason: _reason_.
   **Effect**
   destructive
   **Steps**
   5
   **Needs**
   amount money, idempotency key, payment id and reason
   **Install**
   `square-refund-a-payment-with-approval`
8. ### Cancel a subscription after review
   Use it when A customer has asked to cancel a Square subscription and a person must approve it before billing stops.
   A person decides Cancel Square subscription _subscription id_ for _email address_ at the end of the current billing period.
   **Effect**
   destructive
   **Steps**
   6
   **Needs**
   subscription id
   **Install**
   `square-cancel-subscription-with-approval`
9. ### Watch a terminal checkout to completion
   Use it when A card present sale is running on a Square terminal and you want to follow it until it settles and then clear the screen.
   A person decides Dismiss Square terminal checkout _checkout id_ from the device screen, clearing the customer display.
   **Effect**
   destructive
   **Steps**
   6
   **Needs**
   checkout id
   **Install**
   `square-terminal-checkout-watch`

install a plan

```
account { op: "plans.install", slug: "square-daily-payments-and-payouts-report" }
# then ask for it by name; a schedule can run it on a timetable
```

Governance for Square

## Destructive actions wait for a yes.

52 Square actions are destructive. The first 10:

- Delete Catalog Object `square.catalog.delete_catalog_object`
- Batch Delete Catalog Objects `square.catalog.batch_delete_catalog_objects`
- Pay Order `square.orders.pay_order`
- Create Payment `square.payments.create_payment`
- Delete Customer `square.customers.delete_customer`
- Bulk Delete Customers `square.customers.bulk_delete_customers`
- Delete Invoice `square.invoices.delete_invoice`
- Cancel Invoice `square.invoices.cancel_invoice`
- Cancel Loyalty Promotion `square.loyalty.cancel_loyalty_promotion`
- Refund Payment `square.refunds.refund_payment`

A destructive action runs only with `confirm: true`. Under the `human` policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.

do square.catalog.delete_catalog_object confirm_policy: **human**

Delete Catalog Object?

**intent:** the user asked me to delete Catalog Object

run suspended · waiting for a named person · key _square-agent_ cannot confirm itself

In the console, or from an emailed signed link.

a key for this connector

```
account {
  op: "keys.create", name: "square-agent",
  allowed_actions: ["square.*"], cap_calls: 2000,
  confirm_policy: "human_for_writes",
  approval_rules: [
    { match: "square.catalog.delete_catalog_object", approver: "lead@example.com" },
    { match: "square.catalog.batch_delete_catalog_objects", approver: "lead@example.com" },
    { match: "square.orders.pay_order", approver: "lead@example.com" }
  ]
}
```

Illustrative. Scoped to Square only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person.

Cost

## What Square costs on actionlake.

Every Square action is one upstream call, the only thing actionlake bills. Searching, `check`, `cost`, `account` and any call Square refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

- 1 upstream call per action all 308 Square actions
- 308 actions page each page of a long list is one call
- 141 reads can be cached a cache hit costs nothing
- 100,000 calls a month, free paid plans from US$49 a month for 250,000

[See pricing](https://actionlake.com/pricing)

Action index

## Every Square action.

308 actions by area: the id your agent calls, what it does, and its effect.

**Customers 29**

- `square.customer_custom_attributes.bulk_upsert_customer_custom_attributes` Bulk Upsert Customer Custom Attributes write
- `square.customer_custom_attributes.create_customer_custom_attribute_definition` Create Customer Custom Attribute Definition write
- `square.customer_custom_attributes.delete_customer_custom_attribute` Delete Customer Custom Attribute destructive
- `square.customer_custom_attributes.delete_customer_custom_attribute_definition` Delete Customer Custom Attribute Definition destructive
- `square.customer_custom_attributes.list_customer_custom_attribute_definitions` List Customer Custom Attribute Definitions read
- `square.customer_custom_attributes.list_customer_custom_attributes` List Customer Custom Attributes read
- `square.customer_custom_attributes.retrieve_customer_custom_attribute` Retrieve Customer Custom Attribute read
- `square.customer_custom_attributes.retrieve_customer_custom_attribute_definition` Retrieve Customer Custom Attribute Definition read
- `square.customer_custom_attributes.update_customer_custom_attribute_definition` Update Customer Custom Attribute Definition write
- `square.customer_custom_attributes.upsert_customer_custom_attribute` Upsert Customer Custom Attribute write
- `square.customer_groups.create_customer_group` Create Customer Group write
- `square.customer_groups.delete_customer_group` Delete Customer Group destructive
- `square.customer_groups.list_customer_groups` List Customer Groups read
- `square.customer_groups.retrieve_customer_group` Retrieve Customer Group read
- `square.customer_groups.update_customer_group` Update Customer Group write
- `square.customer_segments.list_customer_segments` List Customer Segments read
- `square.customer_segments.retrieve_customer_segment` Retrieve Customer Segment read
- `square.customers.add_group_to_customer` Add Group To Customer write
- `square.customers.bulk_create_customers` Bulk Create Customers write
- `square.customers.bulk_delete_customers` Bulk Delete Customers destructive
- `square.customers.bulk_retrieve_customers` Bulk Retrieve Customers read
- `square.customers.bulk_update_customers` Bulk Update Customers write
- `square.customers.create_customer` Create Customer write
- `square.customers.delete_customer` Delete Customer destructive
- `square.customers.list_customers` List Customers read
- `square.customers.remove_group_from_customer` Remove Group From Customer destructive
- `square.customers.retrieve_customer` Retrieve Customer read
- `square.customers.search_customers` Search Customers read
- `square.customers.update_customer` Update Customer write

**Bookings 24**

- `square.booking_custom_attributes.bulk_delete_booking_custom_attributes` Bulk Delete Booking Custom Attributes destructive
- `square.booking_custom_attributes.bulk_upsert_booking_custom_attributes` Bulk Upsert Booking Custom Attributes write
- `square.booking_custom_attributes.create_booking_custom_attribute_definition` Create Booking Custom Attribute Definition write
- `square.booking_custom_attributes.delete_booking_custom_attribute` Delete Booking Custom Attribute destructive
- `square.booking_custom_attributes.delete_booking_custom_attribute_definition` Delete Booking Custom Attribute Definition destructive
- `square.booking_custom_attributes.list_booking_custom_attribute_definitions` List Booking Custom Attribute Definitions read
- `square.booking_custom_attributes.list_booking_custom_attributes` List Booking Custom Attributes read
- `square.booking_custom_attributes.retrieve_booking_custom_attribute` Retrieve Booking Custom Attribute read
- `square.booking_custom_attributes.retrieve_booking_custom_attribute_definition` Retrieve Booking Custom Attribute Definition read
- `square.booking_custom_attributes.update_booking_custom_attribute_definition` Update Booking Custom Attribute Definition write
- `square.booking_custom_attributes.upsert_booking_custom_attribute` Upsert Booking Custom Attribute write
- `square.bookings.bulk_retrieve_bookings` Bulk Retrieve Bookings read
- `square.bookings.bulk_retrieve_team_member_booking_profiles` Bulk Retrieve Team Member Booking Profiles read
- `square.bookings.cancel_booking` Cancel Booking destructive
- `square.bookings.create_booking` Create Booking write
- `square.bookings.list_bookings` List Bookings read
- `square.bookings.list_location_booking_profiles` List Location Booking Profiles read
- `square.bookings.list_team_member_booking_profiles` List Team Member Booking Profiles read
- `square.bookings.retrieve_booking` Retrieve Booking read
- `square.bookings.retrieve_business_booking_profile` Retrieve Business Booking Profile read
- `square.bookings.retrieve_location_booking_profile` Retrieve Location Booking Profile read
- `square.bookings.retrieve_team_member_booking_profile` Retrieve Team Member Booking Profile read
- `square.bookings.search_availability` Search Availability read
- `square.bookings.update_booking` Update Booking write

**POS 23**

- `square.cash_drawers.list_cash_drawer_shift_events` List Cash Drawer Shift Events read
- `square.cash_drawers.list_cash_drawer_shifts` List Cash Drawer Shifts read
- `square.cash_drawers.retrieve_cash_drawer_shift` Retrieve Cash Drawer Shift read
- `square.devices.create_device_code` Create Device Code write
- `square.devices.get_device` Get Device read
- `square.devices.get_device_code` Get Device Code read
- `square.devices.list_device_codes` List Device Codes read
- `square.devices.list_devices` List Devices read
- `square.terminal.cancel_terminal_action` Cancel Terminal Action destructive
- `square.terminal.cancel_terminal_checkout` Cancel Terminal Checkout destructive
- `square.terminal.cancel_terminal_refund` Cancel Terminal Refund destructive
- `square.terminal.create_terminal_action` Create Terminal Action write
- `square.terminal.create_terminal_checkout` Create Terminal Checkout write
- `square.terminal.create_terminal_refund` Create Terminal Refund destructive
- `square.terminal.dismiss_terminal_action` Dismiss Terminal Action destructive
- `square.terminal.dismiss_terminal_checkout` Dismiss Terminal Checkout destructive
- `square.terminal.dismiss_terminal_refund` Dismiss Terminal Refund destructive
- `square.terminal.get_terminal_action` Get Terminal Action read
- `square.terminal.get_terminal_checkout` Get Terminal Checkout read
- `square.terminal.get_terminal_refund` Get Terminal Refund read
- `square.terminal.search_terminal_actions` Search Terminal Actions read
- `square.terminal.search_terminal_checkouts` Search Terminal Checkouts read
- `square.terminal.search_terminal_refunds` Search Terminal Refunds read

**Inventory 21**

- `square.inventory.batch_change_inventory` Batch Change Inventory write
- `square.inventory.batch_retrieve_inventory_changes` Batch Retrieve Inventory Changes read
- `square.inventory.batch_retrieve_inventory_counts` Batch Retrieve Inventory Counts read
- `square.inventory.create_inventory_adjustment_reason` Create Inventory Adjustment Reason write
- `square.inventory.delete_inventory_adjustment_reason` Delete Inventory Adjustment Reason destructive
- `square.inventory.list_inventory_adjustment_reasons` List Inventory Adjustment Reasons read
- `square.inventory.restore_inventory_adjustment_reason` Restore Inventory Adjustment Reason write
- `square.inventory.retrieve_inventory_adjustment` Retrieve Inventory Adjustment read
- `square.inventory.retrieve_inventory_adjustment_reason` Retrieve Inventory Adjustment Reason read
- `square.inventory.retrieve_inventory_count` Retrieve Inventory Count read
- `square.inventory.retrieve_inventory_physical_count` Retrieve Inventory Physical Count read
- `square.inventory.update_inventory_adjustment` Update Inventory Adjustment write
- `square.inventory.update_inventory_adjustment_reason` Update Inventory Adjustment Reason write
- `square.transfer_orders.cancel_transfer_order` Cancel Transfer Order destructive
- `square.transfer_orders.create_transfer_order` Create Transfer Order write
- `square.transfer_orders.delete_transfer_order` Delete Transfer Order destructive
- `square.transfer_orders.receive_transfer_order` Receive Transfer Order write
- `square.transfer_orders.retrieve_transfer_order` Retrieve Transfer Order read
- `square.transfer_orders.search_transfer_orders` Search Transfer Orders read
- `square.transfer_orders.start_transfer_order` Start Transfer Order write
- `square.transfer_orders.update_transfer_order` Update Transfer Order write

**Labor 20**

- `square.labor.bulk_publish_scheduled_shifts` Bulk Publish Scheduled Shifts write
- `square.labor.create_break_type` Create Break Type write
- `square.labor.create_scheduled_shift` Create Scheduled Shift write
- `square.labor.create_timecard` Create Timecard write
- `square.labor.delete_break_type` Delete Break Type destructive
- `square.labor.delete_timecard` Delete Timecard destructive
- `square.labor.get_break_type` Get Break Type read
- `square.labor.get_team_member_wage` Get Team Member Wage read
- `square.labor.list_break_types` List Break Types read
- `square.labor.list_team_member_wages` List Team Member Wages read
- `square.labor.list_workweek_configs` List Workweek Configs read
- `square.labor.publish_scheduled_shift` Publish Scheduled Shift write
- `square.labor.retrieve_scheduled_shift` Retrieve Scheduled Shift read
- `square.labor.retrieve_timecard` Retrieve Timecard read
- `square.labor.search_scheduled_shifts` Search Scheduled Shifts read
- `square.labor.search_timecards` Search Timecards read
- `square.labor.update_break_type` Update Break Type write
- `square.labor.update_scheduled_shift` Update Scheduled Shift write
- `square.labor.update_timecard` Update Timecard write
- `square.labor.update_workweek_config` Update Workweek Config write

**Orders 19**

- `square.order_custom_attributes.bulk_delete_order_custom_attributes` Bulk Delete Order Custom Attributes destructive
- `square.order_custom_attributes.bulk_upsert_order_custom_attributes` Bulk Upsert Order Custom Attributes write
- `square.order_custom_attributes.create_order_custom_attribute_definition` Create Order Custom Attribute Definition write
- `square.order_custom_attributes.delete_order_custom_attribute` Delete Order Custom Attribute destructive
- `square.order_custom_attributes.delete_order_custom_attribute_definition` Delete Order Custom Attribute Definition destructive
- `square.order_custom_attributes.list_order_custom_attribute_definitions` List Order Custom Attribute Definitions read
- `square.order_custom_attributes.list_order_custom_attributes` List Order Custom Attributes read
- `square.order_custom_attributes.retrieve_order_custom_attribute` Retrieve Order Custom Attribute read
- `square.order_custom_attributes.retrieve_order_custom_attribute_definition` Retrieve Order Custom Attribute Definition read
- `square.order_custom_attributes.update_order_custom_attribute_definition` Update Order Custom Attribute Definition write
- `square.order_custom_attributes.upsert_order_custom_attribute` Upsert Order Custom Attribute write
- `square.orders.batch_retrieve_orders` Batch Retrieve Orders read
- `square.orders.calculate_order` Calculate Order read
- `square.orders.clone_order` Clone Order write
- `square.orders.create_order` Create Order write
- `square.orders.pay_order` Pay Order destructive
- `square.orders.retrieve_order` Retrieve Order read
- `square.orders.search_orders` Search Orders read
- `square.orders.update_order` Update Order write

**Loyalty 17**

- `square.loyalty.accumulate_loyalty_points` Accumulate Loyalty Points write
- `square.loyalty.adjust_loyalty_points` Adjust Loyalty Points write
- `square.loyalty.calculate_loyalty_points` Calculate Loyalty Points read
- `square.loyalty.cancel_loyalty_promotion` Cancel Loyalty Promotion destructive
- `square.loyalty.create_loyalty_account` Create Loyalty Account write
- `square.loyalty.create_loyalty_promotion` Create Loyalty Promotion write
- `square.loyalty.create_loyalty_reward` Create Loyalty Reward write
- `square.loyalty.delete_loyalty_reward` Delete Loyalty Reward destructive
- `square.loyalty.list_loyalty_promotions` List Loyalty Promotions read
- `square.loyalty.redeem_loyalty_reward` Redeem Loyalty Reward write
- `square.loyalty.retrieve_loyalty_account` Retrieve Loyalty Account read
- `square.loyalty.retrieve_loyalty_program` Retrieve Loyalty Program read
- `square.loyalty.retrieve_loyalty_promotion` Retrieve Loyalty Promotion read
- `square.loyalty.retrieve_loyalty_reward` Retrieve Loyalty Reward read
- `square.loyalty.search_loyalty_accounts` Search Loyalty Accounts read
- `square.loyalty.search_loyalty_events` Search Loyalty Events read
- `square.loyalty.search_loyalty_rewards` Search Loyalty Rewards read

**Payments 17**

- `square.cards.create_card` Create Card write
- `square.cards.disable_card` Disable Card write
- `square.cards.list_cards` List Cards read
- `square.cards.retrieve_card` Retrieve Card read
- `square.payments.cancel_payment` Cancel Payment destructive
- `square.payments.cancel_payment_by_idempotency_key` Cancel Payment By Idempotency Key destructive
- `square.payments.complete_payment` Complete Payment destructive
- `square.payments.create_payment` Create Payment destructive
- `square.payments.get_payment` Get Payment read
- `square.payments.list_payments` List Payments read
- `square.payments.update_payment` Update Payment write
- `square.payouts.get_payout` Get Payout read
- `square.payouts.list_payout_entries` List Payout Entries read
- `square.payouts.list_payouts` List Payouts read
- `square.refunds.get_payment_refund` Get Payment Refund read
- `square.refunds.list_payment_refunds` List Payment Refunds read
- `square.refunds.refund_payment` Refund Payment destructive

**Locations 15**

- `square.location_custom_attributes.bulk_delete_location_custom_attributes` Bulk Delete Location Custom Attributes destructive
- `square.location_custom_attributes.bulk_upsert_location_custom_attributes` Bulk Upsert Location Custom Attributes write
- `square.location_custom_attributes.create_location_custom_attribute_definition` Create Location Custom Attribute Definition write
- `square.location_custom_attributes.delete_location_custom_attribute` Delete Location Custom Attribute destructive
- `square.location_custom_attributes.delete_location_custom_attribute_definition` Delete Location Custom Attribute Definition destructive
- `square.location_custom_attributes.list_location_custom_attribute_definitions` List Location Custom Attribute Definitions read
- `square.location_custom_attributes.list_location_custom_attributes` List Location Custom Attributes read
- `square.location_custom_attributes.retrieve_location_custom_attribute` Retrieve Location Custom Attribute read
- `square.location_custom_attributes.retrieve_location_custom_attribute_definition` Retrieve Location Custom Attribute Definition read
- `square.location_custom_attributes.update_location_custom_attribute_definition` Update Location Custom Attribute Definition write
- `square.location_custom_attributes.upsert_location_custom_attribute` Upsert Location Custom Attribute write
- `square.locations.create_location` Create Location write
- `square.locations.list_locations` List Locations read
- `square.locations.retrieve_location` Retrieve Location read
- `square.locations.update_location` Update Location write

**Catalog 14**

- `square.catalog.batch_delete_catalog_objects` Batch Delete Catalog Objects destructive
- `square.catalog.batch_retrieve_catalog_objects` Batch Retrieve Catalog Objects read
- `square.catalog.batch_upsert_catalog_objects` Batch Upsert Catalog Objects write
- `square.catalog.catalog_info` Catalog Info read
- `square.catalog.create_catalog_image` Create Catalog Image write
- `square.catalog.delete_catalog_object` Delete Catalog Object destructive
- `square.catalog.list_catalog` List Catalog read
- `square.catalog.retrieve_catalog_object` Retrieve Catalog Object read
- `square.catalog.search_catalog_items` Search Catalog Items read
- `square.catalog.search_catalog_objects` Search Catalog Objects read
- `square.catalog.update_catalog_image` Update Catalog Image write
- `square.catalog.update_item_modifier_lists` Update Item Modifier Lists write
- `square.catalog.update_item_taxes` Update Item Taxes write
- `square.catalog.upsert_catalog_object` Upsert Catalog Object write

**Accounts 13**

- `square.merchant_custom_attributes.bulk_delete_merchant_custom_attributes` Bulk Delete Merchant Custom Attributes destructive
- `square.merchant_custom_attributes.bulk_upsert_merchant_custom_attributes` Bulk Upsert Merchant Custom Attributes write
- `square.merchant_custom_attributes.create_merchant_custom_attribute_definition` Create Merchant Custom Attribute Definition write
- `square.merchant_custom_attributes.delete_merchant_custom_attribute` Delete Merchant Custom Attribute destructive
- `square.merchant_custom_attributes.delete_merchant_custom_attribute_definition` Delete Merchant Custom Attribute Definition destructive
- `square.merchant_custom_attributes.list_merchant_custom_attribute_definitions` List Merchant Custom Attribute Definitions read
- `square.merchant_custom_attributes.list_merchant_custom_attributes` List Merchant Custom Attributes read
- `square.merchant_custom_attributes.retrieve_merchant_custom_attribute` Retrieve Merchant Custom Attribute read
- `square.merchant_custom_attributes.retrieve_merchant_custom_attribute_definition` Retrieve Merchant Custom Attribute Definition read
- `square.merchant_custom_attributes.update_merchant_custom_attribute_definition` Update Merchant Custom Attribute Definition write
- `square.merchant_custom_attributes.upsert_merchant_custom_attribute` Upsert Merchant Custom Attribute write
- `square.merchants.list_merchants` List Merchants read
- `square.merchants.retrieve_merchant` Retrieve Merchant read

**Billing 12**

- `square.subscriptions.bulk_swap_plan` Bulk Swap Plan write
- `square.subscriptions.cancel_subscription` Cancel Subscription destructive
- `square.subscriptions.change_billing_anchor_date` Change Billing Anchor Date write
- `square.subscriptions.create_subscription` Create Subscription write
- `square.subscriptions.delete_subscription_action` Delete Subscription Action destructive
- `square.subscriptions.list_subscription_events` List Subscription Events read
- `square.subscriptions.pause_subscription` Pause Subscription write
- `square.subscriptions.resume_subscription` Resume Subscription write
- `square.subscriptions.retrieve_subscription` Retrieve Subscription read
- `square.subscriptions.search_subscriptions` Search Subscriptions read
- `square.subscriptions.swap_plan` Swap Plan write
- `square.subscriptions.update_subscription` Update Subscription write

**Team 12**

- `square.team.bulk_create_team_members` Bulk Create Team Members write
- `square.team.bulk_update_team_members` Bulk Update Team Members write
- `square.team.create_job` Create Job write
- `square.team.create_team_member` Create Team Member write
- `square.team.list_jobs` List Jobs read
- `square.team.retrieve_job` Retrieve Job read
- `square.team.retrieve_team_member` Retrieve Team Member read
- `square.team.retrieve_wage_setting` Retrieve Wage Setting read
- `square.team.search_team_members` Search Team Members read
- `square.team.update_job` Update Job write
- `square.team.update_team_member` Update Team Member write
- `square.team.update_wage_setting` Update Wage Setting write

**Invoicing 10**

- `square.invoices.cancel_invoice` Cancel Invoice destructive
- `square.invoices.create_invoice` Create Invoice write
- `square.invoices.create_invoice_attachment` Create Invoice Attachment write
- `square.invoices.delete_invoice` Delete Invoice destructive
- `square.invoices.delete_invoice_attachment` Delete Invoice Attachment destructive
- `square.invoices.get_invoice` Get Invoice read
- `square.invoices.list_invoices` List Invoices read
- `square.invoices.publish_invoice` Publish Invoice write
- `square.invoices.search_invoices` Search Invoices read
- `square.invoices.update_invoice` Update Invoice write

**Checkout 9**

- `square.checkout.create_payment_link` Create Payment Link write
- `square.checkout.delete_payment_link` Delete Payment Link destructive
- `square.checkout.list_payment_links` List Payment Links read
- `square.checkout.retrieve_location_settings` Retrieve Location Settings read
- `square.checkout.retrieve_merchant_settings` Retrieve Merchant Settings read
- `square.checkout.retrieve_payment_link` Retrieve Payment Link read
- `square.checkout.update_location_settings` Update Location Settings write
- `square.checkout.update_merchant_settings` Update Merchant Settings write
- `square.checkout.update_payment_link` Update Payment Link write

**Gift cards 9**

- `square.gift_card_activities.create_gift_card_activity` Create Gift Card Activity write
- `square.gift_card_activities.list_gift_card_activities` List Gift Card Activities read
- `square.gift_cards.create_gift_card` Create Gift Card write
- `square.gift_cards.link_customer_to_gift_card` Link Customer To Gift Card write
- `square.gift_cards.list_gift_cards` List Gift Cards read
- `square.gift_cards.retrieve_gift_card` Retrieve Gift Card read
- `square.gift_cards.retrieve_gift_card_from_gan` Retrieve Gift Card From GAN read
- `square.gift_cards.retrieve_gift_card_from_nonce` Retrieve Gift Card From Nonce read
- `square.gift_cards.unlink_customer_from_gift_card` Unlink Customer From Gift Card write

**Disputes 9**

- `square.disputes.accept_dispute` Accept Dispute write
- `square.disputes.create_dispute_evidence_file` Create Dispute Evidence File write
- `square.disputes.create_dispute_evidence_text` Create Dispute Evidence Text write
- `square.disputes.delete_dispute_evidence` Delete Dispute Evidence destructive
- `square.disputes.list_dispute_evidence` List Dispute Evidence read
- `square.disputes.list_disputes` List Disputes read
- `square.disputes.retrieve_dispute` Retrieve Dispute read
- `square.disputes.retrieve_dispute_evidence` Retrieve Dispute Evidence read
- `square.disputes.submit_evidence` Submit Evidence write

**Webhooks 8**

- `square.webhooks.create_webhook_subscription` Create Webhook Subscription write
- `square.webhooks.delete_webhook_subscription` Delete Webhook Subscription destructive
- `square.webhooks.list_webhook_event_types` List Webhook Event Types read
- `square.webhooks.list_webhook_subscriptions` List Webhook Subscriptions read
- `square.webhooks.retrieve_webhook_subscription` Retrieve Webhook Subscription read
- `square.webhooks.test_webhook_subscription` Test Webhook Subscription write
- `square.webhooks.update_webhook_subscription` Update Webhook Subscription write
- `square.webhooks.update_webhook_subscription_signature_key` Update Webhook Subscription Signature Key write

**Purchasing 7**

- `square.vendors.bulk_create_vendors` Bulk Create Vendors write
- `square.vendors.bulk_retrieve_vendors` Bulk Retrieve Vendors read
- `square.vendors.bulk_update_vendors` Bulk Update Vendors write
- `square.vendors.create_vendor` Create Vendor write
- `square.vendors.retrieve_vendor` Retrieve Vendor read
- `square.vendors.search_vendors` Search Vendors read
- `square.vendors.update_vendor` Update Vendor write

**Banking 5**

- `square.bank_accounts.create_bank_account` Create Bank Account write
- `square.bank_accounts.disable_bank_account` Disable Bank Account destructive
- `square.bank_accounts.get_bank_account` Get Bank Account read
- `square.bank_accounts.get_bank_account_by_v1_id` Get Bank Account By V1 Id read
- `square.bank_accounts.list_bank_accounts` List Bank Accounts read

**Auth 4**

- `square.apple_pay.register_domain` Register Domain write
- `square.oauth.obtain_token` Obtain Token write
- `square.oauth.retrieve_token_status` Retrieve Token Status read
- `square.oauth.revoke_token` Revoke Token destructive

**Events 4**

- `square.events.disable_events` Disable Events write
- `square.events.enable_events` Enable Events write
- `square.events.list_event_types` List Event Types read
- `square.events.search_events` Search Events read

**Sites 4**

- `square.sites.list_sites` List Sites read
- `square.snippets.delete_snippet` Delete Snippet destructive
- `square.snippets.retrieve_snippet` Retrieve Snippet read
- `square.snippets.upsert_snippet` Upsert Snippet write

**Channels 3**

- `square.channels.bulk_retrieve_channels` Bulk Retrieve Channels read
- `square.channels.list_channels` List Channels read
- `square.channels.retrieve_channel` Retrieve Channel read

Questions

## The Square MCP server, answered.

**Is there a Square MCP server for Claude?**

Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 308 Square actions across customers, bookings, POS and inventory, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Square.

**Does Square have its own MCP server?**

Square runs a remote MCP server at mcp.squareup.com, in beta, signed in with OAuth, and a local one that takes an access token. (Square's documentation, checked 22 October 2026.) Use Square's server when one person wants to work in Square from their own AI client. Use actionlake when you also want Square behind the same endpoint as your other systems: a key per agent with allowed actions and a spending cap, a named person's approval before destructive actions, a sealed record of every call, and one ask across Square and another system.

**What do I need to connect Square?**

Square access token. Plus your api host. The free call account { op: "connections.requirements", service: "square" } lists exactly what to paste.

**Can an AI agent delete or change things in Square?**

Only if its key allows it, and only with an explicit confirmation. 52 Square actions are destructive, including delete Catalog Object, batch Delete Catalog Objects and pay Order. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.

**Will an AI agent use up my Square API limit?**

actionlake paces every call to the limits in the Square service file: 100 calls a minute per connection. Repeated reads are answered from cache (141 Square actions can be), which never reaches Square.

**What does a Square action cost?**

One upstream call, the only unit actionlake bills. A list that pages bills one call per page (308 Square actions page). Cache hits, searches, dry runs and calls Square refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

**Which Square API does it cover?**

The Square API 2026-08-19 at connect.squareup.com/v2 by default, or the base URL set when you connect. It is built from Square's documentation as read on 15 September 2026. 308 actions in 24 areas, each one in the signed service file (version 2.0.0).

**Does actionlake keep my Square data, and where?**

actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to an hour, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Square credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.

**Which AI clients can use it?**

Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.

## More connectors like Square

Shares the most action names with

- [Stripe 75](https://actionlake.com/connectors/stripe)
- [NetSuite 59](https://actionlake.com/connectors/netsuite)
- [Airwallex 43](https://actionlake.com/connectors/airwallex)
- [PayPal 41](https://actionlake.com/connectors/paypal)
- [Mollie 39](https://actionlake.com/connectors/mollie)
- [Polar 37](https://actionlake.com/connectors/polar)

Joins with, on shared entities

- [Shopify Admin 6](https://actionlake.com/connectors/shopify-admin)
- [Zoho Inventory 5](https://actionlake.com/connectors/zoho-inventory)
- [HaloPSA 4](https://actionlake.com/connectors/halopsa)
- [BigCommerce 4](https://actionlake.com/connectors/bigcommerce)
- [Adobe Commerce 4](https://actionlake.com/connectors/adobe-commerce)
- [Epos Now 4](https://actionlake.com/connectors/epos-now)

Browse

- [All Accounting & finance connectors](https://actionlake.com/connectors/category/accounting-and-finance)
- [All connectors](https://actionlake.com/connectors)
- [How actionlake compares](https://actionlake.com/compare)

actionlake is independent. It is not made or endorsed by Square; the name is the vendor's own. Counts are from the Square service file, version 2.0.0.

## Give your agent Square today.

[Connect Square free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing)

Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.

---

Source: https://actionlake.com/connectors/square
More: https://actionlake.com/llms.txt