home / mcp / square model context protocol server

Square Model Context Protocol Server

Provides a Square MCP interface to discover, authorize, and perform Square API operations through the Model Context Protocol.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ampcome-mcps-square-mcp": {
      "url": "https://mcp.squareup.com/sse",
      "headers": {
        "SANDBOX": "SANDBOX=true",
        "PRODUCTION": "PRODUCTION=true",
        "ACCESS_TOKEN": "ACCESS_TOKEN=sq0atp-...",
        "SQUARE_VERSION": "SQUARE_VERSION=2025-04-16",
        "DISALLOW_WRITES": "DISALLOW_WRITES=true"
      }
    }
  }
}

You can connect your Square APIs to AI assistants via the Square MCP Server, a lightweight bridge that exposes Square’s API endpoints through the Model Context Protocol. This lets you discover, compose, and execute Square actions from an AI workflow with secure OAuth-powered access while keeping your tokens out of your conversations.

How to use

Use an MCP client to discover available Square services, understand required parameters, and make API requests through the Square MCP Server. Start by connecting to the server either remotely or locally, then use the provided tools to browse and execute Square operations. The remote endpoint handles authentication via OAuth, so you can log in with your Square account.

How to install

Prerequisites: have Node.js and npm installed on your system. You will run commands from your terminal to install and start the MCP server.

# Basic startup using npx
npx square-mcp-server start

# With environment configuration
ACCESS_TOKEN=YOUR_SQUARE_ACCESS_TOKEN SANDBOX=true npx square-mcp-server start

# Local run with explicit path (example)
npx /path/to/project/square-mcp-server

Additional steps and configuration

You can also connect to the hosted remote MCP server for Square, which handles authentication and avoids manual token management.

Configuration and security notes

Set environment variables to control how the server interacts with Square. Common options include the access token, sandbox mode, and API version. Be sure to keep your access token secure and avoid exposing it in logs or shared environments.

Troubleshooting tips

If you encounter authentication or connection issues, verify that your ACCESS_TOKEN is correct and that SANDBOX or PRODUCTION are set to the environment you intend. Check that the server URL is reachable if you are using the remote MCP.

Available tools

get_service_info

Discover methods available for a service and learn what operations you can perform.

get_type_info

Retrieve detailed parameter requirements for a specific service method to prepare requests correctly.

make_api_request

Execute API calls against Square services to perform the desired operations.