Skip to content

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.

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
  • 308actionsin one signed file
  • 142readlook, never change
  • 114writecreate and update
  • 52wait for a yesdestructive, 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_tokenSquare access token
    • api_hostWhere 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 callcheck { 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-19connect.squareup.com/v2
Built from
Square's documentation, read 15 September 2026OpenAPI spec (GitHub)
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.

  • 142readlook, never change
  • 114writecreate and update
  • 52destructivewait 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, 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.

ActionWhat it doesEffectSame name in
square.catalog.list_catalogList CatalogListCatalogreadcommerce.product.list112 connectors
square.customers.list_customersList CustomersListCustomersreadcommerce.customer.list45 connectors
square.locations.list_locationsList LocationsListLocationsreadcommerce.warehouse.list32 connectors
square.invoices.list_invoicesList InvoicesListInvoicesreadfinance.invoice.list101 connectors
square.payments.list_paymentsList PaymentsListPaymentsreadfinance.payment.list75 connectors
square.orders.clone_orderClone OrderCloneOrderwritecommerce.order.create67 connectors
square.orders.create_orderCreate OrderCreateOrderwritecommerce.order.create67 connectors
square.catalog.retrieve_catalog_objectRetrieve Catalog ObjectRetrieveCatalogObjectreadcommerce.product.get112 connectors
square.customers.create_customerCreate CustomerCreateCustomerwritecommerce.customer.create43 connectors
square.locations.create_locationCreate LocationCreateLocationwritecommerce.warehouse.create20 connectors
square.catalog.delete_catalog_objectDelete Catalog ObjectDeleteCatalogObjectdestructivecommerce.product.delete80 connectors
square.invoices.create_invoiceCreate InvoiceCreateInvoicewritefinance.invoice.create74 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. Readread

    Which Square invoices are more than 30 days overdue? Group them by customer with the total owed.

    callssquare.invoices.list_invoices

  2. Planread

    Daily payments and payouts report in Square.

    callssquare.locations.retrieve_locationsquare.payments.list_paymentssquare.refunds.list_payment_refundssquare.payouts.list_payoutssquare.payouts.get_payout

  3. Planwrite

    Build an evidence package for a dispute in Square. Ask me before anything is sent or changed.

    callssquare.disputes.retrieve_disputesquare.payments.get_paymentsquare.disputes.list_dispute_evidencesquare.disputes.create_dispute_evidence_textsquare.disputes.accept_dispute

  4. Writewrite

    Clone Order in Square. Show me exactly what you will send before you save it.

    callssquare.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 decidesRaise 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 decidesAccept 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 decidesPublish 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 decidesAdjust 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 decidesRefund 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 decidesCancel 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 decidesDismiss 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 Objectsquare.catalog.delete_catalog_object
  • Batch Delete Catalog Objectssquare.catalog.batch_delete_catalog_objects
  • Pay Ordersquare.orders.pay_order
  • Create Paymentsquare.payments.create_payment
  • Delete Customersquare.customers.delete_customer
  • Bulk Delete Customerssquare.customers.bulk_delete_customers
  • Delete Invoicesquare.invoices.delete_invoice
  • Cancel Invoicesquare.invoices.cancel_invoice
  • Cancel Loyalty Promotionsquare.loyalty.cancel_loyalty_promotion
  • Refund Paymentsquare.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.

dosquare.catalog.delete_catalog_objectconfirm_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: "[email protected]" },    { match: "square.catalog.batch_delete_catalog_objects", approver: "[email protected]" },    { match: "square.orders.pay_order", approver: "[email protected]" }  ]}
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.

  • 1upstream call per actionall 308 Square actions
  • 308actions pageeach page of a long list is one call
  • 141reads can be cacheda cache hit costs nothing
  • 100,000calls a month, freepaid plans from US$49 a month for 250,000

See pricing

Action index

Every Square action.

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

