Skip to main content

Announcing StackOne Defender: leading open-source prompt injection guard for your agent Read More

Square MCP Server
for AI Agents

Production-ready Square MCP server with 125 extensible actions — plus built-in authentication, security, and optimized execution.

Square logo
Square MCP Server
Built by StackOne StackOne

Coverage

125 Agent Actions

Create, read, update, and delete across Square — and extend your agent's capabilities with custom actions.

Authentication

Agent Tool Authentication

Per-user OAuth in one call. Your Square MCP server gets session-scoped tokens with zero credentials stored on your infra.

Agent Auth →

Security

Agent Protection

Every Square tool response scanned for prompt injection in milliseconds — 88.7% accuracy, all running on CPU.

Prompt Injection Defense →

Performance

Max Agent Context. Min Cost.

Free up to 96% of your agent's context window to enhance reasoning and reduce cost, on every Square call.

Tools Discovery →

What is the Square MCP Server?

A Square MCP server lets AI agents read and write Square data through the Model Context Protocol — Anthropic's open standard for connecting LLMs to external tools. StackOne's Square MCP server ships with 125 pre-built actions, fully extensible via the Connector Builder — plus managed authentication, prompt injection defense, and optimized agent context. Connect it from MCP clients like Claude Desktop, Cursor, and VS Code, or from agent frameworks like OpenAI Agents SDK, LangChain, and Vercel AI SDK.

All Square MCP Tools and Actions

Every action from Square's API, ready for your agent. Create, read, update, and delete — scoped to exactly what you need.

Payments

  • Create Payment

    Create a payment using a payment source such as a card or gift card

  • List Payments

    Retrieve a paginated list of payments taken by the account

  • Get Payment

    Retrieve details for a specific payment by ID

  • Update Payment

    Update a payment with APPROVED status to modify tip or amount

Payment Refunds

  • List Payment Refunds

    Retrieve a paginated list of refunds for the account

  • Get Payment Refund

    Retrieve details of a specific refund by ID

Orders

  • Create Order

    Create a new order for a location

  • Clone Order

    Create a new order by cloning an existing order

  • Search Orders

    Search for orders across one or more locations with filters

  • Retrieve Order

    Retrieve an order by its ID

  • Update Order

    Update an open order by adding, replacing, or deleting fields

  • Batch Retrieve Orders

    Retrieve multiple orders by their IDs in a single request

Customers

  • Create Customer

    Create a new customer profile for the business

  • List Customers

    Retrieve a paginated list of all customer profiles for the account

  • Search Customers

    Search customer profiles by phone, email, name, or custom attributes

  • Retrieve Customer

    Retrieve a specific customer profile by ID

  • Update Customer

    Update an existing customer profile

  • Delete Customer

    Delete a customer profile from the business

Customer Groups

  • Create Customer Group

    Create a new customer group for the business

  • List Customer Groups

    Retrieve a list of all customer groups for the business

  • Retrieve Customer Group

    Retrieve a specific customer group by ID

  • Update Customer Group

    Update an existing customer group's name

  • Delete Customer Group

    Delete a customer group from the business

Customer Segments

  • List Customer Segments

    Retrieve a list of all customer segments for the business

  • Retrieve Customer Segment

    Retrieve a specific customer segment by ID

Catalog Objects

  • Search Catalog Objects

    Search for catalog objects by supported attribute values

  • Retrieve Catalog Object

    Retrieve a single catalog object by ID

  • Batch Retrieve Catalog Objects

    Retrieve multiple catalog objects by their IDs in a single request

  • Batch Delete Catalog Objects

    Delete multiple catalog objects in a single request

  • Delete Catalog Object

    Delete a single catalog object and its children

Upsert Catalog Objects

  • Batch Upsert Catalog Objects

    Create or update up to 10,000 catalog objects in a single request

  • Upsert Catalog Object

    Create or update a single catalog object

Inventory Counts

  • Retrieve Inventory Count

    Retrieve current inventory counts for a specific catalog object

  • Batch Retrieve Inventory Counts

    Retrieve current inventory counts for multiple catalog objects at specific locations

Locations

  • Create Location

    Create a new location for the seller account

  • List Locations

    Retrieve all seller locations for the account

  • Retrieve Location

    Retrieve details of a specific location by ID

  • Update Location

    Update an existing location's settings and information

Merchants

  • List Merchants

    Retrieve the merchant profile for the account

  • Retrieve Merchant

    Retrieve a specific merchant's profile by ID

Payouts

  • List Payouts

    Retrieve a paginated list of all payouts for the seller's default or specified location

  • Get Payout

    Retrieve details of a specific payout by its ID

