
Square MCP Server
MCP支付与收银平台 Square 的官方 MCP(Beta),让 agent 查询和管理交易、订单、退款、发票、商品库存与客户,方便门店对账和出报表。连接官方托管服务后用 Square 账号 OAuth 登录即可,无需本地安装;涉及退款等写操作前请人工确认。
Square Model Context Protocol Server (Beta)
This project follows the Model Context Protocol standard, allowing AI assistants to interact with Square's connect API.
Most people should use the hosted server. Square runs a remote MCP server at
https://mcp.squareup.com/mcpwith OAuth sign-in; see the Square MCP documentation for setup with your AI assistant. This repository is the local, self-hosted server: a starting point if you want to run your own copy. Code changes go through the generator described under Contributing.
Quick Start
Get up and running with the local server using npx. This runs the server on your own machine with your own access token; for the hosted server, see the note above.
# Basic startup
npx square-mcp-server start
# With environment configuration
ACCESS_TOKEN=YOUR_SQUARE_ACCESS_TOKEN SANDBOX=true npx square-mcp-server start
# local runs
npx /path/to/project/square-mcp-server
Replace YOUR_SQUARE_ACCESS_TOKEN with your actual Square access token. You can obtain your access token by following the guide at Square Access Tokens. You can also set environment variables before running the command.
Remote MCP Server
Square offers a hosted remote MCP server at:
https://mcp.squareup.com/mcp
The remote server is recommended: it uses OAuth, so you sign in with your Square account instead of creating and managing access tokens. Setup guides for Claude, ChatGPT, Goose and other assistants are in the Square MCP documentation. The older https://mcp.squareup.com/sse endpoint is still served for existing SSE configurations.
Configuration Options
| Environment Variable | Purpose | Example |
|---|---|---|
ACCESS_TOKEN | Your Square API access token | ACCESS_TOKEN=sq0atp-... |
SANDBOX | Use Square sandbox environment | SANDBOX=true |
PRODUCTION | Use Square production environment | PRODUCTION=true |
DISALLOW_WRITES | Restrict to read-only operations | DISALLOW_WRITES=true |
SQUARE_VERSION | Specify Square API version | SQUARE_VERSION=2025-04-16 |
Integration with AI Assistants
Goose Integration
To configure the Square MCP Server with Goose:
Remote MCP
To install the Square remote MCP in Goose, click this URL on a computer where Goose is installed:
Or copy and paste the URL into your browser's address bar.
The commands below configure the local server (npx square-mcp-server start), not the hosted one:
# Automatic installation
npx square-mcp-server install
# Get URL for manual installation
npx square-mcp-server get-goose-url
The install command automatically updates your Goose configuration.
Claude Desktop Integration
For Claude Desktop integration, see the Model Context Protocol Quickstart Guide. Add this configuration to your claude_desktop_config.json:
Remote MCP
{
"mcpServers": {
"mcp_square_api": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.squareup.com/mcp"]
}
}
}
This approach allows you to authenticate directly with your Square account credentials without needing to manage access tokens.
Local MCP
{
"mcpServers": {
"mcp_square_api": {
"command": "npx",
"args": ["square-mcp-server", "start"],
"env": {
"ACCESS_TOKEN": "YOUR_SQUARE_ACCESS_TOKEN",
"SANDBOX": "true"
}
}
}
}
Tool Reference
The Square MCP Server provides a streamlined set of tools for interacting with Square APIs:
| Tool | Description | Primary Use |
|---|---|---|
get_service_info | Discover methods available for a service | Exploration and discovery |
get_type_info | Get detailed parameter requirements | Request preparation |
make_api_request | Execute API calls to Square | Performing operations |
Service Catalog
Square MCP Server provides access to Square's complete API ecosystem. Check out the Square API Documentation for detailed information about each service:
| Service | Description |
|---|---|
applepay | Apple Pay integration |
bankaccounts | Bank account management |
bookingcustomattributes | Custom attributes for bookings |
bookings | Appointment booking management |
cards | Payment card management |
cashdrawers | Cash drawer management |
catalog | Catalog management (items, categories, etc.) |
checkout | Checkout and payment processing |
customercustomattributes | Custom attributes for customers |
customergroups | Customer grouping |
customersegments | Customer segmentation |
customers | Customer management |
devices | Square device management |
disputes | Payment dispute handling |
events | Event tracking |
giftcardactivities | Gift card activity tracking |
giftcards | Gift card management |
inventory | Inventory tracking |
invoices | Invoice management |
labor | Workforce management |
locationcustomattributes | Custom attributes for locations |
locations | Location management |
loyalty | Loyalty program management |
merchantcustomattributes | Custom attributes for merchants |
merchants | Merchant account management |
oauth | Authentication |
ordercustomattributes | Custom attributes for orders |
orders | Order management |
payments | Payment processing |
payouts | Payout management |
refunds | Refund management |
sites | Website integration |
snippets | Square Online Code integration |
subscriptions | Subscription management |
team | Staff management |
terminal | Square Terminal management |
vendors | Supplier management |
webhooksubscriptions | Event notifications |
Usage Pattern
For optimal interaction with the Square API through MCP:
-
Discover: Use
get_service_infoto explore available methodsget_service_info(service: "catalog") -
Understand: Use
get_type_infoto learn parameter requirementsget_type_info(service: "catalog", method: "list") -
Execute: Use
make_api_requestto perform the operationmake_api_request(service: "catalog", method: "list", request: {})
Development and Debugging
Using MCP Inspector
The MCP Inspector provides a visual interface for testing:
# Build the project
npm run build
# Start the inspector with the Square MCP Server
npx @modelcontextprotocol/inspector node dist/index.js start
Development Workflow
- Clone the repository
- Install dependencies:
npm install - Start development mode:
npm run watch - Run the server:
node dist/index.js start - Test your changes using the MCP Inspector
Contributing
This repository is auto-generated from Square's OpenAPI Specification. While contributions are welcome, please note that changes will need to be incorporated into the generator that produces this code. Please open an issue to discuss proposed changes before submitting a pull request.
相關資源

