MCP server · Payments and commerce
Square MCP server
Lets an assistant call the full Square API: customers, orders, catalogue, inventory, payments, invoices, bookings, loyalty and more.
- Maintainer
- Block (Square) (official)
- Licence
- Apache-2.0
- Runs
- Remote (URL)
- Sign-in
- OAuth sign-in in the app
- Last activity
- 2026-04-09
Overview
What it does
The Square MCP Server, currently in beta, connects an assistant to the Square API. Square recommends its remote server at mcp.squareup.com, hosted by Block, where you sign in with your Square account through OAuth and authorise only the scopes you need. The remote server only reaches production data. For testing against a Sandbox, Square documents a local package (npx square-mcp-server start) that takes an ACCESS_TOKEN and SANDBOX=true.
Rather than one tool per endpoint, it uses three tools: discover the methods a service offers, get the parameters a method needs, then make the API request. That gives access to every Square service, from catalogue, customers, orders and payments to inventory, invoices, bookings, gift cards, loyalty, team and terminal. It suits sellers and developers who want natural-language reports or quick admin changes on a Square account. Square keeps an allowlist of approved MCP clients for the remote server.
Tools
What the assistant can do
- get_service_info: discover the methods a Square service offers
- get_type_info: get the parameters a method needs
- make_api_request: call any Square API method
- Covers catalog, customers, orders, payments, refunds and inventory
- Covers invoices, subscriptions, bookings, gift cards, loyalty, team and terminal
Install
Install Square MCP server in your app
You need:
- A Square account
- An MCP client on Square’s allowlist for the remote server
Run in your project. --scope local keeps the servers private to you in this project; use user for every project.
claude mcp add --scope local --transport http square https://mcp.squareup.com/mcp
- square: if the server needs a sign-in, the app will ask (run /mcp in Claude Code).
Project root. Commit it to share the servers with your team; each person sets the variables in their own shell.
{
"mcpServers": {
"square": {
"type": "http",
"url": "https://mcp.squareup.com/mcp"
}
}
}
- square: if the server needs a sign-in, the app will ask (run /mcp in Claude Code).
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json (Settings → Developer → Edit Config). Restart Claude after saving.
{
"mcpServers": {}
}
- square is a remote server: add it as a custom connector (Customize → Connectors → + Add → Add custom connector; on Team and Enterprise plans an owner adds it under Organization settings → Connectors), with the URL https://mcp.squareup.com/mcp.
In your project, or ~/.cursor/mcp.json for every project.
{
"mcpServers": {
"square": {
"url": "https://mcp.squareup.com/mcp"
}
}
}
- square: if the server needs a sign-in, the app will ask.
In your workspace. VS Code asks for each secret the first time a server starts and stores it securely.
{
"servers": {
"square": {
"type": "http",
"url": "https://mcp.squareup.com/mcp"
}
}
}
- square: if the server needs a sign-in, the app will ask.
macOS/Linux: ~/.config/devin/mcp_config.json · Windows: %APPDATA%\devin\mcp_config.json. Read by the default Devin Local agent and by the legacy Cascade agent.
{
"mcpServers": {
"square": {
"url": "https://mcp.squareup.com/mcp"
}
}
}
- square: if the server needs a sign-in, the app will ask.
Want it alongside other servers? Open Square MCP Server in the MCP config generator and add the rest; it writes one file per app. The snippets follow the setup in the server’s README, checked on 2026-10-14.
Before you install
- The remote server works on production data only and make_api_request can take payments, issue refunds and change orders.
- Test prompts locally against a Sandbox first; the local server supports DISALLOW_WRITES=true for read-only use.
- A remote server sees whatever the assistant sends it. Sign in with the narrowest access the service offers. See how to choose a safe server.
Why it’s listed
Why we list it
Square’s own server exposes the whole Square API through three tools and a vendor-hosted OAuth endpoint.
Related
More MCP servers
- Stripe MCPLets an assistant search Stripe docs, plan integrations and call the Stripe API to read and change payments, customers and billing data.
- PayPal MCP ServerLets an assistant create and send PayPal invoices, manage orders, refunds, disputes, products and subscriptions, and list transactions.
- Filesystem MCP ServerLets an assistant read, write, edit, move and search files, but only inside the folders you allow.
All MCP serversMCP config generatorGuide: MCP servers in Claude CodeGuide: what is MCP?