Customers29
  • square.customer_custom_attributes.bulk_upsert_customer_custom_attributesBulk Upsert Customer Custom Attributeswrite
  • square.customer_custom_attributes.create_customer_custom_attribute_definitionCreate Customer Custom Attribute Definitionwrite
  • square.customer_custom_attributes.delete_customer_custom_attributeDelete Customer Custom Attributedestructive
  • square.customer_custom_attributes.delete_customer_custom_attribute_definitionDelete Customer Custom Attribute Definitiondestructive
  • square.customer_custom_attributes.list_customer_custom_attribute_definitionsList Customer Custom Attribute Definitionsread
  • square.customer_custom_attributes.list_customer_custom_attributesList Customer Custom Attributesread
  • square.customer_custom_attributes.retrieve_customer_custom_attributeRetrieve Customer Custom Attributeread
  • square.customer_custom_attributes.retrieve_customer_custom_attribute_definitionRetrieve Customer Custom Attribute Definitionread
  • square.customer_custom_attributes.update_customer_custom_attribute_definitionUpdate Customer Custom Attribute Definitionwrite
  • square.customer_custom_attributes.upsert_customer_custom_attributeUpsert Customer Custom Attributewrite
  • square.customer_groups.create_customer_groupCreate Customer Groupwrite
  • square.customer_groups.delete_customer_groupDelete Customer Groupdestructive
  • square.customer_groups.list_customer_groupsList Customer Groupsread
  • square.customer_groups.retrieve_customer_groupRetrieve Customer Groupread
  • square.customer_groups.update_customer_groupUpdate Customer Groupwrite
  • square.customer_segments.list_customer_segmentsList Customer Segmentsread
  • square.customer_segments.retrieve_customer_segmentRetrieve Customer Segmentread
  • square.customers.add_group_to_customerAdd Group To Customerwrite
  • square.customers.bulk_create_customersBulk Create Customerswrite
  • square.customers.bulk_delete_customersBulk Delete Customersdestructive
  • square.customers.bulk_retrieve_customersBulk Retrieve Customersread
  • square.customers.bulk_update_customersBulk Update Customerswrite
  • square.customers.create_customerCreate Customerwrite
  • square.customers.delete_customerDelete Customerdestructive
  • square.customers.list_customersList Customersread
  • square.customers.remove_group_from_customerRemove Group From Customerdestructive
  • square.customers.retrieve_customerRetrieve Customerread
  • square.customers.search_customersSearch Customersread
  • square.customers.update_customerUpdate Customerwrite
Bookings24
  • square.booking_custom_attributes.bulk_delete_booking_custom_attributesBulk Delete Booking Custom Attributesdestructive
  • square.booking_custom_attributes.bulk_upsert_booking_custom_attributesBulk Upsert Booking Custom Attributeswrite
  • square.booking_custom_attributes.create_booking_custom_attribute_definitionCreate Booking Custom Attribute Definitionwrite
  • square.booking_custom_attributes.delete_booking_custom_attributeDelete Booking Custom Attributedestructive
  • square.booking_custom_attributes.delete_booking_custom_attribute_definitionDelete Booking Custom Attribute Definitiondestructive
  • square.booking_custom_attributes.list_booking_custom_attribute_definitionsList Booking Custom Attribute Definitionsread
  • square.booking_custom_attributes.list_booking_custom_attributesList Booking Custom Attributesread
  • square.booking_custom_attributes.retrieve_booking_custom_attributeRetrieve Booking Custom Attributeread
  • square.booking_custom_attributes.retrieve_booking_custom_attribute_definitionRetrieve Booking Custom Attribute Definitionread
  • square.booking_custom_attributes.update_booking_custom_attribute_definitionUpdate Booking Custom Attribute Definitionwrite
  • square.booking_custom_attributes.upsert_booking_custom_attributeUpsert Booking Custom Attributewrite
  • square.bookings.bulk_retrieve_bookingsBulk Retrieve Bookingsread
  • square.bookings.bulk_retrieve_team_member_booking_profilesBulk Retrieve Team Member Booking Profilesread
  • square.bookings.cancel_bookingCancel Bookingdestructive
  • square.bookings.create_bookingCreate Bookingwrite
  • square.bookings.list_bookingsList Bookingsread
  • square.bookings.list_location_booking_profilesList Location Booking Profilesread
  • square.bookings.list_team_member_booking_profilesList Team Member Booking Profilesread
  • square.bookings.retrieve_bookingRetrieve Bookingread
  • square.bookings.retrieve_business_booking_profileRetrieve Business Booking Profileread
  • square.bookings.retrieve_location_booking_profileRetrieve Location Booking Profileread
  • square.bookings.retrieve_team_member_booking_profileRetrieve Team Member Booking Profileread
  • square.bookings.search_availabilitySearch Availabilityread
  • square.bookings.update_bookingUpdate Bookingwrite
