Square
Enables AI assistants to interact with Square's Connect API through the Model Context Protocol standard, allowing for operations like managing customers, processing payments, and handling inventory.
What is Square?
Square is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai assistants to interact with square's connect api through the model context protocol standard, allowing for operations like managing customers, processing payments, and handling inventory.
Enables AI assistants to interact with Square's Connect API through the Model Context Protocol standard, allowing for operations like managing customers, processing payments, and handling inventory.
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables AI assistants to interact with Square's Connect API
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx square-model-context-protocol-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Square
The Square MCP Server bridges AI assistants to Square's Connect API, giving them access to over 40 business domains including payments, catalog management, customer records, inventory, loyalty programs, appointments, and workforce management. It exposes three meta-tools — get_service_info, get_type_info, and make_api_request — that together let an AI discover available operations, inspect required parameters, and execute API calls against Square. Merchants and developers use it to automate back-office tasks, answer questions about sales data, or build AI-driven point-of-sale workflows.
Prerequisites
- Node.js 18 or higher installed
- A Square developer account with an Access Token (sandbox or production) from https://developer.squareup.com
- An MCP-compatible client such as Claude Desktop or Cursor
Obtain a Square Access Token
Log in to the Square Developer Dashboard at https://developer.squareup.com, create an application, and copy either your sandbox or production Access Token. Keep it secret.
Test the server runs via npx
Run the server once from the command line to verify your Node.js version and network access are correct before wiring it into an MCP client.
ACCESS_TOKEN=YOUR_SQUARE_ACCESS_TOKEN SANDBOX=true npx square-mcp-server startAdd the server to your MCP client configuration
Open your claude_desktop_config.json and add the Square MCP server entry. Set SANDBOX to false and use your production token when you are ready to work with live data.
{
"mcpServers": {
"square": {
"command": "npx",
"args": ["square-mcp-server", "start"],
"env": {
"ACCESS_TOKEN": "YOUR_SQUARE_ACCESS_TOKEN",
"SANDBOX": "true"
}
}
}
}Alternatively, use the hosted remote MCP endpoint
Square also provides a hosted remote MCP server at https://mcp.squareup.com/sse that uses OAuth instead of a static token. Add it as a remote server in supporting clients.
Restart your MCP client
Restart Claude Desktop or your MCP client to load the new configuration and confirm the Square tools appear.
Square Examples
Client configuration
Add this to your claude_desktop_config.json. Use SANDBOX=true for testing against Square's sandbox environment and your sandbox Access Token.
{
"mcpServers": {
"square": {
"command": "npx",
"args": ["square-mcp-server", "start"],
"env": {
"ACCESS_TOKEN": "EAAAl...",
"SANDBOX": "true",
"DISALLOW_WRITES": "false"
}
}
}
}Prompts to try
Use these prompts with Claude Desktop or another MCP client after connecting to the Square server.
- "What Square services are available for managing catalog items?"
- "List all customers in my Square account."
- "Create a new catalog item called 'Cold Brew Coffee' priced at $4.50."
- "Show me recent payments from this week."
- "What are my current inventory counts for all items?"
- "Search for customer John Smith in my Square account."Troubleshooting Square
API calls return 401 Unauthorized errors
Double-check that your ACCESS_TOKEN matches the environment you are targeting. A sandbox token will not work against production endpoints. Regenerate the token in the Square Developer Dashboard if needed.
DISALLOW_WRITES is not set and you want to prevent accidental changes
Add DISALLOW_WRITES=true to the env block in your config. This restricts the server to read-only operations so the AI cannot create, update, or delete data.
npx square-mcp-server fails with a version error
Ensure Node.js 18+ is installed. Run 'node --version' to check. Also try clearing the npx cache with 'npx clear-npx-cache' and retry.
Frequently Asked Questions about Square
What is Square?
Square is a Model Context Protocol (MCP) server that enables ai assistants to interact with square's connect api through the model context protocol standard, allowing for operations like managing customers, processing payments, and handling inventory. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Square?
Follow the installation instructions on the Square GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Square?
Square works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Square free to use?
Yes, Square is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
Square Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Square? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Square in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Square?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.