Skip to content

Payment Gateway

Square MCP connector

The Square connector brings payments, refunds, and orders into Elaichi, so once Square is connected your team can look up a charge, issue a refund, or build an order from Claude, ChatGPT, Cursor, or the Elaichi Agent, each person signed in as themselves.

  • How it connects. Connects over OAuth. The credential goes into a vault nobody reads back.

  • One address. https://api.elaichi.ai/mcp, the same for every user.

  • Their own access. An agent never gets more than the person it acts for.

How to connect

How to connect Square to Claude, ChatGPT or Cursor

Two steps, about a minute.

1

In Elaichi

Connect Square once

  1. Open Connections, choose Add connection, and pick Square.

  2. Optionally set Share with to give a team access, then press Connect.

  3. Supply your own Square app, then approve. Square needs an OAuth app you register yourself, so bring its client ID and secret. One person does this once for the organization.

The credential is vaulted. Nobody reads it back, not even the AI.

Add connection

Choose a connector.

square
Square
Chimoney
Circle
Dwolla
Finexio
Flutterwave
2

In your AI client

Point it at one endpoint

Everyone in the organization uses the same address, and each person only ever reaches what their own account allows.

Connect Square to Claude

  1. 1

    Open Customize, then Connectors.

  2. 2

    Press Add.

  3. 3

    Name it, paste the MCP server URL, then Continue.

    https://api.elaichi.ai/mcp
  4. 4

    Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

Connect Square to ChatGPT

  1. 1

    Open Plugins, then press the + button.

  2. 2

    Name it and paste the endpoint into Server URL.

    https://api.elaichi.ai/mcp
  3. 3

    Leave Authentication on OAuth, then tick the risk acknowledgement.

  4. 4

    Press Create, then sign in and approve.

Works on the web today. The plugin directory lives at chatgpt.com/plugins.

Connect Square to Cursor

  1. 1

    Open ~/.cursor/mcp.json.

  2. 2

    Add the endpoint under mcpServers.

    https://api.elaichi.ai/mcp
  3. 3

    Reload Cursor, then sign in and approve.

~/.cursor/mcp.json

{
  "mcpServers": {
    "elaichi": {
      "url": "https://api.elaichi.ai/mcp"
    }
  }
}

Set up per machine, so repeat it on each computer you work from.

Connect Square to any MCP client

  1. 1

    Add the endpoint as a remote MCP server.

    https://api.elaichi.ai/mcp
  2. 2

    Sign in and approve.

{
  "mcpServers": {
    "elaichi": {
      "url": "https://api.elaichi.ai/mcp"
    }
  }
}

The Elaichi Agent already has these tools, with nothing to set up.

Use cases

What teams do with Square through Elaichi

Every one of these runs inside the access the person already has, and lands in the same audit log.

  • Support

    Find the charge a customer is asking about

    A customer emails about a payment they do not recognize. Pull up the Square payment by amount, date, or card details and tell them exactly what it was for.

  • Support

    Issue a refund without leaving the conversation

    When a return is approved, create the Square refund against the original payment and note the reason, all in the same thread where you are helping the customer.

  • Finance

    Reconcile yesterday's payments and refunds

    List every Square payment and refund for a date range, spot the ones that failed or were canceled, and get a clean picture before closing the books.

  • Operations

    Build and price an order before it is paid

    Create a Square order for a phone or catering request, calculate the total with taxes and discounts, and take the payment once the customer confirms.

  • Operations

    Repeat a standing order in one step

    Clone last week's Square order for a regular customer, adjust the quantities that changed, and send it through to payment.

  • Leadership

    Tag orders with the details you track

    Add custom fields to Square orders, such as event name or sales channel, so every order carries the context your reports need.

Try asking

  • “Show Square payments over 500 dollars from last week.”
  • “Which Square orders have open refunds right now?”
  • “Summarize Square refund totals by location this month.”

See all 287 Square tools below

AI tools

Square tools for your AI agents

287 tools are ready to call through Elaichi's MCP endpoint the moment you connect Square, governed by the same roles, restrictions, and audit log as everything else in Elaichi.

