How to Connect Square Remote MCP to VS Code
Add Block / Square's remote MCP server to VS Code in about a minute.
Step-by-step
- Add to .vscode/mcp.jsonUse the deeplink or paste the
serversJSON above into.vscode/mcp.json. - AuthorizeOn first use your client opens a Block / Square OAuth consent screen โ approve it and tools become available.
- Use in Copilot ChatOpen Copilot Chat in agent mode โ the server's tools appear in the tools menu. Verify in the browser: paste
https://mcp.squareup.com/sseinto remotemcp.net/inspector and run initialize + tools/list.
Troubleshooting OAuth / 401
- A
401 Unauthorizedon first connect is normal โ the endpoint is OAuth-protected; let VS Code finish the browser consent flow. - If the consent window never opens, remove and re-add the server, then retry.
- Check the exact challenge at our OAuth debugger.
- This server only speaks SSE โ make sure VS Code supports the legacy SSE transport.
- Run the live endpoint through the online inspector to see the raw JSON-RPC exchange.
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"square": {
"url": "https://mcp.squareup.com/sse"
}
}
}claude mcp add --transport sse square https://mcp.squareup.com/sse
Or add to .vscode/mcp.json:
{
"servers": {
"square": {
"type": "sse",
"url": "https://mcp.squareup.com/sse"
}
}
}- Open Settings โ Connectors (Integrations) โ Add Custom Connector.
- Paste the endpoint URL:
https://mcp.squareup.com/sse - Complete the browser OAuth 2.1 login flow when prompted.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"square": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.squareup.com/sse"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"square": {
"serverUrl": "https://mcp.squareup.com/sse"
}
}
}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 |
Connect Square MCP to another client
Other servers for VS Code
GitHub's official remote MCP server hosted at api.githubcopilot.com. Gives AI agents first-party access to repositories, issues, pull requests and code search.
Notion's official hosted MCP server. Agents can search your workspace, read and create pages, and query databases over Streamable HTTP or SSE.
Linear's official remote MCP server. Agents can search, create and update issues and query your team's workflow over Streamable HTTP or SSE.
Figma's official remote MCP server. Agents can pull design context, variables, Code Connect mappings and screenshots from your Figma files.
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.
Cloudflare's free, authless documentation MCP server. Agents can search the full Cloudflare docs corpus โ no account or token required.