MCP.so
登录

Square MCP Server (Beta)

@square

基本信息

分类

其他

许可证

Apache-2.0

传输方式

stdio

作者

square

关于 Square MCP Server

A Model Context Protocol (MCP) server for square

Square MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Square MCP Server 工具

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

概览

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

常见问题

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.

评论

其他 分类下的更多 MCP 服务器