Advertise
MCP.so
Sign In

Square MCP Server (Beta)

@square

Repository

Basic information

Category

Other

License

Apache-2.0

Transports

stdio

Author

square

About Square MCP Server

A Model Context Protocol (MCP) server for square

Square MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "square-mcp-server": {
      "command": "npx",
      "args": [
        "square-mcp-server",
        "start"
      ]
    }
  }
}

Square MCP Server tools

3

Unified tool for all Square API operations. Be sure to get types before calling. Available services: applepay, bankaccounts, bookingcustomattributes, bookings, cards, cashdrawers, catalog, checkout, customercustomattributes, customergroups, customersegments, customers, devices, disputes, events, giftcardactivities, giftcards, inventory, invoices, labor, locationcustomattributes, locations, loyalty, merchantcustomattributes, merchants, oauth, ordercustomattributes, orders, payments, payouts, refunds, sites, snippets, subscriptions, team, terminal, vendors, webhooksubscriptions.

Get type information for a Square API method. You must call this before calling the make_api_request tool.

Get information about a Square API service. Call me before trying to get type info

Overview

What is Square Model Context Protocol Server (Beta)?

Square Model Context Protocol Server (Beta) is a server that follows the Model Context Protocol (MCP) standard, enabling AI assistants to interact with Square’s Connect API. It is designed for developers who want to manage Square data—such as payments, customers, and inventory—through AI chat interfaces like Goose or Claude Desktop.

How to use Square Model Context Protocol Server (Beta)?

Run the server locally using npx square-mcp-server start, optionally setting environment variables like ACCESS_TOKEN, SANDBOX, PRODUCTION, DISALLOW_WRITES, or SQUARE_VERSION. Alternatively, use the hosted remote MCP server at https://mcp.squareup.com/sse which supports OAuth authentication. Integrate with Goose via npx square-mcp-server install or by copying a goose:// URL. For Claude Desktop, add a local or remote configuration to claude_desktop_config.json. Use the three MCP tools—get_service_info, get_type_info, and make_api_request—in sequence to discover, understand, and execute Square API calls.

Key features of Square Model Context Protocol Server (Beta)

  • Discover Square API methods with get_service_info
  • Inspect parameter requirements via get_type_info
  • Execute any Square API call with make_api_request
  • Switch between sandbox and production environments
  • Restrict operations to read-only with DISALLOW_WRITES
  • Integrates with Goose and Claude Desktop

Use cases of Square Model Context Protocol Server (Beta)

  • Query customer details and manage segmented lists via AI
  • Process payments, refunds, and disputes through natural language
  • Update inventory and catalog items without manual API calls
  • Manage orders, invoices, and subscriptions from a chat interface
  • Automate loyalty program adjustments and gift card operations

Frequently asked questions

1

What authentication methods are supported?

Local mode requires a Square access token set as the `ACCESS_TOKEN` environment variable. The remote MCP server uses OAuth, allowing you to log in with your Square account without manually managing tokens.

2

Can I use the sandbox environment for testing?

Yes. Set the environment variable `SANDBOX=true` to run against Square’s sandbox. Alternatively, set `PRODUCTION=true` for live data.

3

How can I prevent write operations?

Set `DISALLOW_WRITES=true` to restrict the server to read-only operations such as listing customers or retrieving payments.

4

What runtime dependencies are required?

The server runs via Node.js and is invoked with `npx`. For local development, clone the repo and run `npm install` followed by `npm run build`.

5

Which Square API version is used?

You can specify a particular API version with the `SQUARE_VERSION` environment variable (e.g., `SQUARE_VERSION=2025-04-16`). Otherwise, the default version is used.

Comments

More Other MCP servers

P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Advertise