POS23
  • square.cash_drawers.list_cash_drawer_shift_eventsList Cash Drawer Shift Eventsread
  • square.cash_drawers.list_cash_drawer_shiftsList Cash Drawer Shiftsread
  • square.cash_drawers.retrieve_cash_drawer_shiftRetrieve Cash Drawer Shiftread
  • square.devices.create_device_codeCreate Device Codewrite
  • square.devices.get_deviceGet Deviceread
  • square.devices.get_device_codeGet Device Coderead
  • square.devices.list_device_codesList Device Codesread
  • square.devices.list_devicesList Devicesread
  • square.terminal.cancel_terminal_actionCancel Terminal Actiondestructive
  • square.terminal.cancel_terminal_checkoutCancel Terminal Checkoutdestructive
  • square.terminal.cancel_terminal_refundCancel Terminal Refunddestructive
  • square.terminal.create_terminal_actionCreate Terminal Actionwrite
  • square.terminal.create_terminal_checkoutCreate Terminal Checkoutwrite
  • square.terminal.create_terminal_refundCreate Terminal Refunddestructive
  • square.terminal.dismiss_terminal_actionDismiss Terminal Actiondestructive
  • square.terminal.dismiss_terminal_checkoutDismiss Terminal Checkoutdestructive
  • square.terminal.dismiss_terminal_refundDismiss Terminal Refunddestructive
  • square.terminal.get_terminal_actionGet Terminal Actionread
  • square.terminal.get_terminal_checkoutGet Terminal Checkoutread
  • square.terminal.get_terminal_refundGet Terminal Refundread
  • square.terminal.search_terminal_actionsSearch Terminal Actionsread
  • square.terminal.search_terminal_checkoutsSearch Terminal Checkoutsread
  • square.terminal.search_terminal_refundsSearch Terminal Refundsread
Inventory21
  • square.inventory.batch_change_inventoryBatch Change Inventorywrite
  • square.inventory.batch_retrieve_inventory_changesBatch Retrieve Inventory Changesread
  • square.inventory.batch_retrieve_inventory_countsBatch Retrieve Inventory Countsread
  • square.inventory.create_inventory_adjustment_reasonCreate Inventory Adjustment Reasonwrite
  • square.inventory.delete_inventory_adjustment_reasonDelete Inventory Adjustment Reasondestructive
  • square.inventory.list_inventory_adjustment_reasonsList Inventory Adjustment Reasonsread
  • square.inventory.restore_inventory_adjustment_reasonRestore Inventory Adjustment Reasonwrite
  • square.inventory.retrieve_inventory_adjustmentRetrieve Inventory Adjustmentread
  • square.inventory.retrieve_inventory_adjustment_reasonRetrieve Inventory Adjustment Reasonread
  • square.inventory.retrieve_inventory_countRetrieve Inventory Countread
  • square.inventory.retrieve_inventory_physical_countRetrieve Inventory Physical Countread
  • square.inventory.update_inventory_adjustmentUpdate Inventory Adjustmentwrite
  • square.inventory.update_inventory_adjustment_reasonUpdate Inventory Adjustment Reasonwrite
  • square.transfer_orders.cancel_transfer_orderCancel Transfer Orderdestructive
  • square.transfer_orders.create_transfer_orderCreate Transfer Orderwrite
  • square.transfer_orders.delete_transfer_orderDelete Transfer Orderdestructive
  • square.transfer_orders.receive_transfer_orderReceive Transfer Orderwrite
  • square.transfer_orders.retrieve_transfer_orderRetrieve Transfer Orderread
  • square.transfer_orders.search_transfer_ordersSearch Transfer Ordersread
  • square.transfer_orders.start_transfer_orderStart Transfer Orderwrite
  • square.transfer_orders.update_transfer_orderUpdate Transfer Orderwrite
