Petty Cash

Working · 30 ms

io.github.theluckystrike/petty-cashv0.22.6

A petty cash float on the imprest system: vouchers, reconciliation and the replenishment.

Finance & Payments

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.zovo.one/mcp/petty-cash

Authorization (required)

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.

float_open

Open a petty cash float on the imprest system and return its id. The imprest is the cash the tin is topped back up to at every replenishment, in whole minor units. Free tier: one float.

namestring, required

What this tin is, e.g. Office float or Warehouse float

currencystring, required

ISO code the cash is held in

imprest_minorinteger, required

The float amount in whole minor units (integer cents). 50000 is EUR 500.00

notestring

openedstring

The date the float was handed over, YYYY-MM-DD. Default today

custodianstring

Who holds the tin. Defaults to the shared business profile's name

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (9)

float_open

Open a petty cash float on the imprest system and return its id. The imprest is the cash the tin is topped back up to at every replenishment, in whole minor units. Free tier: one float.

Argument	Type	Description
name*	string	What this tin is, e.g. Office float or Warehouse float
note	string
opened	string	The date the float was handed over, YYYY-MM-DD. Default today
currency*	string	ISO code the cash is held in
custodian	string	Who holds the tin. Defaults to the shared business profile's name
imprest_minor*	integer	The float amount in whole minor units (integer cents). 50000 is EUR 500.00

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name",
    "currency",
    "imprest_minor"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 200,
      "description": "What this tin is, e.g. Office float or Warehouse float"
    },
    "note": {
      "type": "string",
      "maxLength": 2000
    },
    "opened": {
      "type": "string",
      "maxLength": 10,
      "description": "The date the float was handed over, YYYY-MM-DD. Default today"
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "ISO code the cash is held in"
    },
    "custodian": {
      "type": "string",
      "maxLength": 200,
      "description": "Who holds the tin. Defaults to the shared business profile's name"
    },
    "imprest_minor": {
      "type": "integer",
      "maximum": 100000000000000,
      "minimum": 1,
      "description": "The float amount in whole minor units (integer cents). 50000 is EUR 500.00"
    }
  },
  "additionalProperties": false
}

float_report

Report each float: balance against imprest, what it takes to restore it, unreconciled vouchers with their total, the last count, and the history of what counts found over or short. Pro.

read-only

Argument	Type	Description
float	string	The float id, e.g. FLOAT-2026-0001, or its name. Omit when there is only one
limit	integer	Maximum unreconciled vouchers listed per float, default and ceiling 2000

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "float": {
      "type": "string",
      "maxLength": 200,
      "description": "The float id, e.g. FLOAT-2026-0001, or its name. Omit when there is only one"
    },
    "limit": {
      "type": "integer",
      "maximum": 2000,
      "minimum": 1,
      "description": "Maximum unreconciled vouchers listed per float, default and ceiling 2000"
    }
  },
  "additionalProperties": false
}

license_activate

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>

Input schema (JSON)

{
  "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
}

license_status

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

reconcile

Count the tin: give the cash counted in whole MINOR units and the date, and get the expected balance, the difference, and every voucher since the last count, which this marks reconciled. Free.

Argument	Type	Description
date*	string	The date it was counted, YYYY-MM-DD
float	string	The float id, e.g. FLOAT-2026-0001, or its name. Omit when there is only one
counted_minor*	integer	The cash actually counted, in whole minor units

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "counted_minor",
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "maxLength": 10,
      "description": "The date it was counted, YYYY-MM-DD"
    },
    "float": {
      "type": "string",
      "maxLength": 200,
      "description": "The float id, e.g. FLOAT-2026-0001, or its name. Omit when there is only one"
    },
    "counted_minor": {
      "type": "integer",
      "maximum": 100000000000000,
      "minimum": 0,
      "description": "The cash actually counted, in whole minor units"
    }
  },
  "additionalProperties": false
}

replenish_request

Work out what puts the float back to its imprest: the amount, the vouchers it reimburses, the totals per category as an expense_add-ready payload, and the double entry. Writes nothing. Pro.

Argument	Type	Description
date	string	The date the request is made, YYYY-MM-DD. Default today
float	string	The float id, e.g. FLOAT-2026-0001, or its name. Omit when there is only one

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "date": {
      "type": "string",
      "maxLength": 10,
      "description": "The date the request is made, YYYY-MM-DD. Default today"
    },
    "float": {
      "type": "string",
      "maxLength": 200,
      "description": "The float id, e.g. FLOAT-2026-0001, or its name. Omit when there is only one"
    }
  },
  "additionalProperties": false
}

topup_record

Record cash put into the tin, in whole MINOR units, with the date and source, and return the new balance against the imprest. It also reimburses every voucher up to that date, as a replenishment does.

Argument	Type	Description
date*	string	The date the cash went in, YYYY-MM-DD
float	string	The float id, e.g. FLOAT-2026-0001, or its name. Omit when there is only one
source*	string	Where it came from, e.g. Cheque 0142, Bank withdrawal, or Owner
amount_minor*	integer	Cash added, in whole minor units

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "amount_minor",
    "date",
    "source"
  ],
  "properties": {
    "date": {
      "type": "string",
      "maxLength": 10,
      "description": "The date the cash went in, YYYY-MM-DD"
    },
    "float": {
      "type": "string",
      "maxLength": 200,
      "description": "The float id, e.g. FLOAT-2026-0001, or its name. Omit when there is only one"
    },
    "source": {
      "type": "string",
      "maxLength": 200,
      "description": "Where it came from, e.g. Cheque 0142, Bank withdrawal, or Owner"
    },
    "amount_minor": {
      "type": "integer",
      "maximum": 100000000000000,
      "minimum": 1,
      "description": "Cash added, in whole minor units"
    }
  },
  "additionalProperties": false
}

voucher_add

Record one voucher paid out of the tin and return its VOU-YYYY-NNNN number. More than the float holds is refused, and so is a byte-identical duplicate. Free tier: 20 vouchers a calendar month.

Argument	Type	Description
date*	string	The date the cash left the tin, YYYY-MM-DD
float	string	The float id, e.g. FLOAT-2026-0001, or its name. Omit when there is only one
paid_to*	string	Who was paid, e.g. Corner Shop
category*	string	What kind of spend, e.g. postage, travel, office. It becomes the expenses:<category> account
description*	string	What was bought, e.g. Printer paper x5
receipt_ref	string	The receipt number or where the paper is filed
amount_minor*	integer	What was paid out, in whole minor units. 1250 is EUR 12.50
duplicate_ok	boolean	Record it even though an identical voucher exists, for a genuinely repeated purchase. Default false

voucher_delete

Delete a voucher entered wrongly, by its VOU number. One already covered by a reconciliation is refused, naming the count it would falsify: record a correcting voucher instead. Free.

destructive

Argument	Type	Description
voucher*	string	The voucher id, e.g. VOU-2026-0003

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "voucher"
  ],
  "properties": {
    "voucher": {
      "type": "string",
      "maxLength": 200,
      "description": "The voucher id, e.g. VOU-2026-0003"
    }
  },
  "additionalProperties": false
}