Square
A Model Context Protocol (MCP) server for square
https://square.run.tools
How to connect
-
Smithery (hosted)
1. Open https://smithery.ai/servers/square 2. Click Connect and complete OAuth in your MCP client (Claude, Cursor, VS Code, etc.) 3. MCP endpoint: https://square.run.tools
Tools (26)
-
SQUARE_ACCEPT_DISPUTETool to accept a dispute and mark it as lost. Use after reviewing all evidence and deciding to accept liability.
-
SQUARE_CANCEL_INVOICETool to cancel an invoice. Use when you need to void an existing invoice; ensure the invoice isn't in DRAFT or a terminal state before cancelling.
-
SQUARE_CANCEL_PAYMENTTool to cancel a payment. Use after confirming the payment is in APPROVED status.
-
SQUARE_CREATE_CARDTool to create a card on file. Use when you need to securely store a customer's card for future payments. Requires a valid nonce or payment ID.
-
SQUARE_CREATE_DISPUTE_EVIDENCE_FILETool to upload a file as dispute evidence. Use when you need to attach supporting documents (PDF, image, etc.) to an existing dispute. Use after creating or retrieving a dispute.
-
SQUARE_CREATE_DISPUTE_EVIDENCE_TEXTTool to upload text as evidence for a dispute challenge. Endpoint: POST /v2/disputes/{dispute_id}/evidence-text
-
SQUARE_CREATE_INVOICE_ATTACHMENTTool to upload a file and attach it to a Square invoice. Use when you need to add supplementary documents to an invoice in DRAFT, SCHEDULED, UNPAID, or PARTIALLY_PAID state.
-
SQUARE_DELETE_DISPUTE_EVIDENCETool to delete specified evidence from a dispute. Use when you need to remove an evidence item that is no longer relevant. Use after verifying dispute_id and evidence_id.
-
SQUARE_DELETE_INVOICETool to delete a Square invoice (only DRAFT invoices can be deleted).
-
SQUARE_DELETE_INVOICE_ATTACHMENTTool to delete an attachment from a Square invoice. Endpoint: DELETE /v2/invoices/{invoice_id}/attachments/{attachment_id}
-
SQUARE_DELETE_WEBHOOK_SUBSCRIPTIONTool to delete a Square webhook subscription by ID.
-
SQUARE_GET_DISPUTE_EVIDENCETool to retrieve a specific evidence item associated with a given dispute. Endpoint: GET /v2/disputes/{dispute_id}/evidence/{evidence_id}
-
SQUARE_GET_INVOICETool to retrieve an invoice by ID. Use when you already have an invoice ID and need its details.
-
SQUARE_LIST_DISPUTE_EVIDENCETool to list evidence items associated with a given dispute. Endpoint: GET /v2/disputes/{dispute_id}/evidence
-
SQUARE_LIST_INVOICESTool to list invoices for a Square location.
-
SQUARE_LIST_WEBHOOK_EVENT_TYPESTool to list available webhook event types. Use when you need to discover event types before creating or updating a webhook subscription.
-
SQUARE_LIST_WEBHOOK_SUBSCRIPTIONSTool to list webhook subscriptions. Use when you need to retrieve a page of webhook subscriptions for your application; supports pagination.
-
SQUARE_RETRIEVE_DISPUTETool to retrieve a Square dispute by ID. Endpoint: GET /v2/disputes/{dispute_id}
-
SQUARE_RETRIEVE_ORDERTool to retrieve an order by its ID. Use when you have an order ID and need to fetch its details.
-
SQUARE_RETRIEVE_PAYMENT_LINKTool to retrieve a payment link by ID. Use when you need to fetch full details of a specific checkout link.
-
SQUARE_RETRIEVE_WEBHOOK_SUBSCRIPTIONTool to retrieve a Square webhook subscription by ID.
-
SQUARE_SUBMIT_DISPUTE_EVIDENCETool to submit evidence for a dispute. Use when you have compiled all supporting documentation and want to send it to the cardholder's bank before the due date.
-
SQUARE_TEST_WEBHOOK_SUBSCRIPTIONTool to test a webhook subscription. Use after creating or updating a subscription to verify its endpoint.
-
SQUARE_UPDATE_ORDERTool to update an order. Use when modifying fields on an existing open order; requires the latest version for optimistic concurrency.
-
SQUARE_UPDATE_WEBHOOK_SUBSCRIPTIONTool to update a Square webhook subscription. Use when you need to modify subscription settings such as name, enabled state, event types, notification URL, or API version of an existing webhook subscription.
-
SQUARE_UPDATE_WEBHOOK_SUBSCRIPTION_SIGNATURE_KEYTool to rotate the signature key for a webhook subscription. Use when you need to replace the current signature key for security purposes.