Labor20
  • square.labor.bulk_publish_scheduled_shiftsBulk Publish Scheduled Shiftswrite
  • square.labor.create_break_typeCreate Break Typewrite
  • square.labor.create_scheduled_shiftCreate Scheduled Shiftwrite
  • square.labor.create_timecardCreate Timecardwrite
  • square.labor.delete_break_typeDelete Break Typedestructive
  • square.labor.delete_timecardDelete Timecarddestructive
  • square.labor.get_break_typeGet Break Typeread
  • square.labor.get_team_member_wageGet Team Member Wageread
  • square.labor.list_break_typesList Break Typesread
  • square.labor.list_team_member_wagesList Team Member Wagesread
  • square.labor.list_workweek_configsList Workweek Configsread
  • square.labor.publish_scheduled_shiftPublish Scheduled Shiftwrite
  • square.labor.retrieve_scheduled_shiftRetrieve Scheduled Shiftread
  • square.labor.retrieve_timecardRetrieve Timecardread
  • square.labor.search_scheduled_shiftsSearch Scheduled Shiftsread
  • square.labor.search_timecardsSearch Timecardsread
  • square.labor.update_break_typeUpdate Break Typewrite
  • square.labor.update_scheduled_shiftUpdate Scheduled Shiftwrite
  • square.labor.update_timecardUpdate Timecardwrite
  • square.labor.update_workweek_configUpdate Workweek Configwrite
Orders19
  • square.order_custom_attributes.bulk_delete_order_custom_attributesBulk Delete Order Custom Attributesdestructive
  • square.order_custom_attributes.bulk_upsert_order_custom_attributesBulk Upsert Order Custom Attributeswrite
  • square.order_custom_attributes.create_order_custom_attribute_definitionCreate Order Custom Attribute Definitionwrite
  • square.order_custom_attributes.delete_order_custom_attributeDelete Order Custom Attributedestructive
  • square.order_custom_attributes.delete_order_custom_attribute_definitionDelete Order Custom Attribute Definitiondestructive
  • square.order_custom_attributes.list_order_custom_attribute_definitionsList Order Custom Attribute Definitionsread
  • square.order_custom_attributes.list_order_custom_attributesList Order Custom Attributesread
  • square.order_custom_attributes.retrieve_order_custom_attributeRetrieve Order Custom Attributeread
  • square.order_custom_attributes.retrieve_order_custom_attribute_definitionRetrieve Order Custom Attribute Definitionread
  • square.order_custom_attributes.update_order_custom_attribute_definitionUpdate Order Custom Attribute Definitionwrite
  • square.order_custom_attributes.upsert_order_custom_attributeUpsert Order Custom Attributewrite
  • square.orders.batch_retrieve_ordersBatch Retrieve Ordersread
  • square.orders.calculate_orderCalculate Orderread
  • square.orders.clone_orderClone Orderwrite
  • square.orders.create_orderCreate Orderwrite
  • square.orders.pay_orderPay Orderdestructive
  • square.orders.retrieve_orderRetrieve Orderread
  • square.orders.search_ordersSearch Ordersread
  • square.orders.update_orderUpdate Orderwrite
Loyalty17
  • square.loyalty.accumulate_loyalty_pointsAccumulate Loyalty Pointswrite
  • square.loyalty.adjust_loyalty_pointsAdjust Loyalty Pointswrite
  • square.loyalty.calculate_loyalty_pointsCalculate Loyalty Pointsread
  • square.loyalty.cancel_loyalty_promotionCancel Loyalty Promotiondestructive
  • square.loyalty.create_loyalty_accountCreate Loyalty Accountwrite
  • square.loyalty.create_loyalty_promotionCreate Loyalty Promotionwrite
  • square.loyalty.create_loyalty_rewardCreate Loyalty Rewardwrite
  • square.loyalty.delete_loyalty_rewardDelete Loyalty Rewarddestructive
  • square.loyalty.list_loyalty_promotionsList Loyalty Promotionsread
  • square.loyalty.redeem_loyalty_rewardRedeem Loyalty Rewardwrite
  • square.loyalty.retrieve_loyalty_accountRetrieve Loyalty Accountread
  • square.loyalty.retrieve_loyalty_programRetrieve Loyalty Programread
  • square.loyalty.retrieve_loyalty_promotionRetrieve Loyalty Promotionread
  • square.loyalty.retrieve_loyalty_rewardRetrieve Loyalty Rewardread
  • square.loyalty.search_loyalty_accountsSearch Loyalty Accountsread
  • square.loyalty.search_loyalty_eventsSearch Loyalty Eventsread
  • square.loyalty.search_loyalty_rewardsSearch Loyalty Rewardsread
