# Settlements, deposits and billing

> MCP tools to query the next settlement, the settlement history, security deposits and the invoices Tilopay issues to you.

- kind: mcp-tool
- status: stable
- access: write
- last_verified: 2026-10-07
- url: https://tilopay.com/en/developers/agentes/mcp/liquidaciones

## What it covers [#que-cubre]

This group covers the money Tilopay settles to you: the pending balance and the date of
the next deposit, already processed settlements with their transactions, security deposits
(pre-authorizations held on customers) and the invoices Tilopay issues for using the platform.
Everything is read-only except extending a security deposit, which requires a six-digit code sent
by email.

## Tools [#herramientas]

### Next settlement and balance to settle [#tilopay-settlement-balance]

- `tilopay_settlement_balance`
- Access: Read only

OFFICIAL Tilopay data: date of the next deposit (next_settlement), settlement frequency, destination IBAN account and, per currency, the accumulated pending balance with its breakdown (subtotal, commission, iva_commission, retention, retention_iva, cost, iva_tilopay, transfer, transfer_iva, net total).

**Parameters**

No parameters.

**Returns**

`{ next_settlement, commerce, accumulated_balance, accumulated_balance_details }`

next_settlement = next settlement; commerce = merchant data with the masked IBAN; accumulated_balance = [{ total, currency }]; accumulated_balance_details = the detail.

### Settlement history [#tilopay-settlements-list]

- `tilopay_settlements_list`
- Access: Read only

Settlements already processed by Tilopay: deposit date (date_to_report), period, gross amount, deductions and total transferred. Use it for 'did they deposit Friday's money yet?' or 'how much did they deposit last month?'.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | — | Page (1 by default) |
| `limit` | integer | — | Records per page (20 by default) |
| `search` | string | — | Text to search |

**Returns**



### Transactions of a settlement [#tilopay-settlement-transactions]

- `tilopay_settlement_transactions`
- Access: Read only

Transactions included in an already processed settlement (id obtained from tilopay_settlements_list).

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `settlement_id` | string | yes | Settlement id |

**Returns**



### Security deposits (pre-authorizations) [#tilopay-deposits-list]

- `tilopay_deposits_list`
- Access: Read only

Security deposits or pre-authorizations held on customers (car rental, hospitality, security deposits): amount, status and expiration. Not to be confused with settlements.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | — | Page (1 by default) |
| `limit` | integer | — | Records per page (20 by default) |
| `search` | string | — | Text to search |

**Returns**



### Detail of a security deposit [#tilopay-deposit-detail]

- `tilopay_deposit_detail`
- Access: Read only

Detail of a security deposit (id from tilopay_deposits_list).

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `deposit_id` | string | yes | Deposit id |

**Returns**



### Extend a security deposit [#tilopay-deposit-extend]

- `tilopay_deposit_extend`
- Access: Write

Extends a security deposit authorization, owner only. Requires a 6-digit email code, but confirmation_code is not declared in the schema: the two-call flow is completed through the WhatsApp Assistant.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `deposit_id` | string | yes | Deposit id |

**Returns**

After authorization, the extension data returned by Tilopay.

### Tilopay service invoices [#tilopay-billing-list]

- `tilopay_billing_list`
- Access: Read only

Invoices Tilopay issues to the merchant for using the platform (they are not the merchant's sales). Use it for 'how much did Tilopay charge me this month?' or 'where is my Tilopay invoice?'.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | — | Page (1 by default) |
| `limit` | integer | — | Records per page (20 by default) |
| `search` | string | — | Text to search |

**Returns**