1. Docs
2. /
3. Tool reference
4. /
5. Commerce
6. /
7. listInvoices

Commerce

listInvoices

List Invoices

List a shop's invoices with customer, total, due date, payment link, and truthful payment state: paid, deposited, viewed, and any payment recorded by hand.

read

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "list my invoices", and it calls listInvoices.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {},
  "name": "listInvoices"
}

Arguments

• limitintegeroptionalNo description is declared in the tool schema.
• spacestringoptionalThe Space (shop) the invoice belongs to: its id, slug or exact name. Omit for the caller's personal shop.
• spaceIdstringoptionalA Space id or its team id; same as space.
• statusstringoptionalAllowed values: draft, open, paid, uncollectible, void.

Returns

The registry does not declare a return shape.

Declared limits

• limit: minimum 1
• limit: maximum 50

Ask for it

The Cloud routes these requests to this verb.

• list my invoices
• which invoices are unpaid
• is that invoice paid yet

Pair it with

The verbs that finish the job.

• createInvoice
• sendInvoice
• recordInvoicePayment
• voidInvoice
• listPayments

Questions

• What does listInvoices do?

  List a shop's invoices with customer, total, due date, payment link, and truthful payment state: paid, deposited, viewed, and any payment recorded by hand. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use listInvoices from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "list my invoices", and it calls listInvoices.

• Is listInvoices safe to let an AI call?

  listInvoices is read-only: it changes nothing.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.