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/mcpdo { 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.
- 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 - 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 tokenapi_hostWhere your Square lives: your api host
account { op: "connections.requirements", service: "square" } # free: exactly what to paste, and what is found for you - 03
Make the first call. Check before a write.
Ask in plain words; Claude picks the action. Before anything changes,
checkvalidates 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-19
connect.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
Customers
2912 read · 11 write · 6 destructive
List Customers · Create Customer · Retrieve Customer · Bulk Update Customers
Bookings
2414 read · 6 write · 4 destructive
Retrieve Business Booking Profile · List Bookings · Create Booking · Retrieve Booking
POS
2313 read · 3 write · 7 destructive
Create Terminal Checkout · Create Terminal Refund · Get Terminal Checkout · Get Terminal Refund
Inventory
219 read · 9 write · 3 destructive
Batch Change Inventory · Receive Transfer Order · Create Transfer Order · Retrieve Inventory Count
Labor
209 read · 9 write · 2 destructive
List Break Types · Create Scheduled Shift · Create Timecard · List Team Member Wages
Orders
198 read · 7 write · 4 destructive
Clone Order · Create Order · Retrieve Order · Search Orders
Loyalty
179 read · 6 write · 2 destructive
Create Loyalty Promotion · List Loyalty Promotions · Retrieve Loyalty Promotion · Cancel Loyalty Promotion
Payments
179 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.
| Action | What it does | Effect | Same name in |
|---|---|---|---|
square.catalog.list_catalogList Catalog | ListCatalog | read | commerce.product.list112 connectors |
square.customers.list_customersList Customers | ListCustomers | read | commerce.customer.list45 connectors |
square.locations.list_locationsList Locations | ListLocations | read | commerce.warehouse.list32 connectors |
square.invoices.list_invoicesList Invoices | ListInvoices | read | finance.invoice.list101 connectors |
square.payments.list_paymentsList Payments | ListPayments | read | finance.payment.list75 connectors |
square.orders.clone_orderClone Order | CloneOrder | write | commerce.order.create67 connectors |
square.orders.create_orderCreate Order | CreateOrder | write | commerce.order.create67 connectors |
square.catalog.retrieve_catalog_objectRetrieve Catalog Object | RetrieveCatalogObject | read | commerce.product.get112 connectors |
square.customers.create_customerCreate Customer | CreateCustomer | write | commerce.customer.create43 connectors |
square.locations.create_locationCreate Location | CreateLocation | write | commerce.warehouse.create20 connectors |
square.catalog.delete_catalog_objectDelete Catalog Object | DeleteCatalogObject | destructive | commerce.product.delete80 connectors |
square.invoices.create_invoiceCreate Invoice | CreateInvoice | write | finance.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.
- Readread
Which Square invoices are more than 30 days overdue? Group them by customer with the total owed.
calls
square.invoices.list_invoices - Planread
Daily payments and payouts report in Square.
calls
square.locations.retrieve_locationsquare.payments.list_paymentssquare.refunds.list_payment_refundssquare.payouts.list_payoutssquare.payouts.get_payout - Planwrite
Build an evidence package for a dispute in Square. Ask me before anything is sent or changed.
calls
square.disputes.retrieve_disputesquare.payments.get_paymentsquare.disputes.list_dispute_evidencesquare.disputes.create_dispute_evidence_textsquare.disputes.accept_dispute - Writewrite
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
account { op: "plans.install", slug: "square-daily-payments-and-payouts-report" }
# then ask for it by name; a schedule can run it on a timetableGovernance 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.
Delete Catalog Object?
intent: the user asked me to delete Catalog Object
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]" } ]}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
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 Attributeswritesquare.customer_custom_attributes.create_customer_custom_attribute_definitionCreate Customer Custom Attribute Definitionwritesquare.customer_custom_attributes.delete_customer_custom_attributeDelete Customer Custom Attributedestructivesquare.customer_custom_attributes.delete_customer_custom_attribute_definitionDelete Customer Custom Attribute Definitiondestructivesquare.customer_custom_attributes.list_customer_custom_attribute_definitionsList Customer Custom Attribute Definitionsreadsquare.customer_custom_attributes.list_customer_custom_attributesList Customer Custom Attributesreadsquare.customer_custom_attributes.retrieve_customer_custom_attributeRetrieve Customer Custom Attributereadsquare.customer_custom_attributes.retrieve_customer_custom_attribute_definitionRetrieve Customer Custom Attribute Definitionreadsquare.customer_custom_attributes.update_customer_custom_attribute_definitionUpdate Customer Custom Attribute Definitionwritesquare.customer_custom_attributes.upsert_customer_custom_attributeUpsert Customer Custom Attributewritesquare.customer_groups.create_customer_groupCreate Customer Groupwritesquare.customer_groups.delete_customer_groupDelete Customer Groupdestructivesquare.customer_groups.list_customer_groupsList Customer Groupsreadsquare.customer_groups.retrieve_customer_groupRetrieve Customer Groupreadsquare.customer_groups.update_customer_groupUpdate Customer Groupwritesquare.customer_segments.list_customer_segmentsList Customer Segmentsreadsquare.customer_segments.retrieve_customer_segmentRetrieve Customer Segmentreadsquare.customers.add_group_to_customerAdd Group To Customerwritesquare.customers.bulk_create_customersBulk Create Customerswritesquare.customers.bulk_delete_customersBulk Delete Customersdestructivesquare.customers.bulk_retrieve_customersBulk Retrieve Customersreadsquare.customers.bulk_update_customersBulk Update Customerswritesquare.customers.create_customerCreate Customerwritesquare.customers.delete_customerDelete Customerdestructivesquare.customers.list_customersList Customersreadsquare.customers.remove_group_from_customerRemove Group From Customerdestructivesquare.customers.retrieve_customerRetrieve Customerreadsquare.customers.search_customersSearch Customersreadsquare.customers.update_customerUpdate Customerwrite
Bookings24
square.booking_custom_attributes.bulk_delete_booking_custom_attributesBulk Delete Booking Custom Attributesdestructivesquare.booking_custom_attributes.bulk_upsert_booking_custom_attributesBulk Upsert Booking Custom Attributeswritesquare.booking_custom_attributes.create_booking_custom_attribute_definitionCreate Booking Custom Attribute Definitionwritesquare.booking_custom_attributes.delete_booking_custom_attributeDelete Booking Custom Attributedestructivesquare.booking_custom_attributes.delete_booking_custom_attribute_definitionDelete Booking Custom Attribute Definitiondestructivesquare.booking_custom_attributes.list_booking_custom_attribute_definitionsList Booking Custom Attribute Definitionsreadsquare.booking_custom_attributes.list_booking_custom_attributesList Booking Custom Attributesreadsquare.booking_custom_attributes.retrieve_booking_custom_attributeRetrieve Booking Custom Attributereadsquare.booking_custom_attributes.retrieve_booking_custom_attribute_definitionRetrieve Booking Custom Attribute Definitionreadsquare.booking_custom_attributes.update_booking_custom_attribute_definitionUpdate Booking Custom Attribute Definitionwritesquare.booking_custom_attributes.upsert_booking_custom_attributeUpsert Booking Custom Attributewritesquare.bookings.bulk_retrieve_bookingsBulk Retrieve Bookingsreadsquare.bookings.bulk_retrieve_team_member_booking_profilesBulk Retrieve Team Member Booking Profilesreadsquare.bookings.cancel_bookingCancel Bookingdestructivesquare.bookings.create_bookingCreate Bookingwritesquare.bookings.list_bookingsList Bookingsreadsquare.bookings.list_location_booking_profilesList Location Booking Profilesreadsquare.bookings.list_team_member_booking_profilesList Team Member Booking Profilesreadsquare.bookings.retrieve_bookingRetrieve Bookingreadsquare.bookings.retrieve_business_booking_profileRetrieve Business Booking Profilereadsquare.bookings.retrieve_location_booking_profileRetrieve Location Booking Profilereadsquare.bookings.retrieve_team_member_booking_profileRetrieve Team Member Booking Profilereadsquare.bookings.search_availabilitySearch Availabilityreadsquare.bookings.update_bookingUpdate Bookingwrite
POS23
square.cash_drawers.list_cash_drawer_shift_eventsList Cash Drawer Shift Eventsreadsquare.cash_drawers.list_cash_drawer_shiftsList Cash Drawer Shiftsreadsquare.cash_drawers.retrieve_cash_drawer_shiftRetrieve Cash Drawer Shiftreadsquare.devices.create_device_codeCreate Device Codewritesquare.devices.get_deviceGet Devicereadsquare.devices.get_device_codeGet Device Codereadsquare.devices.list_device_codesList Device Codesreadsquare.devices.list_devicesList Devicesreadsquare.terminal.cancel_terminal_actionCancel Terminal Actiondestructivesquare.terminal.cancel_terminal_checkoutCancel Terminal Checkoutdestructivesquare.terminal.cancel_terminal_refundCancel Terminal Refunddestructivesquare.terminal.create_terminal_actionCreate Terminal Actionwritesquare.terminal.create_terminal_checkoutCreate Terminal Checkoutwritesquare.terminal.create_terminal_refundCreate Terminal Refunddestructivesquare.terminal.dismiss_terminal_actionDismiss Terminal Actiondestructivesquare.terminal.dismiss_terminal_checkoutDismiss Terminal Checkoutdestructivesquare.terminal.dismiss_terminal_refundDismiss Terminal Refunddestructivesquare.terminal.get_terminal_actionGet Terminal Actionreadsquare.terminal.get_terminal_checkoutGet Terminal Checkoutreadsquare.terminal.get_terminal_refundGet Terminal Refundreadsquare.terminal.search_terminal_actionsSearch Terminal Actionsreadsquare.terminal.search_terminal_checkoutsSearch Terminal Checkoutsreadsquare.terminal.search_terminal_refundsSearch Terminal Refundsread
Inventory21
square.inventory.batch_change_inventoryBatch Change Inventorywritesquare.inventory.batch_retrieve_inventory_changesBatch Retrieve Inventory Changesreadsquare.inventory.batch_retrieve_inventory_countsBatch Retrieve Inventory Countsreadsquare.inventory.create_inventory_adjustment_reasonCreate Inventory Adjustment Reasonwritesquare.inventory.delete_inventory_adjustment_reasonDelete Inventory Adjustment Reasondestructivesquare.inventory.list_inventory_adjustment_reasonsList Inventory Adjustment Reasonsreadsquare.inventory.restore_inventory_adjustment_reasonRestore Inventory Adjustment Reasonwritesquare.inventory.retrieve_inventory_adjustmentRetrieve Inventory Adjustmentreadsquare.inventory.retrieve_inventory_adjustment_reasonRetrieve Inventory Adjustment Reasonreadsquare.inventory.retrieve_inventory_countRetrieve Inventory Countreadsquare.inventory.retrieve_inventory_physical_countRetrieve Inventory Physical Countreadsquare.inventory.update_inventory_adjustmentUpdate Inventory Adjustmentwritesquare.inventory.update_inventory_adjustment_reasonUpdate Inventory Adjustment Reasonwritesquare.transfer_orders.cancel_transfer_orderCancel Transfer Orderdestructivesquare.transfer_orders.create_transfer_orderCreate Transfer Orderwritesquare.transfer_orders.delete_transfer_orderDelete Transfer Orderdestructivesquare.transfer_orders.receive_transfer_orderReceive Transfer Orderwritesquare.transfer_orders.retrieve_transfer_orderRetrieve Transfer Orderreadsquare.transfer_orders.search_transfer_ordersSearch Transfer Ordersreadsquare.transfer_orders.start_transfer_orderStart Transfer Orderwritesquare.transfer_orders.update_transfer_orderUpdate Transfer Orderwrite
Labor20
square.labor.bulk_publish_scheduled_shiftsBulk Publish Scheduled Shiftswritesquare.labor.create_break_typeCreate Break Typewritesquare.labor.create_scheduled_shiftCreate Scheduled Shiftwritesquare.labor.create_timecardCreate Timecardwritesquare.labor.delete_break_typeDelete Break Typedestructivesquare.labor.delete_timecardDelete Timecarddestructivesquare.labor.get_break_typeGet Break Typereadsquare.labor.get_team_member_wageGet Team Member Wagereadsquare.labor.list_break_typesList Break Typesreadsquare.labor.list_team_member_wagesList Team Member Wagesreadsquare.labor.list_workweek_configsList Workweek Configsreadsquare.labor.publish_scheduled_shiftPublish Scheduled Shiftwritesquare.labor.retrieve_scheduled_shiftRetrieve Scheduled Shiftreadsquare.labor.retrieve_timecardRetrieve Timecardreadsquare.labor.search_scheduled_shiftsSearch Scheduled Shiftsreadsquare.labor.search_timecardsSearch Timecardsreadsquare.labor.update_break_typeUpdate Break Typewritesquare.labor.update_scheduled_shiftUpdate Scheduled Shiftwritesquare.labor.update_timecardUpdate Timecardwritesquare.labor.update_workweek_configUpdate Workweek Configwrite
Orders19
square.order_custom_attributes.bulk_delete_order_custom_attributesBulk Delete Order Custom Attributesdestructivesquare.order_custom_attributes.bulk_upsert_order_custom_attributesBulk Upsert Order Custom Attributeswritesquare.order_custom_attributes.create_order_custom_attribute_definitionCreate Order Custom Attribute Definitionwritesquare.order_custom_attributes.delete_order_custom_attributeDelete Order Custom Attributedestructivesquare.order_custom_attributes.delete_order_custom_attribute_definitionDelete Order Custom Attribute Definitiondestructivesquare.order_custom_attributes.list_order_custom_attribute_definitionsList Order Custom Attribute Definitionsreadsquare.order_custom_attributes.list_order_custom_attributesList Order Custom Attributesreadsquare.order_custom_attributes.retrieve_order_custom_attributeRetrieve Order Custom Attributereadsquare.order_custom_attributes.retrieve_order_custom_attribute_definitionRetrieve Order Custom Attribute Definitionreadsquare.order_custom_attributes.update_order_custom_attribute_definitionUpdate Order Custom Attribute Definitionwritesquare.order_custom_attributes.upsert_order_custom_attributeUpsert Order Custom Attributewritesquare.orders.batch_retrieve_ordersBatch Retrieve Ordersreadsquare.orders.calculate_orderCalculate Orderreadsquare.orders.clone_orderClone Orderwritesquare.orders.create_orderCreate Orderwritesquare.orders.pay_orderPay Orderdestructivesquare.orders.retrieve_orderRetrieve Orderreadsquare.orders.search_ordersSearch Ordersreadsquare.orders.update_orderUpdate Orderwrite
Loyalty17
square.loyalty.accumulate_loyalty_pointsAccumulate Loyalty Pointswritesquare.loyalty.adjust_loyalty_pointsAdjust Loyalty Pointswritesquare.loyalty.calculate_loyalty_pointsCalculate Loyalty Pointsreadsquare.loyalty.cancel_loyalty_promotionCancel Loyalty Promotiondestructivesquare.loyalty.create_loyalty_accountCreate Loyalty Accountwritesquare.loyalty.create_loyalty_promotionCreate Loyalty Promotionwritesquare.loyalty.create_loyalty_rewardCreate Loyalty Rewardwritesquare.loyalty.delete_loyalty_rewardDelete Loyalty Rewarddestructivesquare.loyalty.list_loyalty_promotionsList Loyalty Promotionsreadsquare.loyalty.redeem_loyalty_rewardRedeem Loyalty Rewardwritesquare.loyalty.retrieve_loyalty_accountRetrieve Loyalty Accountreadsquare.loyalty.retrieve_loyalty_programRetrieve Loyalty Programreadsquare.loyalty.retrieve_loyalty_promotionRetrieve Loyalty Promotionreadsquare.loyalty.retrieve_loyalty_rewardRetrieve Loyalty Rewardreadsquare.loyalty.search_loyalty_accountsSearch Loyalty Accountsreadsquare.loyalty.search_loyalty_eventsSearch Loyalty Eventsreadsquare.loyalty.search_loyalty_rewardsSearch Loyalty Rewardsread
Payments17
square.cards.create_cardCreate Cardwritesquare.cards.disable_cardDisable Cardwritesquare.cards.list_cardsList Cardsreadsquare.cards.retrieve_cardRetrieve Cardreadsquare.payments.cancel_paymentCancel Paymentdestructivesquare.payments.cancel_payment_by_idempotency_keyCancel Payment By Idempotency Keydestructivesquare.payments.complete_paymentComplete Paymentdestructivesquare.payments.create_paymentCreate Paymentdestructivesquare.payments.get_paymentGet Paymentreadsquare.payments.list_paymentsList Paymentsreadsquare.payments.update_paymentUpdate Paymentwritesquare.payouts.get_payoutGet Payoutreadsquare.payouts.list_payout_entriesList Payout Entriesreadsquare.payouts.list_payoutsList Payoutsreadsquare.refunds.get_payment_refundGet Payment Refundreadsquare.refunds.list_payment_refundsList Payment Refundsreadsquare.refunds.refund_paymentRefund Paymentdestructive
Locations15
square.location_custom_attributes.bulk_delete_location_custom_attributesBulk Delete Location Custom Attributesdestructivesquare.location_custom_attributes.bulk_upsert_location_custom_attributesBulk Upsert Location Custom Attributeswritesquare.location_custom_attributes.create_location_custom_attribute_definitionCreate Location Custom Attribute Definitionwritesquare.location_custom_attributes.delete_location_custom_attributeDelete Location Custom Attributedestructivesquare.location_custom_attributes.delete_location_custom_attribute_definitionDelete Location Custom Attribute Definitiondestructivesquare.location_custom_attributes.list_location_custom_attribute_definitionsList Location Custom Attribute Definitionsreadsquare.location_custom_attributes.list_location_custom_attributesList Location Custom Attributesreadsquare.location_custom_attributes.retrieve_location_custom_attributeRetrieve Location Custom Attributereadsquare.location_custom_attributes.retrieve_location_custom_attribute_definitionRetrieve Location Custom Attribute Definitionreadsquare.location_custom_attributes.update_location_custom_attribute_definitionUpdate Location Custom Attribute Definitionwritesquare.location_custom_attributes.upsert_location_custom_attributeUpsert Location Custom Attributewritesquare.locations.create_locationCreate Locationwritesquare.locations.list_locationsList Locationsreadsquare.locations.retrieve_locationRetrieve Locationreadsquare.locations.update_locationUpdate Locationwrite
Catalog14
square.catalog.batch_delete_catalog_objectsBatch Delete Catalog Objectsdestructivesquare.catalog.batch_retrieve_catalog_objectsBatch Retrieve Catalog Objectsreadsquare.catalog.batch_upsert_catalog_objectsBatch Upsert Catalog Objectswritesquare.catalog.catalog_infoCatalog Inforeadsquare.catalog.create_catalog_imageCreate Catalog Imagewritesquare.catalog.delete_catalog_objectDelete Catalog Objectdestructivesquare.catalog.list_catalogList Catalogreadsquare.catalog.retrieve_catalog_objectRetrieve Catalog Objectreadsquare.catalog.search_catalog_itemsSearch Catalog Itemsreadsquare.catalog.search_catalog_objectsSearch Catalog Objectsreadsquare.catalog.update_catalog_imageUpdate Catalog Imagewritesquare.catalog.update_item_modifier_listsUpdate Item Modifier Listswritesquare.catalog.update_item_taxesUpdate Item Taxeswritesquare.catalog.upsert_catalog_objectUpsert Catalog Objectwrite
Accounts13
square.merchant_custom_attributes.bulk_delete_merchant_custom_attributesBulk Delete Merchant Custom Attributesdestructivesquare.merchant_custom_attributes.bulk_upsert_merchant_custom_attributesBulk Upsert Merchant Custom Attributeswritesquare.merchant_custom_attributes.create_merchant_custom_attribute_definitionCreate Merchant Custom Attribute Definitionwritesquare.merchant_custom_attributes.delete_merchant_custom_attributeDelete Merchant Custom Attributedestructivesquare.merchant_custom_attributes.delete_merchant_custom_attribute_definitionDelete Merchant Custom Attribute Definitiondestructivesquare.merchant_custom_attributes.list_merchant_custom_attribute_definitionsList Merchant Custom Attribute Definitionsreadsquare.merchant_custom_attributes.list_merchant_custom_attributesList Merchant Custom Attributesreadsquare.merchant_custom_attributes.retrieve_merchant_custom_attributeRetrieve Merchant Custom Attributereadsquare.merchant_custom_attributes.retrieve_merchant_custom_attribute_definitionRetrieve Merchant Custom Attribute Definitionreadsquare.merchant_custom_attributes.update_merchant_custom_attribute_definitionUpdate Merchant Custom Attribute Definitionwritesquare.merchant_custom_attributes.upsert_merchant_custom_attributeUpsert Merchant Custom Attributewritesquare.merchants.list_merchantsList Merchantsreadsquare.merchants.retrieve_merchantRetrieve Merchantread
Billing12
square.subscriptions.bulk_swap_planBulk Swap Planwritesquare.subscriptions.cancel_subscriptionCancel Subscriptiondestructivesquare.subscriptions.change_billing_anchor_dateChange Billing Anchor Datewritesquare.subscriptions.create_subscriptionCreate Subscriptionwritesquare.subscriptions.delete_subscription_actionDelete Subscription Actiondestructivesquare.subscriptions.list_subscription_eventsList Subscription Eventsreadsquare.subscriptions.pause_subscriptionPause Subscriptionwritesquare.subscriptions.resume_subscriptionResume Subscriptionwritesquare.subscriptions.retrieve_subscriptionRetrieve Subscriptionreadsquare.subscriptions.search_subscriptionsSearch Subscriptionsreadsquare.subscriptions.swap_planSwap Planwritesquare.subscriptions.update_subscriptionUpdate Subscriptionwrite
Team12
square.team.bulk_create_team_membersBulk Create Team Memberswritesquare.team.bulk_update_team_membersBulk Update Team Memberswritesquare.team.create_jobCreate Jobwritesquare.team.create_team_memberCreate Team Memberwritesquare.team.list_jobsList Jobsreadsquare.team.retrieve_jobRetrieve Jobreadsquare.team.retrieve_team_memberRetrieve Team Memberreadsquare.team.retrieve_wage_settingRetrieve Wage Settingreadsquare.team.search_team_membersSearch Team Membersreadsquare.team.update_jobUpdate Jobwritesquare.team.update_team_memberUpdate Team Memberwritesquare.team.update_wage_settingUpdate Wage Settingwrite
Invoicing10
square.invoices.cancel_invoiceCancel Invoicedestructivesquare.invoices.create_invoiceCreate Invoicewritesquare.invoices.create_invoice_attachmentCreate Invoice Attachmentwritesquare.invoices.delete_invoiceDelete Invoicedestructivesquare.invoices.delete_invoice_attachmentDelete Invoice Attachmentdestructivesquare.invoices.get_invoiceGet Invoicereadsquare.invoices.list_invoicesList Invoicesreadsquare.invoices.publish_invoicePublish Invoicewritesquare.invoices.search_invoicesSearch Invoicesreadsquare.invoices.update_invoiceUpdate Invoicewrite
Checkout9
square.checkout.create_payment_linkCreate Payment Linkwritesquare.checkout.delete_payment_linkDelete Payment Linkdestructivesquare.checkout.list_payment_linksList Payment Linksreadsquare.checkout.retrieve_location_settingsRetrieve Location Settingsreadsquare.checkout.retrieve_merchant_settingsRetrieve Merchant Settingsreadsquare.checkout.retrieve_payment_linkRetrieve Payment Linkreadsquare.checkout.update_location_settingsUpdate Location Settingswritesquare.checkout.update_merchant_settingsUpdate Merchant Settingswritesquare.checkout.update_payment_linkUpdate Payment Linkwrite
Gift cards9
square.gift_card_activities.create_gift_card_activityCreate Gift Card Activitywritesquare.gift_card_activities.list_gift_card_activitiesList Gift Card Activitiesreadsquare.gift_cards.create_gift_cardCreate Gift Cardwritesquare.gift_cards.link_customer_to_gift_cardLink Customer To Gift Cardwritesquare.gift_cards.list_gift_cardsList Gift Cardsreadsquare.gift_cards.retrieve_gift_cardRetrieve Gift Cardreadsquare.gift_cards.retrieve_gift_card_from_ganRetrieve Gift Card From GANreadsquare.gift_cards.retrieve_gift_card_from_nonceRetrieve Gift Card From Noncereadsquare.gift_cards.unlink_customer_from_gift_cardUnlink Customer From Gift Cardwrite
Disputes9
square.disputes.accept_disputeAccept Disputewritesquare.disputes.create_dispute_evidence_fileCreate Dispute Evidence Filewritesquare.disputes.create_dispute_evidence_textCreate Dispute Evidence Textwritesquare.disputes.delete_dispute_evidenceDelete Dispute Evidencedestructivesquare.disputes.list_dispute_evidenceList Dispute Evidencereadsquare.disputes.list_disputesList Disputesreadsquare.disputes.retrieve_disputeRetrieve Disputereadsquare.disputes.retrieve_dispute_evidenceRetrieve Dispute Evidencereadsquare.disputes.submit_evidenceSubmit Evidencewrite
Webhooks8
square.webhooks.create_webhook_subscriptionCreate Webhook Subscriptionwritesquare.webhooks.delete_webhook_subscriptionDelete Webhook Subscriptiondestructivesquare.webhooks.list_webhook_event_typesList Webhook Event Typesreadsquare.webhooks.list_webhook_subscriptionsList Webhook Subscriptionsreadsquare.webhooks.retrieve_webhook_subscriptionRetrieve Webhook Subscriptionreadsquare.webhooks.test_webhook_subscriptionTest Webhook Subscriptionwritesquare.webhooks.update_webhook_subscriptionUpdate Webhook Subscriptionwritesquare.webhooks.update_webhook_subscription_signature_keyUpdate Webhook Subscription Signature Keywrite
Purchasing7
square.vendors.bulk_create_vendorsBulk Create Vendorswritesquare.vendors.bulk_retrieve_vendorsBulk Retrieve Vendorsreadsquare.vendors.bulk_update_vendorsBulk Update Vendorswritesquare.vendors.create_vendorCreate Vendorwritesquare.vendors.retrieve_vendorRetrieve Vendorreadsquare.vendors.search_vendorsSearch Vendorsreadsquare.vendors.update_vendorUpdate Vendorwrite
Banking5
square.bank_accounts.create_bank_accountCreate Bank Accountwritesquare.bank_accounts.disable_bank_accountDisable Bank Accountdestructivesquare.bank_accounts.get_bank_accountGet Bank Accountreadsquare.bank_accounts.get_bank_account_by_v1_idGet Bank Account By V1 Idreadsquare.bank_accounts.list_bank_accountsList Bank Accountsread
Auth4
square.apple_pay.register_domainRegister Domainwritesquare.oauth.obtain_tokenObtain Tokenwritesquare.oauth.retrieve_token_statusRetrieve Token Statusreadsquare.oauth.revoke_tokenRevoke Tokendestructive
Events4
square.events.disable_eventsDisable Eventswritesquare.events.enable_eventsEnable Eventswritesquare.events.list_event_typesList Event Typesreadsquare.events.search_eventsSearch Eventsread
Sites4
square.sites.list_sitesList Sitesreadsquare.snippets.delete_snippetDelete Snippetdestructivesquare.snippets.retrieve_snippetRetrieve Snippetreadsquare.snippets.upsert_snippetUpsert Snippetwrite
Channels3
square.channels.bulk_retrieve_channelsBulk Retrieve Channelsreadsquare.channels.list_channelsList Channelsreadsquare.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.