Home / Servers / Square API / cancel_invoice

CancelInvoice

An MCP tool from the Square API server, hosted on mcp.hjlabs.in.

CancelInvoice Cancels an invoice. The seller cannot collect payments for the canceled invoice. You cannot cancel an invoice in the DRAFT state or in a terminal state: PAID, REFUNDED, CANCELED, or FAILED. [POST /v2/invoices/{invoice_id}/cancel]

Name on the gateway: square_api__cancel_invoice · may change things.

Parameters

NameTypeDescription
invoice_id requiredstringThe ID of the invoice to cancel.
version requiredintegerThe version of the invoice to cancel. If you do not know the version, you can…

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "square_api__cancel_invoice",
  "arguments": {
    "invoice_id": "…",
    "version": 0
  }
}

Or connect the Square API server directly, which lists 308 tools including this one:

Run in your terminal
claude mcp add --transport http hj-square-api https://mcp.hjlabs.in/mcp/square-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the cancelinvoice tool with invoice_id set to ….

More from Square API