Invoices

  • Create Invoice

    Create a draft invoice for an order

  • Publish Invoice

    Publish a draft invoice to send it to the customer

  • List Invoices

    Retrieve a list of invoices for a given location

  • Search Invoices

    Search for invoices by location, customer, or status

  • Get Invoice

    Retrieve an invoice by its ID

  • Update Invoice

    Update a draft or scheduled invoice

  • Delete Invoice

    Delete a draft invoice

Subscriptions

  • Create Subscription

    Enroll a customer in a subscription plan

  • Search Subscriptions

    Search for subscriptions by customer, location, or plan

  • Retrieve Subscription

    Retrieve a specific subscription by ID

  • Update Subscription

    Modify or clear field values on an active subscription

Cards

  • Create Card

    Add a card on file to an existing customer or merchant

  • List Cards

    Retrieve a list of cards on file for the account

  • Retrieve Card

    Retrieve details of a specific card on file by ID

Gift Cards

  • Create Gift Card

    Create a digital gift card or register a physical gift card

  • List Gift Cards

    Retrieve a list of gift cards for the account

  • Retrieve Gift Card

    Retrieve a gift card by its ID

Team Members

  • Create Team Member

    Create a new team member for the seller account

  • Search Team Members

    Search for team members by location, status, or other criteria

  • Retrieve Team Member

    Retrieve a team member by ID

  • Update Team Member

    Update an existing team member's information

Jobs

  • Create Job

    Create a new job definition for the seller account

  • List Jobs

    Retrieve a list of all jobs defined for the seller account

  • Retrieve Job

    Retrieve a specific job definition by its ID

  • Update Job

    Update an existing job definition by its ID

Wage Settings

  • Retrieve Wage Setting

    Retrieve the wage setting for a team member

  • Update Wage Setting

    Create or update the wage setting for a team member

Break Types

  • Create Break Type

    Create a new break type for team member shifts

  • List Break Types

    Retrieve a list of all break types for the seller account

  • Retrieve Break Type

    Retrieve a specific break type by ID

  • Update Break Type

    Update an existing break type by ID

  • Delete Break Type

    Delete a break type by ID

Timecards

  • Create Timecard

    Create a new timecard for a team member at a location

  • Search Timecards

    Search for timecard records with filters for team member and date range

  • Retrieve Timecard

    Retrieve a specific timecard by ID

  • Update Timecard

    Update an existing timecard by ID

  • Delete Timecard

    Delete a timecard by ID

Disputes

  • List Disputes

    Retrieve a list of disputes associated with the account

  • Retrieve Dispute

    Retrieve details about a specific dispute by ID

Dispute Evidences

  • List Dispute Evidence

    Retrieve all evidence submitted for a dispute

  • Retrieve Dispute Evidence

    Retrieve metadata for a specific piece of dispute evidence

  • Delete Dispute Evidence

    Remove a specific piece of evidence from a dispute before submission

Bank Accounts

  • List Bank Accounts

    Retrieve a list of bank accounts linked to the Square account

  • Get Bank Account

    Retrieve details of a specific bank account by ID

Payment Links

  • Create Payment Link

    Create a Square-hosted checkout page with a shareable payment link

  • List Payment Links

    Retrieve a list of all payment links for the account

  • Retrieve Payment Link

    Retrieve a specific payment link by its token ID

  • Update Payment Link

    Update an existing payment link's settings

  • Delete Payment Link

    Delete a payment link permanently

Other (34)

  • Add Group To Customer

    Add a group membership to a customer profile

  • Create Gift Card Activity

    Create an activity (activate, load, redeem, adjust, etc.) on a gift card

  • Create Dispute Evidence Text

    Upload text-based evidence to contest a dispute

  • List Catalog

    Retrieve a paginated list of all catalog objects for the account

  • Search Catalog Items

    Search for catalog items or item variations by specific attributes

  • Retrieve Inventory Adjustment

    Retrieve a specific inventory adjustment by its ID

  • Retrieve Inventory Physical Count

    Retrieve a specific inventory physical count record by its ID

  • List Payout Entries

    Retrieve all payout entries for a specific payout

  • List Subscription Events

    Retrieve a paginated list of events for a specific subscription

  • Retrieve Gift Card From GAN

    Retrieve a gift card using the gift card account number (GAN)

  • List Gift Card Activities

    Retrieve a list of gift card activities for a specific gift card or across all gift cards

  • Batch Retrieve Inventory Changes

    Retrieve a list of inventory changes for catalog objects at specific locations

  • Batch Change Inventory

    Apply adjustments and counts to catalog object quantities

  • Remove Group From Customer

    Remove a group membership from a customer profile

  • Cancel Payment

    Cancel (void) a payment by its ID

  • Cancel Payment By Idempotency Key

    Cancel a payment using the original idempotency key when the payment ID is unknown

  • Complete Payment

    Complete (capture) a payment that was created with autocomplete set to false

  • Refund Payment

    Refund a payment, either fully or partially

  • Pay Order

    Pay for an order using one or more approved payments

  • Calculate Order

    Preview order pricing without creating an order

  • Bulk Create Customers

    Create up to 100 customer profiles in a single request

  • Bulk Retrieve Customers

    Retrieve up to 100 customer profiles by ID in a single request

  • Bulk Update Customers

    Update up to 100 customer profiles in a single request

  • Bulk Delete Customers

    Delete up to 100 customer profiles in a single request

  • Cancel Invoice

    Cancel a published invoice

  • Cancel Subscription

    Schedule a cancellation for an active subscription

  • Resume Subscription

    Resume a paused or canceled subscription

  • Disable Card

    Disable a card on file to prevent further charges

  • Link Customer To Gift Card

    Link a customer to a gift card to associate it with their account

  • Unlink Customer From Gift Card

    Unlink a customer from a gift card to remove the association

  • Bulk Create Team Members

    Create multiple team members in a single request

  • Bulk Update Team Members

    Update multiple team members in a single request

  • Accept Dispute

    Accept the loss on a dispute without submitting evidence

  • Submit Evidence

    Submit collected evidence to contest a dispute