See it in Elaichi

What connecting Square gets you

6 screens from the product, each doing one job for your Square account.

The agent

Ask about Square payments in plain language.

Starter prompts pull live Square payments, orders and refunds into a straight answer.

  • payments
  • refunds
  • orders
  • customers

Ask Elaichi to work across your apps.

Show Square payments over 500 dollars from last week.

Which Square orders have open refunds right now?

Summarize Square refund totals by location this month.

Also runs in Claude, ChatGPT or Cursor

MCP clients

Claude, ChatGPT and Cursor reach Square.

One org MCP endpoint over OAuth, no SDK and no shared Square API key.

ElaichiMCP clients
Claude ChatGPT Cursor

Copy the endpoint

https://api.elaichi.ai/mcp
Client Connected by Status Last used
Claude
E

Emma Laurent

• Connected 4 minutes ago
Cursor
S

Sofia Ricci

• Connected 2 hours ago
ChatGPT
C

Clara Nowak

• Connected Yesterday

Tool catalog

287 Square tools land ready to call.

Payments, orders and refunds with their methods listed, and no custom code written.

  • List all Square payments
  • Get single Square payment by ID
  • Create a Square payment
  • Update a Square payment by ID
ElaichiTools
Tool Action Description
List all Square payments List List Square payments taken by the seller. Returns: id, amount_money, status, source_type, created_at.
Get single Square payment by ID Get Get a Square payment by id. Returns the full payment object including amount_money, status, source_type, and receipt details. Required: id.
Create a Square payment Create Create a Square payment by charging a payment source (card nonce, card on file, or other). Returns the created payment object including id, status, and amount_money. Requires source_id, idempotency_key, and amount_money.
Update a Square payment by ID Update Update a Square payment by id (e.g., adjust amounts, tip, or app fee on a delayed-capture payment). Returns the updated payment object. Requires id and idempotency_key.
Square payments cancel Cancel Cancel an uncompleted Square payment, releasing any held funds. Returns the canceled payment object with status CANCELED. Required: payment_id.

Toolboxes

Each team gets its own Square toolbox.

Finance, support and storefront teams see the Square tools their work needs.

  • Finance
  • Support
  • Storefront
  • Operations
ElaichiToolboxes
Name Source template Tools Created

Finance toolbox

Square · payments and refunds

Square starter 18 Mar 4, 2026

Support toolbox

Square · refunds and disputes

9 Mar 2, 2026

Storefront toolbox

Square · orders and checkout

24 Feb 27, 2026

Operations toolbox

Square · locations and inventory

Square starter 6 Feb 19, 2026

Data toolbox

Square · payment reporting

31 Jan 30, 2026

Compliance toolbox

Square · transaction records

12 Jan 22, 2026

Shared connections

Teammates use Square without seeing credentials.

Each Square connection shows who connected it and which teams and members share it.

  • Retail EMEA
  • Finance
  • Support
  • Storefront US
ElaichiConnections
Connection Scope Status Access
SQ

Square (Retail EMEA)

Connected by Emma Laurent

Personal • Active 1 team · 6 members
SQ

Square (Finance)

Connected by James Whitfield

Organization • Active 3 teams · 24 members
SQ

Square (Support)

Connected by Sofia Ricci

Organization • Active 2 teams · 11 members
SQ

Square (Storefront US)

Connected by Daniel Ortega

Personal • Needs re-auth 1 team · 3 members
SQ

Square (Operations)

Connected by Clara Nowak

Personal • Active Not shared
SQ

Square (Data)

Connected by Michael Brennan

Personal • Active 2 teams · 9 members

Audit log

Every Square call is on the record.

When, who, what happened, type and resource for each refund and order call.

  • When
  • Who
  • What happened
  • Type
ElaichiAudit log
When Who What happened Type

2 minutes ago

Mar 6, 2026, 3:10 PM

E

Emma Laurent

[email protected]

Restriction Created Access

8 minutes ago

Mar 6, 2026, 3:04 PM

