# Square (verified)

Process payments, manage subscriptions, send invoices, and handle disputes. Accept card payments and track POS transactions.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add square

# Browse available tools
npx -y @smithery/cli@latest tool list square

# Get full schema for a tool
npx -y @smithery/cli@latest tool get square SQUARE_ACCEPT_DISPUTE

# Call a tool
npx -y @smithery/cli@latest tool call square SQUARE_ACCEPT_DISPUTE '{}'
```

## Direct MCP Connection

Endpoint: `https://square.run.tools`

## Tools (26)

- `SQUARE_ACCEPT_DISPUTE` — Tool to accept a dispute and mark it as lost. Use after reviewing all evidence and deciding to accept liability.
- `SQUARE_CANCEL_INVOICE` — Tool to cancel an invoice. Use when you need to void an existing invoice; ensure the invoice isn't in DRAFT or a termin…
- `SQUARE_CANCEL_PAYMENT` — Tool to cancel a payment. Use after confirming the payment is in APPROVED status.
- `SQUARE_CREATE_CARD` — Tool to create a card on file. Use when you need to securely store a customer's card for future payments. Requires a va…
- `SQUARE_CREATE_DISPUTE_EVIDENCE_FILE` — Tool to upload a file as dispute evidence. Use when you need to attach supporting documents (PDF, image, etc.) to an ex…
- `SQUARE_CREATE_DISPUTE_EVIDENCE_TEXT` — Tool to upload text as evidence for a dispute challenge. Endpoint: POST /v2/disputes/{dispute_id}/evidence-text
- `SQUARE_CREATE_INVOICE_ATTACHMENT` — Tool to upload a file and attach it to a Square invoice. Use when you need to add supplementary documents to an invoice…
- `SQUARE_DELETE_DISPUTE_EVIDENCE` — Tool to delete specified evidence from a dispute. Use when you need to remove an evidence item that is no longer releva…
- `SQUARE_DELETE_INVOICE` — Tool to delete a Square invoice (only DRAFT invoices can be deleted).
- `SQUARE_DELETE_INVOICE_ATTACHMENT` — Tool to delete an attachment from a Square invoice. Endpoint: DELETE /v2/invoices/{invoice_id}/attachments/{attachment_…
- `SQUARE_DELETE_WEBHOOK_SUBSCRIPTION` — Tool to delete a Square webhook subscription by ID.
- `SQUARE_GET_DISPUTE_EVIDENCE` — Tool to retrieve a specific evidence item associated with a given dispute. Endpoint: GET /v2/disputes/{dispute_id}/evid…
- `SQUARE_GET_INVOICE` — Tool to retrieve an invoice by ID. Use when you already have an invoice ID and need its details.
- `SQUARE_LIST_DISPUTE_EVIDENCE` — Tool to list evidence items associated with a given dispute. Endpoint: GET /v2/disputes/{dispute_id}/evidence
- `SQUARE_LIST_INVOICES` — Tool to list invoices for a Square location.
- `SQUARE_LIST_WEBHOOK_EVENT_TYPES` — Tool to list available webhook event types. Use when you need to discover event types before creating or updating a web…
- `SQUARE_LIST_WEBHOOK_SUBSCRIPTIONS` — Tool to list webhook subscriptions. Use when you need to retrieve a page of webhook subscriptions for your application;…
- `SQUARE_RETRIEVE_DISPUTE` — Tool to retrieve a Square dispute by ID. Endpoint: GET /v2/disputes/{dispute_id}
- `SQUARE_RETRIEVE_ORDER` — Tool to retrieve an order by its ID. Use when you have an order ID and need to fetch its details.
- `SQUARE_RETRIEVE_PAYMENT_LINK` — Tool to retrieve a payment link by ID. Use when you need to fetch full details of a specific checkout link.
- `SQUARE_RETRIEVE_WEBHOOK_SUBSCRIPTION` — Tool to retrieve a Square webhook subscription by ID.
- `SQUARE_SUBMIT_DISPUTE_EVIDENCE` — Tool to submit evidence for a dispute. Use when you have compiled all supporting documentation and want to send it to t…
- `SQUARE_TEST_WEBHOOK_SUBSCRIPTION` — Tool to test a webhook subscription. Use after creating or updating a subscription to verify its endpoint.
- `SQUARE_UPDATE_ORDER` — Tool to update an order. Use when modifying fields on an existing open order; requires the latest version for optimisti…
- `SQUARE_UPDATE_WEBHOOK_SUBSCRIPTION` — Tool to update a Square webhook subscription. Use when you need to modify subscription settings such as name, enabled s…
- `SQUARE_UPDATE_WEBHOOK_SUBSCRIPTION_SIGNATURE_KEY` — Tool to rotate the signature key for a webhook subscription. Use when you need to replace the current signature key for…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get square <tool-name>
```