Payments17
  • square.cards.create_cardCreate Cardwrite
  • square.cards.disable_cardDisable Cardwrite
  • square.cards.list_cardsList Cardsread
  • square.cards.retrieve_cardRetrieve Cardread
  • square.payments.cancel_paymentCancel Paymentdestructive
  • square.payments.cancel_payment_by_idempotency_keyCancel Payment By Idempotency Keydestructive
  • square.payments.complete_paymentComplete Paymentdestructive
  • square.payments.create_paymentCreate Paymentdestructive
  • square.payments.get_paymentGet Paymentread
  • square.payments.list_paymentsList Paymentsread
  • square.payments.update_paymentUpdate Paymentwrite
  • square.payouts.get_payoutGet Payoutread
  • square.payouts.list_payout_entriesList Payout Entriesread
  • square.payouts.list_payoutsList Payoutsread
  • square.refunds.get_payment_refundGet Payment Refundread
  • square.refunds.list_payment_refundsList Payment Refundsread
  • square.refunds.refund_paymentRefund Paymentdestructive
Locations15
  • square.location_custom_attributes.bulk_delete_location_custom_attributesBulk Delete Location Custom Attributesdestructive
  • square.location_custom_attributes.bulk_upsert_location_custom_attributesBulk Upsert Location Custom Attributeswrite
  • square.location_custom_attributes.create_location_custom_attribute_definitionCreate Location Custom Attribute Definitionwrite
  • square.location_custom_attributes.delete_location_custom_attributeDelete Location Custom Attributedestructive
  • square.location_custom_attributes.delete_location_custom_attribute_definitionDelete Location Custom Attribute Definitiondestructive
  • square.location_custom_attributes.list_location_custom_attribute_definitionsList Location Custom Attribute Definitionsread
  • square.location_custom_attributes.list_location_custom_attributesList Location Custom Attributesread
  • square.location_custom_attributes.retrieve_location_custom_attributeRetrieve Location Custom Attributeread
  • square.location_custom_attributes.retrieve_location_custom_attribute_definitionRetrieve Location Custom Attribute Definitionread
  • square.location_custom_attributes.update_location_custom_attribute_definitionUpdate Location Custom Attribute Definitionwrite
  • square.location_custom_attributes.upsert_location_custom_attributeUpsert Location Custom Attributewrite
  • square.locations.create_locationCreate Locationwrite
  • square.locations.list_locationsList Locationsread
  • square.locations.retrieve_locationRetrieve Locationread
  • square.locations.update_locationUpdate Locationwrite
Catalog14
  • square.catalog.batch_delete_catalog_objectsBatch Delete Catalog Objectsdestructive
  • square.catalog.batch_retrieve_catalog_objectsBatch Retrieve Catalog Objectsread
  • square.catalog.batch_upsert_catalog_objectsBatch Upsert Catalog Objectswrite
  • square.catalog.catalog_infoCatalog Inforead
  • square.catalog.create_catalog_imageCreate Catalog Imagewrite
  • square.catalog.delete_catalog_objectDelete Catalog Objectdestructive
  • square.catalog.list_catalogList Catalogread
  • square.catalog.retrieve_catalog_objectRetrieve Catalog Objectread
  • square.catalog.search_catalog_itemsSearch Catalog Itemsread
  • square.catalog.search_catalog_objectsSearch Catalog Objectsread
  • square.catalog.update_catalog_imageUpdate Catalog Imagewrite
  • square.catalog.update_item_modifier_listsUpdate Item Modifier Listswrite
  • square.catalog.update_item_taxesUpdate Item Taxeswrite
  • square.catalog.upsert_catalog_objectUpsert Catalog Objectwrite