J

James Whitfield

[email protected]

Restriction Updated Access

14 minutes ago

Mar 6, 2026, 2:58 PM

S

Sofia Ricci

[email protected]

Role Assigned Access

20 minutes ago

Mar 6, 2026, 2:52 PM

D

Daniel Ortega

[email protected]

Square Users Updated MCP

26 minutes ago

Mar 6, 2026, 2:46 PM

C

Clara Nowak

[email protected]

Square Payments Created MCP

32 minutes ago

Mar 6, 2026, 2:40 PM

M

Michael Brennan

[email protected]

Square Payments List Toolbox

Launching soon

From answering questions to doing the work

A person no longer has to ask. A trigger starts the work, inside the same permissions and the same audit log as everything else. Automations and live dashboards are launching soon, on the Black plan.

Automations

A schedule drafts your Square payments digest.

Six steps fetch payments, group them, draft a digest, wait for approval, post back.

Square digest

Run 418 · started 2 minutes ago · on behalf of Emma Laurent

  1. Schedule

    Every weekday at 08:00

    0.2s
  2. Fetch payments

    Square

    1.4s
  3. Group by owner

    Transform

    0.1s
  4. Draft the digest

    Agent step

    Ran with 4 tools, returned a structured summary

    6.2s
  5. Approve the digest

    Needs approval

    Assigned to Michael Brennan

    Approve
  6. Post the digest

    Square

    Queued

Collections and dashboards

Square order health, refreshed on a schedule.

Four metrics, 14 days of orders created and a team breakdown, computed without a model.

Square health

Refreshed 4 minutes ago · every 15 minutes · from the payments collection

Live

Payments

1,284 ↓ 12%

Refunds

96 ↓ 8%

Needs attention

3 ↑ 2

Updated this week

412 ↑ 9%

Payments created

Last 14 days

By team

Share of activity

Retail EMEA 34%

Finance 27%

Support 21%

Storefront US 18%

FAQ

Frequently asked questions

How do I connect Square to Claude?

Connect Square in Elaichi first, then in Claude go to Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp as the endpoint. Square requires an OAuth application registered inside Square, so one person on your team creates it in the Square developer dashboard and enters its client ID and secret in Elaichi once. After that, everyone else simply signs in with their own Square login when prompted and never sees those details.

Does Square work with ChatGPT and Cursor as well as Claude?

Yes. Once Square is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent. You connect Square once and it is available everywhere your team already works.

What can an AI agent actually do with my Square data?

With Square connected, an agent can look up a payment, list the payments and refunds from a given day, create or cancel a payment, issue a refund, and build, price, clone, or pay a Square order. It can also manage the custom fields you attach to orders. Short, specific asks such as "refund payment ending 4421 from Tuesday" work better than long paragraphs.

Does connecting Square give the AI access to every location and every transaction?

No. Everything an agent does in Square runs under the Square permissions of the person who signed in, so it can only see the locations and transactions that person can already see. Elaichi can narrow that further, for example to read-only or to a subset of actions, but it can never grant more than the person already has in Square.

Can my team share one Square connection?

Yes. One person connects Square in Elaichi and shares the connection with a team, and nobody else needs to handle the client ID, secret, or any other credential. Each teammate still signs in as themselves, so the audit log records who issued a refund or changed an order, not just that the shared Square connection did.

Can I stop an agent from deleting or changing things in Square?

Yes. Restrictions in Elaichi work per action, so you can allow reading Square payments and orders while blocking refunds, cancellations, or edits. A blocked action is never shown to Claude, ChatGPT, or any other client at all, so no prompt, however worded, can reach it.

What happens to a Square connection when someone leaves?

When you offboard a person in Elaichi, their access to Square through every connected client ends immediately. If they connected a shared Square connection, it keeps working for everyone else on the team. If you ever want Square gone entirely, disconnecting it once in Elaichi removes it from Claude, ChatGPT, Cursor, and every other client at the same time.

Put Square in front of your team

Fourteen days on Gold, no credit card. Connect it once and pick what each team can call.