Ticket Deflector
Skill面向小商家的客服技能:读取客户邮件,查 Stripe、PayPal、Square 或 Shopify 的订单与退款状态,按店主口吻和退款政策起草回复,经店主明确确认后可通过 Stripe 或 Square 直接退款;不接任何连接器、只粘贴邮件原文也能用。属于 Anthropic 官方 small-business 插件。
anthropics/knowledge-work-plugins36.5k
MCP Server for Odoo
MCP连接 Odoo ERP,让 agent 用自然语言检索、创建、更新、删除客户、产品、发票等业务记录,支持聚合统计与附件读取。生产环境需在 Odoo 安装配套 MCP 模块,测试时可用 YOLO 模式直连。
ivnvxd/mcp-server-odoo417
Razorpay MCP Server
MCP印度支付平台 Razorpay 官方 MCP,可查询支付、订单、退款、结算与对账报表,创建付款链接和收款二维码,方便财务核对收款。推荐连接官方托管的远程服务,需用 Razorpay 商户的 API Key 与 Secret 生成商户令牌。
razorpay/razorpay-mcp-server232
PayPal Agent Toolkit
MCPPayPal 官方 agent 工具包,附带 MCP 服务器 @paypal/mcp:创建与发送发票、处理订单和退款、管理争议、订阅、商品目录与物流跟踪,查询交易记录。需 PayPal 开发者 Access Token,默认沙箱环境。
paypal/agent-toolkit199
Stripe MCP
MCP让 agent 调用 Stripe API 管理客户、支付、订阅、发票与退款,并检索 Stripe 文档与支持文章。Stripe 官方维护,远程服务通过 OAuth 授权,也可用密钥经 npx 本地运行。
stripe/ai2.1k
Frappe Assistant Core
MCP把开源 ERP 系统 ERPNext 接给 AI 助手:财务和运营人员用自然语言查发票、客户和库存,跑报表、处理审批,权限跟随 ERPNext 账号,每次调用都有审计日志。需要管理员先在站点装好此应用;分析结论需财务人员复核。
buildswithpaul/Frappe_Assistant_Core337