Accounts13
  • square.merchant_custom_attributes.bulk_delete_merchant_custom_attributesBulk Delete Merchant Custom Attributesdestructive
  • square.merchant_custom_attributes.bulk_upsert_merchant_custom_attributesBulk Upsert Merchant Custom Attributeswrite
  • square.merchant_custom_attributes.create_merchant_custom_attribute_definitionCreate Merchant Custom Attribute Definitionwrite
  • square.merchant_custom_attributes.delete_merchant_custom_attributeDelete Merchant Custom Attributedestructive
  • square.merchant_custom_attributes.delete_merchant_custom_attribute_definitionDelete Merchant Custom Attribute Definitiondestructive
  • square.merchant_custom_attributes.list_merchant_custom_attribute_definitionsList Merchant Custom Attribute Definitionsread
  • square.merchant_custom_attributes.list_merchant_custom_attributesList Merchant Custom Attributesread
  • square.merchant_custom_attributes.retrieve_merchant_custom_attributeRetrieve Merchant Custom Attributeread
  • square.merchant_custom_attributes.retrieve_merchant_custom_attribute_definitionRetrieve Merchant Custom Attribute Definitionread
  • square.merchant_custom_attributes.update_merchant_custom_attribute_definitionUpdate Merchant Custom Attribute Definitionwrite
  • square.merchant_custom_attributes.upsert_merchant_custom_attributeUpsert Merchant Custom Attributewrite
  • square.merchants.list_merchantsList Merchantsread
  • square.merchants.retrieve_merchantRetrieve Merchantread
Billing12
  • square.subscriptions.bulk_swap_planBulk Swap Planwrite
  • square.subscriptions.cancel_subscriptionCancel Subscriptiondestructive
  • square.subscriptions.change_billing_anchor_dateChange Billing Anchor Datewrite
  • square.subscriptions.create_subscriptionCreate Subscriptionwrite
  • square.subscriptions.delete_subscription_actionDelete Subscription Actiondestructive
  • square.subscriptions.list_subscription_eventsList Subscription Eventsread
  • square.subscriptions.pause_subscriptionPause Subscriptionwrite
  • square.subscriptions.resume_subscriptionResume Subscriptionwrite
  • square.subscriptions.retrieve_subscriptionRetrieve Subscriptionread
  • square.subscriptions.search_subscriptionsSearch Subscriptionsread
  • square.subscriptions.swap_planSwap Planwrite
  • square.subscriptions.update_subscriptionUpdate Subscriptionwrite
Team12
  • square.team.bulk_create_team_membersBulk Create Team Memberswrite
  • square.team.bulk_update_team_membersBulk Update Team Memberswrite
  • square.team.create_jobCreate Jobwrite
  • square.team.create_team_memberCreate Team Memberwrite
  • square.team.list_jobsList Jobsread
  • square.team.retrieve_jobRetrieve Jobread
  • square.team.retrieve_team_memberRetrieve Team Memberread
  • square.team.retrieve_wage_settingRetrieve Wage Settingread
  • square.team.search_team_membersSearch Team Membersread
  • square.team.update_jobUpdate Jobwrite
  • square.team.update_team_memberUpdate Team Memberwrite
  • square.team.update_wage_settingUpdate Wage Settingwrite
Invoicing10
  • square.invoices.cancel_invoiceCancel Invoicedestructive
  • square.invoices.create_invoiceCreate Invoicewrite
  • square.invoices.create_invoice_attachmentCreate Invoice Attachmentwrite
  • square.invoices.delete_invoiceDelete Invoicedestructive
  • square.invoices.delete_invoice_attachmentDelete Invoice Attachmentdestructive
  • square.invoices.get_invoiceGet Invoiceread
  • square.invoices.list_invoicesList Invoicesread
  • square.invoices.publish_invoicePublish Invoicewrite
  • square.invoices.search_invoicesSearch Invoicesread
  • square.invoices.update_invoiceUpdate Invoicewrite
Checkout9
  • square.checkout.create_payment_linkCreate Payment Linkwrite
  • square.checkout.delete_payment_linkDelete Payment Linkdestructive
  • square.checkout.list_payment_linksList Payment Linksread
  • square.checkout.retrieve_location_settingsRetrieve Location Settingsread
  • square.checkout.retrieve_merchant_settingsRetrieve Merchant Settingsread
  • square.checkout.retrieve_payment_linkRetrieve Payment Linkread
  • square.checkout.update_location_settingsUpdate Location Settingswrite
  • square.checkout.update_merchant_settingsUpdate Merchant Settingswrite
  • square.checkout.update_payment_linkUpdate Payment Linkwrite
