List invoices
Invoices and credit notes in the account with folio, client, total and status, newest first.
MCP tool facturama_read → list_invoices
read
Lists CFDI documents issued from the account, newest first, including invoices, credit notes and cancelled ones, each with its status. Filter by issue date or client RFC. Pages hold up to 100 documents; pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| issued_since date | date | Only documents issued on or after this date, YYYY-MM-DD. |
| issued_until date | date | Only documents issued on or before this date, YYYY-MM-DD. |
| client_rfc string | string | Only documents for this client RFC. |
| limit integer | integer | 1 to 100. Default: 50. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "facturama_read",
"arguments": {
"operation": "list_invoices",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoices": [
{
"invoice_id": "Y61TLX-Ls_ZJFqzjanPN1w2",
"series": "FAC",
"folio": "101",
"cfdi_type": "ingreso",
"status": "issued",
"issued_at": "2026-10-14",
"client_name": "Estudio Norte SA de CV",
"total": 1160,
"currency": "MXN"
}
],
"next_cursor": null
},
"isError": false
}