MCPHIVE

Square MCP: Documentation

Updated:

Connection

  • Remote (recommended): https://mcp.squareup.com/sse via npx mcp-remote https://mcp.squareup.com/sse — sign in with your Square account via OAuth, no token to create.
  • Local: ACCESS_TOKEN=... SANDBOX=true npx square-mcp-server start (stdio). Env vars: ACCESS_TOKEN, SANDBOX/PRODUCTION, DISALLOW_WRITES (read-only), SQUARE_VERSION.
  • The server is in Beta: Square maintains an allowlist of MCP clients to guard against malicious registration.

Tools

Just 3 universal tools over the full Square API:

  • get_service_info(service) — which methods a service offers.
  • get_type_info(service, method) — which parameters a method needs.
  • make_api_request(service, method, request) — execute the call.

Services (service): customers, orders, catalog, payments, refunds, disputes, invoices, bookings, subscriptions, inventory, loyalty, team, terminal, payouts, giftcards, webhooksubscriptions and more — see the full list in the README.

Agent flow

"Find a free staff slot tomorrow at 3pm and book Anna Lee", "issue a $25 refund on payment abc123", "show me stock levels for item X", "create an invoice for a client next week".

Important

The ACCESS_TOKEN grants access to the seller's money and data. Start with SANDBOX=true, and for read-only flows use DISALLOW_WRITES=true — it rules out accidental charges or catalog changes.

Pricing

The MCP server is free; processing fees follow Square's regular rates for payments and services (bookings, invoices, etc.).

Square MCP — Documentation