Square MCP Server (Official)
Official Square MCP server enabling AI agents to interact with Square's commerce platform — managing catalog items, querying orders and payments, managing customers and loyalty programs, handling inventory, and integrating Square's in-person and online commerce APIs.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
HTTPS enforced. OAuth2 with granular scopes. PCI-DSS. SOC 2. Sandbox for safe testing.
⚡ Reliability
Best When
An agent needs to interact with a Square-powered business — especially for retail, restaurants, or SMB commerce scenarios.
Avoid When
You're using Stripe, Shopify Payments, or another payment/commerce platform.
Use Cases
- • Querying sales and payment data from analytics agents
- • Managing product catalog and pricing from inventory agents
- • Processing refunds and managing orders from customer service agents
- • Analyzing customer loyalty and purchase history from CRM agents
- • Monitoring inventory levels and stock alerts from ops agents
- • Generating sales reports and financial summaries from reporting agents
Not For
- • Teams using Stripe, Adyen, or other payment processors
- • B2B payments (Square is primarily consumer/SMB focused)
- • Non-commerce use cases
Interface
Authentication
Square OAuth2 with granular permission scopes per resource type (payments, catalog, orders, customers, etc.). Personal access tokens for development. Production requires OAuth.
Pricing
No monthly fee for Square API access. Transaction fees apply when processing payments. Square developer account is free. MCP server is open source.
Agent Metadata
Known Gotchas
- ⚠ Location ID required for most commerce operations — discover locations first
- ⚠ Sandbox vs production environments use different credentials and base URLs
- ⚠ OAuth scopes must be requested upfront — cannot add later without re-authorization
- ⚠ Idempotency keys recommended for payment operations — prevent duplicate charges
- ⚠ Square API versioning: YYYY-MM-DD format in headers — use current version
- ⚠ Order fulfillments and line items have specific state machines
Alternatives
Full Evaluation Report
Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for Square MCP Server (Official).
Scores are editorial opinions as of 2026-03-06.