Set Up Your Square MCP Server in Minutes

One endpoint. Any framework. Your agent is talking to Square in under 10 lines of code.

MCP Clients

Agent Frameworks

Claude Desktop
{
  "mcpServers": {
    "stackone": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.stackone.com/mcp?x-account-id=<account_id>",
        "--header",
        "Authorization: Basic <YOUR_BASE64_TOKEN>"
      ]
    }
  }
}

More Commerce MCP Servers

Klaviyo

162+ actions

Stripe

133+ actions

Magento

125+ actions

BigCommerce

120+ actions

Eventbrite

73+ actions

Gorgias

69+ actions

GoCardless

66+ actions

Square MCP Server FAQ

Square MCP server vs direct API integration — what's the difference?
A Square MCP server and direct API integration serve different use cases. Direct API integration is for software-to-software — backend code calling Square. A Square MCP server is for AI agents — MCP clients like Claude and Cursor, plus framework agents built with OpenAI, LangChain, or Vercel AI — discovering and calling Square at runtime. StackOne provides both.
How does Square authentication work for AI agents?
Square authentication for AI agents works through a StackOne Connect Session. Create one via the dashboard or the SDK — you get an auth link and ready-to-paste config for Claude Desktop, Cursor, and other MCP clients. Your user authenticates their own Square account; StackOne handles token exchange, storage, and refresh. Credentials never reach the LLM, and each user is isolated via origin_owner_id.
Are Square MCP tools vulnerable to prompt injection?
Yes — Square MCP tools can be vulnerable to indirect prompt injection. Any tool that reads user-written content — documents, messages, tickets, records, or free-text fields — is a potential vector. StackOne Defender scans every tool response before it enters the agent's context — regex patterns in ~1ms, then a MiniLM classifier in ~4ms. 88.7% accuracy, CPU-only.
What is the context bloat of a Square agent and how do I avoid it?
Context bloat happens when Square tool schemas and API responses eat your Square agent's memory, preventing it from reasoning effectively. A single Square query can return a massive JSON response, and connecting multiple tools compounds the problem. Tools Discovery and Code Mode reduce context bloat — loading only relevant tools per query and keeping raw responses out of the agent's context.
Can I limit which actions my Square agent can access?
Yes — you can limit which actions your Square agent can access directly from the StackOne dashboard. Toggle actions on or off, or restrict them to specific accounts, with no code changes to your agent. Session tokens can be scoped to exact actions so if one leaks, exposure stays contained.
Can I create custom agent actions for my Square MCP server?
Yes — you can create custom agent actions for your Square MCP server using Connector Builder. It's an integration agent your coding assistant (Claude Code, Cursor, or Copilot) can invoke to research Square's API, generate production-ready connector YAML, test against the live API, and validate before you ship.
When should I NOT use a Square MCP server?
Skip a Square MCP server if your integration is purely software-to-software — direct Square API integration is simpler when no AI agent is involved. For deterministic, compliance-critical operations (financial transactions, regulatory reporting), direct API gives you predictable behavior without agent-driven decision-making. MCP shines when AI agents need to dynamically discover and call Square actions at runtime.
What AI frameworks and AI clients does the StackOne Square MCP server support?
The StackOne Square MCP server supports both. MCP clients (paste-and-go apps): Claude Desktop, Claude Code, Cursor, VS Code, Goose. Agent frameworks (code SDKs you build with): OpenAI Agents SDK, Anthropic, Vercel AI, Google ADK, CrewAI, Pydantic AI, LangChain, LangGraph, Azure AI Foundry.

Put your AI agents to work

All the tools you need to build and scale AI agent integrations, with best-in-class connectivity, execution, and security.