Gift cards9
  • square.gift_card_activities.create_gift_card_activityCreate Gift Card Activitywrite
  • square.gift_card_activities.list_gift_card_activitiesList Gift Card Activitiesread
  • square.gift_cards.create_gift_cardCreate Gift Cardwrite
  • square.gift_cards.link_customer_to_gift_cardLink Customer To Gift Cardwrite
  • square.gift_cards.list_gift_cardsList Gift Cardsread
  • square.gift_cards.retrieve_gift_cardRetrieve Gift Cardread
  • square.gift_cards.retrieve_gift_card_from_ganRetrieve Gift Card From GANread
  • square.gift_cards.retrieve_gift_card_from_nonceRetrieve Gift Card From Nonceread
  • square.gift_cards.unlink_customer_from_gift_cardUnlink Customer From Gift Cardwrite
Disputes9
  • square.disputes.accept_disputeAccept Disputewrite
  • square.disputes.create_dispute_evidence_fileCreate Dispute Evidence Filewrite
  • square.disputes.create_dispute_evidence_textCreate Dispute Evidence Textwrite
  • square.disputes.delete_dispute_evidenceDelete Dispute Evidencedestructive
  • square.disputes.list_dispute_evidenceList Dispute Evidenceread
  • square.disputes.list_disputesList Disputesread
  • square.disputes.retrieve_disputeRetrieve Disputeread
  • square.disputes.retrieve_dispute_evidenceRetrieve Dispute Evidenceread
  • square.disputes.submit_evidenceSubmit Evidencewrite
Webhooks8
  • square.webhooks.create_webhook_subscriptionCreate Webhook Subscriptionwrite
  • square.webhooks.delete_webhook_subscriptionDelete Webhook Subscriptiondestructive
  • square.webhooks.list_webhook_event_typesList Webhook Event Typesread
  • square.webhooks.list_webhook_subscriptionsList Webhook Subscriptionsread
  • square.webhooks.retrieve_webhook_subscriptionRetrieve Webhook Subscriptionread
  • square.webhooks.test_webhook_subscriptionTest Webhook Subscriptionwrite
  • square.webhooks.update_webhook_subscriptionUpdate Webhook Subscriptionwrite
  • square.webhooks.update_webhook_subscription_signature_keyUpdate Webhook Subscription Signature Keywrite
Purchasing7
  • square.vendors.bulk_create_vendorsBulk Create Vendorswrite
  • square.vendors.bulk_retrieve_vendorsBulk Retrieve Vendorsread
  • square.vendors.bulk_update_vendorsBulk Update Vendorswrite
  • square.vendors.create_vendorCreate Vendorwrite
  • square.vendors.retrieve_vendorRetrieve Vendorread
  • square.vendors.search_vendorsSearch Vendorsread
  • square.vendors.update_vendorUpdate Vendorwrite
Banking5
  • square.bank_accounts.create_bank_accountCreate Bank Accountwrite
  • square.bank_accounts.disable_bank_accountDisable Bank Accountdestructive
  • square.bank_accounts.get_bank_accountGet Bank Accountread
  • square.bank_accounts.get_bank_account_by_v1_idGet Bank Account By V1 Idread
  • square.bank_accounts.list_bank_accountsList Bank Accountsread
Auth4
  • square.apple_pay.register_domainRegister Domainwrite
  • square.oauth.obtain_tokenObtain Tokenwrite
  • square.oauth.retrieve_token_statusRetrieve Token Statusread
  • square.oauth.revoke_tokenRevoke Tokendestructive
Events4
  • square.events.disable_eventsDisable Eventswrite
  • square.events.enable_eventsEnable Eventswrite
  • square.events.list_event_typesList Event Typesread
  • square.events.search_eventsSearch Eventsread
Sites4
  • square.sites.list_sitesList Sitesread
  • square.snippets.delete_snippetDelete Snippetdestructive
  • square.snippets.retrieve_snippetRetrieve Snippetread
  • square.snippets.upsert_snippetUpsert Snippetwrite
Channels3
  • square.channels.bulk_retrieve_channelsBulk Retrieve Channelsread
  • square.channels.list_channelsList Channelsread
  • square.channels.retrieve_channelRetrieve Channelread

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.

Give your agent Square today.

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