Advertise
MCP.so
Sign In

Square MCP Server (Beta)

@mikeysrecipes

Repository

Basic information

Category

Other

License

Apache-2.0 license

Transports

stdio

Author

mikeysrecipes

About Square MCP Server

No overview available yet

#square-mcp-server#api-integration#ai-assistant

Square MCP Server config

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

{
  "mcpServers": {
    "square-mcp-server-mikeysrecipes": {
      "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 an implementation of the Model Context Protocol (MCP) standard that allows AI assistants to interact with Square’s Connect API. It is aimed at developers who want to integrate Square’s commerce, payments, and business management capabilities into AI-driven workflows.

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

The server can be started locally using npx square-mcp-server start with environment variables such as ACCESS_TOKEN and SANDBOX. A hosted remote MCP version is also available at https://mcp.squareup.com/sse and can be configured via OAuth. Integration instructions are provided for Goose (with npx square-mcp-server install) and Claude Desktop (via claude_desktop_config.json). Configuration options include ACCESS_TOKEN, SANDBOX, PRODUCTION, DISALLOW_WRITES, and SQUARE_VERSION.

Key features of Square Model Context Protocol Server (Beta)

  • Three core tools: get_service_info, get_type_info, and make_api_request
  • Access to Square’s complete API ecosystem (40+ services)
  • Supports both local (access token) and remote (OAuth) authentication
  • Sandbox and production environment switching via environment variables
  • Read-only mode available with DISALLOW_WRITES=true
  • Remote MCP server hosted at mcp.squareup.com/sse

Use cases of Square Model Context Protocol Server (Beta)

  • AI-driven catalog management (items, categories, inventory)
  • Automated payment processing and refund handling
  • Customer relationship management (creation, segmentation, custom attributes)
  • Order and invoice management via natural language queries
  • Workforce and subscription management (labor, team, subscriptions)

Frequently asked questions

1

What authentication methods does the server support?

Local mode requires a Square access token set via the `ACCESS_TOKEN` environment variable. The remote MCP server uses OAuth, allowing users to log in with their Square account directly without manual token management.

2

Can I run the server in a sandbox environment?

Yes. Set the `SANDBOX=true` environment variable to use Square’s sandbox environment. Alternatively, `PRODUCTION=true` forces production mode.

3

How do I restrict the server to read-only operations?

Set the `DISALLOW_WRITES=true` environment variable to prevent any write operations through the API.

4

What tools does the server expose?

The server exposes three tools: `get_service_info` (discover methods for a service), `get_type_info` (learn parameter requirements), and `make_api_request` (execute API calls to Square).

5

What environment variables are available for configuration?

The supported variables are `ACCESS_TOKEN` (Square API token), `SANDBOX`, `PRODUCTION`, `DISALLOW_WRITES`, and `SQUARE_VERSION` (API version).

Comments

More Other MCP servers

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K
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

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K
Advertise