Security and retainer deposits per client: hold, apply to an invoice, refund, statement.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <Pro license key or anonymous token from GET https://mcp.zovo.one/mcp/token>
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Apply part of a held deposit to one invoice: it records that amount as a PAYMENT through the invoice server. amount_minor defaults to the lesser of held and owed. More than either, or a pre-arrival date, is refused.
Deposit id such as DEP-2026-0001, or an exact client name
The invoice number to apply it to, e.g. INV-2026-0001
YYYY-MM-DD, the day the deposit was set against the invoice. Defaults to today
Free text kept on the application row
How much of the deposit to apply, in minor units. Defaults to the smaller of what is held and what the invoice still owes
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Apply part of a held deposit to one invoice: it records that amount as a PAYMENT through the invoice server. amount_minor defaults to the lesser of held and owed. More than either, or a pre-arrival date, is refused.
| Argument | Type | Description |
|---|---|---|
| id* | string | Deposit id such as DEP-2026-0001, or an exact client name |
| date | string | YYYY-MM-DD, the day the deposit was set against the invoice. Defaults to today |
| note | string | Free text kept on the application row |
| invoice* | string | The invoice number to apply it to, e.g. INV-2026-0001 |
| amount_minor | integer | How much of the deposit to apply, in minor units. Defaults to the smaller of what is held and what the invoice still owes |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"invoice"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Deposit id such as DEP-2026-0001, or an exact client name"
},
"date": {
"type": "string",
"description": "YYYY-MM-DD, the day the deposit was set against the invoice. Defaults to today"
},
"note": {
"type": "string",
"maxLength": 10000,
"description": "Free text kept on the application row"
},
"invoice": {
"type": "string",
"minLength": 1,
"description": "The invoice number to apply it to, e.g. INV-2026-0001"
},
"amount_minor": {
"type": "integer",
"maximum": 1000000000000,
"description": "How much of the deposit to apply, in minor units. Defaults to the smaller of what is held and what the invoice still owes",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}Answer "how much of theirs am I holding?" for one client or everyone: received, applied to invoices, refunded and still held, one row per currency, never added across them. Reads only; deposit_list shows each deposit.
| Argument | Type | Description |
|---|---|---|
| as_of | string | YYYY-MM-DD, count only deposits received on or before this day |
| client | string | Client id, exact name or a name containing this text. Leave out for every client |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"as_of": {
"type": "string",
"description": "YYYY-MM-DD, count only deposits received on or before this day"
},
"client": {
"type": "string",
"description": "Client id, exact name or a name containing this text. Leave out for every client"
}
},
"additionalProperties": false
}Delete a deposit that never moved money, freeing that month's free-tier slot. One with anything applied or refunded is refused, naming it, since a payment or refund would be left with nothing behind it.
| Argument | Type | Description |
|---|---|---|
| id* | string | Deposit id such as DEP-2026-0001, or an exact client name |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Deposit id such as DEP-2026-0001, or an exact client name"
}
},
"additionalProperties": false
}List deposits newest first: DEP number, client, kind, date, reference and what was received, applied, refunded and still held, with the same four totalled per currency. Filter by client, status, kind, date.
| Argument | Type | Description |
|---|---|---|
| to | string | YYYY-MM-DD, latest received date |
| from | string | YYYY-MM-DD, earliest received date |
| kind | string | Default "all" |
| client | string | Only deposits for this client id, exact name, or a name containing this text |
| status | string | Default "all". held means some of the money is still held |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"to": {
"type": "string",
"description": "YYYY-MM-DD, latest received date"
},
"from": {
"type": "string",
"description": "YYYY-MM-DD, earliest received date"
},
"kind": {
"enum": [
"security",
"retainer",
"all"
],
"type": "string",
"description": "Default \"all\""
},
"client": {
"type": "string",
"description": "Only deposits for this client id, exact name, or a name containing this text"
},
"status": {
"enum": [
"held",
"applied",
"refunded",
"all"
],
"type": "string",
"description": "Default \"all\". held means some of the money is still held"
}
},
"additionalProperties": false
}Record a security or retainer deposit received from a client, in minor units, with its currency, the date it arrived and the bank reference. Returns the DEP-YYYY-NNNN id.
| Argument | Type | Description |
|---|---|---|
| kind* | string | security: held against damage or non-payment. retainer: held against work not yet invoiced |
| notes | string | Free text kept on the record and printed on the statement |
| client* | string | Client name or client id. A name the invoice server already knows brings its address, email and VAT id onto the deposit |
| currency | string | Defaults to your business default currency |
| reference | string | Bank reference, transfer note or cheque number the money arrived with |
| amount_minor* | integer | What was received, in MINOR units: 50000 = 500.00 EUR, 50000 = JPY 50000. Never a decimal |
| client_email | string | Only if the user gave it; otherwise the stored client's email is used |
| client_vat_id | string | Client VAT / tax registration id |
Give part or all of a held deposit back to the client, with the date and how it was sent. Refuses more than is still held. The invoice server is not touched: a refund is not a payment.
| Argument | Type | Description |
|---|---|---|
| id* | string | Deposit id such as DEP-2026-0001, or an exact client name |
| date | string | YYYY-MM-DD, the day the money went back. Defaults to today |
| note | string | Free text kept on the refund row |
| method | string | How it was sent, e.g. "bank transfer to the account it came from". Printed on the statement |
| amount_minor | integer | How much to give back, in minor units. Defaults to everything still held |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Deposit id such as DEP-2026-0001, or an exact client name"
},
"date": {
"type": "string",
"description": "YYYY-MM-DD, the day the money went back. Defaults to today"
},
"note": {
"type": "string",
"maxLength": 10000,
"description": "Free text kept on the refund row"
},
"method": {
"type": "string",
"maxLength": 200,
"description": "How it was sent, e.g. \"bank transfer to the account it came from\". Printed on the statement"
},
"amount_minor": {
"type": "integer",
"maximum": 1000000000000,
"description": "How much to give back, in minor units. Defaults to everything still held",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}Call this tool to render one client's A4 deposit statement and return a download link valid for one hour. Titled DEPOSIT STATEMENT, every movement in date order, closing with what is still held. Pro.
| Argument | Type | Description |
|---|---|---|
| as_of | string | YYYY-MM-DD printed as the statement date. Defaults to today |
| client* | string | Client id, exact name or a name containing this text |
| currency | string | Only needed when the client has deposits in more than one currency |
| out_path | string | Name for the downloaded file, e.g. acme-deposits. Defaults to the client and currency; the statement comes back as a download link valid for one hour |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"client"
],
"properties": {
"as_of": {
"type": "string",
"description": "YYYY-MM-DD printed as the statement date. Defaults to today"
},
"client": {
"type": "string",
"minLength": 1,
"description": "Client id, exact name or a name containing this text"
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Only needed when the client has deposits in more than one currency"
},
"out_path": {
"type": "string",
"description": "Name for the downloaded file, e.g. acme-deposits. Defaults to the client and currency; the statement comes back as a download link valid for one hour"
}
},
"additionalProperties": false
}Turn one client's deposits into a plain-text statement to paste into an email: every movement in date order and the closing balance held. Pass currency when they have more than one. Also a .txt download link valid one hour. Free on every tier.
| Argument | Type | Description |
|---|---|---|
| as_of | string | YYYY-MM-DD printed as the statement date. Defaults to today |
| client* | string | Client id, exact name or a name containing this text |
| currency | string | Only needed when the client has deposits in more than one currency |
| greeting | string | Opening line, default "Hello" plus the client name |
| sign_off | string | Closing line, default your business name from the shared profile |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"client"
],
"properties": {
"as_of": {
"type": "string",
"description": "YYYY-MM-DD printed as the statement date. Defaults to today"
},
"client": {
"type": "string",
"minLength": 1,
"description": "Client id, exact name or a name containing this text"
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Only needed when the client has deposits in more than one currency"
},
"greeting": {
"type": "string",
"description": "Opening line, default \"Hello\" plus the client name"
},
"sign_off": {
"type": "string",
"description": "Closing line, default your business name from the shared profile"
}
},
"additionalProperties": false
}The deposit book at a date: held per currency, received, applied and refunded, the oldest holdings with days held, and every deposit older than N days with nothing applied. Pro; deposit_balance is free.
| Argument | Type | Description |
|---|---|---|
| as_of | string | YYYY-MM-DD to count from. Defaults to today |
| limit | integer | How many oldest held deposits to list. Default 10 |
| older_than_days | integer | Flag deposits received this many days ago or more with nothing applied. Default 90 |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"as_of": {
"type": "string",
"description": "YYYY-MM-DD to count from. Defaults to today"
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "How many oldest held deposits to list. Default 10"
},
"older_than_days": {
"type": "integer",
"maximum": 36500,
"minimum": 0,
"description": "Flag deposits received this many days ago or more with nothing applied. Default 90"
}
},
"additionalProperties": false
}Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.
| Argument | Type | Description |
|---|---|---|
| key* | string | License key from checkout, MCPL1.<payload>.<signature> |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"key"
],
"properties": {
"key": {
"type": "string",
"description": "License key from checkout, MCPL1.<payload>.<signature>"
}
},
"additionalProperties": false
}Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}| received_date |
| string |
| YYYY-MM-DD, the day the money arrived. Defaults to today |
| client_address | string | Postal address for the statement's client block, newlines allowed |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"client",
"amount_minor",
"kind"
],
"properties": {
"kind": {
"enum": [
"security",
"retainer"
],
"type": "string",
"description": "security: held against damage or non-payment. retainer: held against work not yet invoiced"
},
"notes": {
"type": "string",
"maxLength": 10000,
"description": "Free text kept on the record and printed on the statement"
},
"client": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Client name or client id. A name the invoice server already knows brings its address, email and VAT id onto the deposit"
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Defaults to your business default currency"
},
"reference": {
"type": "string",
"maxLength": 200,
"description": "Bank reference, transfer note or cheque number the money arrived with"
},
"amount_minor": {
"type": "integer",
"maximum": 1000000000000,
"description": "What was received, in MINOR units: 50000 = 500.00 EUR, 50000 = JPY 50000. Never a decimal",
"exclusiveMinimum": 0
},
"client_email": {
"type": "string",
"maxLength": 320,
"description": "Only if the user gave it; otherwise the stored client's email is used"
},
"client_vat_id": {
"type": "string",
"maxLength": 64,
"description": "Client VAT / tax registration id"
},
"received_date": {
"type": "string",
"description": "YYYY-MM-DD, the day the money arrived. Defaults to today"
},
"client_address": {
"type": "string",
"maxLength": 2000,
"description": "Postal address for the statement's client block, newlines allowed"
}
},
"additionalProperties": false
}