Square Remote MCP Server

🛡️ Official✓ VerifiedSSEOAuth 2.14 tools·Online41ms·30d uptime: 100%·Last checked 18m ago

Square's hosted MCP (mcp.squareup.com/sse) lets agents list payments, search orders and create payment links against your Square seller account after OAuth authorization.

https://mcp.squareup.com/sse

Provider: Block / Square ↗
Categories: 💳 Payments, Billing & Commerce

中文简介

Square 官方远程 MCP 服务器。通过 SSE 传输与 OAuth 将 Square 商户账户的支付、订单和商品目录接入 AI 代理。

SSEhttps://mcp.squareup.com/sse

Install in Cursor →

Or add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "square": {
      "url": "https://mcp.squareup.com/sse"
    }
  }
}

🔬 Test Live in Online Inspector 🔐 Audit OAuth 2.1 Config

🧰 Tools exposed by Square MCP (4)

Tool	Safety	Description	Parameters
list_payments	🟢 Read	List payments taken by the Square seller account.	beginTime: stringlocationId: string
search_orders	🟢 Read	Search Square orders with filters.	locationIds: arrayquery: string
list_catalog_items	🟢 Read	List items in the Square catalog.	cursor: string
create_payment_link	🟠 Write	Create a Square checkout payment link.	description: stringamount: numbercurrency: string

🔐 OAuth 2.1 & Security

Auth type: OAuth 2.1
Dynamic Client Registration: ✅ Supported
PKCE S256: ✅ Supported
Scopes: PAYMENTS_READORDERS_READITEMS_READPAYMENTS_WRITE
Protected resource metadata: https://mcp.squareup.com/.well-known/oauth-protected-resource (expected location)

🔐 Audit OAuth 2.1 Config →

🧩 Recommended Agent Skills

Commerce skills ↗

📖 Guide

Square MCP — Remote MCP Server

Square's remote MCP exposes seller-account data — payments, orders, catalog items — plus payment-link creation, using Square's standard OAuth 2.0 scopes. It currently serves only the legacy SSE transport, so clients need SSE support.

Endpoint & Transport

Endpoint URL: https://mcp.squareup.com/sse
Transport: HTTP+SSE (legacy SSE transport)

Authentication

Square MCP uses OAuth 2.1 — the first request returns a 401 Unauthorized challenge with a WWW-Authenticate header pointing at the authorization metadata. Compliant clients (Cursor, Claude, VS Code, ChatGPT) handle the whole flow — PKCE and Dynamic Client Registration, so no manual client setup is needed — and simply open a browser consent screen.

Available Tools (4)

Tool	Safety	Description
`list_payments`	read	List payments taken by the Square seller account.
`search_orders`	read	Search Square orders with filters.
`list_catalog_items`	read	List items in the Square catalog.
`create_payment_link`	write	Create a Square checkout payment link.

Connect in 30 Seconds

Claude Code — one command:

claude mcp add --transport sse square https://mcp.squareup.com/sse

Cursor — add to ~/.cursor/mcp.json:

{ "mcpServers": { "square": { "url": "https://mcp.squareup.com/sse" } } }

VS Code — add to .vscode/mcp.json:

{ "servers": { "square": { "type": "sse", "url": "https://mcp.squareup.com/sse" } } }

Claude Desktop & stdio clients — bridge with mcp-remote:

{ "mcpServers": { "square": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.squareup.com/sse"] } } }

On first connect your client opens a browser OAuth consent screen — approve it and tools become available immediately.

Troubleshooting

401 Unauthorized on connect — that's expected; the server is OAuth-protected. Let your client complete the browser consent flow, or inspect the endpoint in our OAuth debugger to see the exact WWW-Authenticate challenge.
Client says "unsupported transport" — this endpoint only speaks the legacy SSE transport. Use a client with SSE support (Claude Code: claude mcp add --transport sse) or bridge it with mcp-remote.
"Session expired" / stale Mcp-Session-Id — just re-send initialize; stateless clients can ignore session headers entirely.
SSE-only endpoint — use --transport sse in Claude Code or an SSE-capable client.
OAuth scopes follow Square's granular permission model.

🚀 How to Connect

Copy the Square MCP endpoint URL
The remote endpoint is https://mcp.squareup.com/sse.
Add it to your MCP client
Claude Code: claude mcp add --transport sse square https://mcp.squareup.com/sse. Cursor: add "square": { "url": "https://mcp.squareup.com/sse" } under mcpServers in ~/.cursor/mcp.json. Other clients work similarly.
Complete the OAuth consent
On first connection your client opens a Block / Square consent screen in the browser. Approve it to grant access; the token is stored by the client and refreshed automatically.
Verify with the online inspector
Paste https://mcp.squareup.com/sse into remotemcp.net/inspector, run initialize and tools/list, and confirm Square MCP's 4 tools respond.

❓ FAQ

What is the Square MCP remote MCP endpoint?

The primary endpoint is https://mcp.squareup.com/sse. It is an official first-party server operated by Block / Square, speaking the HTTP+SSE (legacy SSE transport) transport.

How do I authenticate with Square MCP?

Square MCP uses OAuth 2.1. When your client first connects it receives a 401 challenge, discovers the authorization server via RFC 9728 metadata, and opens a browser consent screen. Dynamic Client Registration is supported, so compliant clients register themselves automatically.

I'm getting a 401 Unauthorized from Square MCP — what's wrong?

A 401 means your client hasn't completed (or has lost) the OAuth authorization. Remove and re-add the server in your client to restart the consent flow, and check that your browser session can reach the provider's login page. If the 401 arrives without a WWW-Authenticate header, run it through our OAuth debugger to see what's missing.

Which MCP clients work with Square MCP?

Any client that supports remote MCP servers: Cursor, Claude Code (`claude mcp add --transport sse square https://mcp.squareup.com/sse`), VS Code Copilot, ChatGPT connectors, Windsurf, and Claude Desktop via the `mcp-remote` bridge. Note this server only offers the SSE transport, so the client must support SSE.

What tools does Square MCP expose?

4 tools are cataloged in this directory — including `list_payments`, `search_orders`, `list_catalog_items` and more. Use our online inspector to fetch the live tool list straight from the endpoint.

🔗 Connect Guides

Cursor

Connect Square MCP →

📛 Embed Status Badge in README

[![Remote MCP Status](https://remotemcp.net/api/badge/status/square.svg)](https://remotemcp.net/servers/square)

[![Test in Inspector](https://remotemcp.net/api/badge/inspect/square.svg)](https://remotemcp.net/inspector?url=https%3A%2F%2Fmcp.squareup.com%2Fsse)

Related Servers

Stripe MCPStripe

Stripe's official remote MCP server at mcp.stripe.com. Agents can query customers, payment intents and subscriptions and invoke Stripe API operations with OAuth.

https://mcp.stripe.com

🛡️ Official✓ VerifiedStreamable HTTPOAuth 2.15 toolsOnline62ms

PayPal MCPPayPal

PayPal's official remote MCP server for payments and commerce. Agents can create invoices, inspect transactions and manage orders after OAuth login.

https://mcp.paypal.com/mcp

🛡️ Official✓ VerifiedHTTP + SSEOAuth 2.14 toolsOnline40ms