Square MCP Server
Connect AI agents to the full Square API — payments, orders, inventory, and customers — over a hosted MCP server.
Updated
What is Square MCP?
The Square MCP server is a Model Context Protocol server that connects AI agents and assistants directly to the full Square API platform — including payments, orders, inventory, and customer management.
Maintained by Square (a Block company), it ships in two forms. Square hosts a remote server at https://mcp.squareup.com/sse that authenticates with OAuth: you sign in with your Square account and grant only the scopes the agent needs, with no manual access-token management. This is the recommended option. Alternatively, you can self-host the open-source server (npx square-mcp-server start) and supply a Square ACCESS_TOKEN yourself, with a sandbox mode for testing.
Rather than exposing a separate tool per Square endpoint, the server uses a small, discovery-oriented toolset: the agent first lists available services and inspects parameter requirements, then issues calls against the Square REST API. This keeps the surface area compact while still giving the agent access to Square's complete API ecosystem.
Tools the Square MCP server exposes
| Tool | What it does |
|---|---|
| get_service_info | Discover the methods and operations available for a given Square API service. |
| get_type_info | Get detailed parameter requirements and type information for a Square API call. |
| make_api_request | Execute a call against the Square REST API (payments, orders, inventory, customers, and more). |
Connect the Square MCP server
Claude (Desktop / Code)
- 1
Add the remote MCP server
In your MCP config (e.g. claude_desktop_config.json), add a server that runs: npx mcp-remote https://mcp.squareup.com/sse
- 2
Restart the client
Restart Claude so it picks up the new mcpServers entry.
- 3
Authorize with OAuth
On first use, a browser window opens to sign in with your Square account and grant the requested scopes.
- 4
Verify
Ask the agent to list available Square services to confirm the connection is live.
Uses the hosted remote server with OAuth — no access token to manage.
Cursor
- 1
Open MCP settings
In Cursor, open Settings → MCP and add a new server.
- 2
Configure the server
Add a server with command npx and args: mcp-remote https://mcp.squareup.com/sse
- 3
Sign in with Square
Complete the OAuth login in the browser to authorize the scopes the agent needs.
- 4
Test
Prompt the agent to fetch a Square resource (e.g. recent orders) to verify access.
Square lists Cursor as a supported client; point it at the same hosted endpoint.
Security & permissions
The recommended hosted server uses OAuth: you sign in with your Square account and authorize only the scopes the agent needs, so there are no long-lived tokens to copy or rotate. The agent's access is bounded by the granted scopes and your Square account permissions — it can read and write the Square resources you consent to (payments, orders, inventory, customers). For the self-hosted option you instead provide a Square ACCESS_TOKEN via environment variable, and a sandbox mode is available for safe testing. Treat any access token as a secret and prefer the OAuth flow where possible.
Using Square MCP with Gamut
In a Gamut workflow, Square becomes a connected tool an agent can call on a schedule or in response to an event — for example, a nightly run that reconciles the day's orders and payments, flags low-inventory items, or syncs new customers into another system. Gamut manages the connection and credentials, so the agent can discover the relevant Square services and issue API calls as a step in a larger automated pipeline without you wiring up OAuth or token handling by hand.
Frequently asked questions
What is the Square MCP server?
It is Square's official Model Context Protocol server that lets AI agents call the full Square API — payments, orders, inventory, and customer management — through a standard MCP interface, either via Square's hosted endpoint or a self-hosted instance.
Is the Square MCP server free?
There is no separate charge for the MCP server itself; it is open source and Square also hosts it. You authenticate against your own Square account, so normal Square account terms and payment-processing fees still apply.
Is it hosted or self-hosted?
Both. Square hosts a remote server at https://mcp.squareup.com/sse (recommended, with OAuth login), or you can run the open-source server yourself with npx square-mcp-server start and supply your own Square access token.
How do I connect the Square MCP server to Claude or Cursor?
Add a remote MCP server that runs npx mcp-remote https://mcp.squareup.com/sse in your client's MCP config, restart the client, then complete the OAuth sign-in with your Square account when prompted.