# Square MCP tools for AI agents

Source: https://corespeed.io/catalog/square

Connect Square to Claude Code, Codex, Cursor or any MCP agent through CoreSpeed. Read a Square seller's merchant profile, locations, customers, orders, payments, refunds, catalog and invoices; create and update customers, orders, catalog objects and invoices. Your agent works through your own Square account and gets 30 Square tools; CoreSpeed holds the credential, so the agent never sees the token. Calling it is free.

## Tools

- `square__get_merchant`: Fetch the connected Square seller's merchant profile (merchant id, business name, country, currency, status).
- `square__list_locations`: List all of the seller's locations, including inactive ones. Most other Square calls need a location id from here.
- `square__get_location`: Fetch one location. Pass "main" as the location id for the seller's main location.
- `square__list_customers`: List the seller's customer profiles. Newly created profiles can take up to a minute to appear.
- `square__get_customer`: Fetch one customer profile by id.
- `square__search_customers`: Search customer profiles by email, phone, reference id, creation source, group, segment or created/updated time range.
- `square__create_customer`: Create a customer profile. At least one of given_name, family_name, company_name, email_address or phone_number is required.
- `square__update_customer`: Update a customer profile. Sparse: only the fields you pass change, and an explicit null clears one. Pass version for optimistic concurrency.
- `square__delete_customer`: Delete a customer profile. This cannot be undone.
- `square__search_orders`: Search orders across locations — every sale, return and exchange, whatever entered them (Point of Sale, invoices, APIs).
- `square__get_order`: Fetch one order by id, with its line items and totals.
- `square__create_order`: Create an order. Creating an order does not take payment — this connector never charges a card.
- `square__update_order`: Update an open order. Send a sparse order carrying its current version; COMPLETED and CANCELED orders cannot be updated.
- `square__list_payments`: List payments taken by the seller, filterable by time range, location, amount and card. Read-only — this connector cannot take payments.
- `square__get_payment`: Fetch one payment by id.
- `square__list_refunds`: List refunds on the seller's payments. Read-only — this connector cannot issue refunds.
- `square__get_refund`: Fetch one refund by id.
- `square__search_catalog_objects`: Search any catalog object type (items, variations, categories, taxes, discounts, modifiers, images) by attribute queries.
- `square__search_catalog_items`: Search items and item variations by name/description text, category, product type, stock level or enabled location.
- `square__get_catalog_object`: Fetch one catalog object by id, optionally with the objects it references.
- `square__upsert_catalog_object`: Create or replace one catalog object. FULL REPLACEMENT: any field you omit is cleared and omitted inline children (such as item variations) are deleted, so send the complete object.
- `square__delete_catalog_object`: Delete one catalog object. Cascades — deleting an item also deletes its variations.
- `square__list_invoices`: List the invoices for one location.
- `square__search_invoices`: Search invoices at a location, optionally narrowed to specific customers. Square accepts exactly one location and one customer today.
- `square__get_invoice`: Fetch one invoice by id, including its current version.
- `square__create_invoice`: Create a DRAFT invoice for an existing order. Nothing is sent or charged until publish_invoice runs.
- `square__update_invoice`: Update an invoice. Sparse, and the invoice's current version is required inside the invoice object; order_id and location_id cannot change.
- `square__publish_invoice`: Publish a draft invoice, which makes Square act on it — typically emailing it to the customer. Only email/share delivery works here: this connector holds no PAYMENTS_WRITE grant, so an invoice configured to charge a card on file will be refused.
- `square__cancel_invoice`: Cancel a published invoice so no further payment can be collected. Does not work on a DRAFT or on an invoice already PAID, REFUNDED, CANCELED or FAILED.
- `square__delete_invoice`: Delete a DRAFT invoice; the associated order becomes CANCELED. Published invoices cannot be deleted — cancel them instead.

## Questions

### Does Square need my own account?

Yes. Connect your own Square account once; CoreSpeed holds the credential, and your agents get tools, never the token.

### What does Square cost on CoreSpeed?

Calling it is free.

### Which agents can use Square?

Any MCP client, such as Claude Code, Codex, or Cursor. Give your agent the setup line, and the tools join its tool list. Set up an agent: https://corespeed.io/docs/mcp

## Related pages

- [Square for Claude Code, Codex, and Cursor](https://corespeed.io/integrations/square): Ask your agent about Square orders, payments and customers, and draft invoices you review before they go out.

## Links

- Catalog: https://corespeed.io/catalog
- Set up an agent: https://corespeed.io/SKILL.md
- Pricing: https://corespeed.io/pricing (Markdown: https://corespeed.io/pricing.md)
