Serveur MCP

petty-cash

io.github.theluckystrike/petty-cash

Ce que fait ce MCP

Manages an imprest petty-cash float, including vouchers, cash counts, reconciliation, top-ups, and replenishment calculations.

float_open
Open a petty cash float
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.
Schéma d’entrée
{'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 the state of the float
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.
Lecture seule Idempotent
Schéma d’entrée
{'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
Activate license
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.
Schéma d’entrée
{'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
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
reconcile
Count the tin and 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.
Schéma d’entrée
{'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
Request a replenishment
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.
Schéma d’entrée
{'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 float
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.
Schéma d’entrée
{'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 a petty cash voucher
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.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['amount_minor', 'date', 'category', 'description', 'paid_to'], 'properties': {'date': {'type': 'string', 'maxLength': 10, 'description': 'The date the cash left the tin, 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'}, 'paid_to': {'type': 'string', 'maxLength': 200, 'description': 'Who was paid, e.g. Corner Shop'}, 'category': {'type': 'string', 'maxLength': 200, 'description': 'What kind of spend, e.g. postage, travel, office. It becomes the expenses:<category> account'}, 'description': {'type': 'string', 'maxLength': 2000, 'description': 'What was bought, e.g. Printer paper x5'}, 'receipt_ref': {'type': 'string', 'maxLength': 200, 'description': 'The receipt number or where the paper is filed'}, 'amount_minor': {'type': 'integer', 'maximum': 100000000000000, 'minimum': 1, 'description': 'What was paid out, in whole minor units. 1250 is EUR 12.50'}, 'duplicate_ok': {'type': 'boolean', 'description': 'Record it even though an identical voucher exists, for a genuinely repeated purchase. Default false'}}, 'additionalProperties': False}
voucher_delete
Delete a voucher
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.
Destructif
Schéma d’entrée
{'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}
Modifié
license_activate
21 September 2026 02:56
Modifié
license_status
21 September 2026 02:56
Modifié
float_report
21 September 2026 02:56
Modifié
replenish_request
21 September 2026 02:56
Modifié
reconcile
21 September 2026 02:56
Modifié
voucher_delete
21 September 2026 02:56
Modifié
voucher_add
21 September 2026 02:56
Modifié
topup_record
21 September 2026 02:56
Modifié
float_open
21 September 2026 02:56
Ajouté
license_activate
17 September 2026 12:52
Ajouté
license_status
17 September 2026 12:52
Ajouté
float_report
17 September 2026 12:52
Ajouté
replenish_request
17 September 2026 12:52
Ajouté
reconcile
17 September 2026 12:52
Ajouté
voucher_delete
17 September 2026 12:52
Ajouté
voucher_add
17 September 2026 12:52
Ajouté
topup_record
17 September 2026 12:52
Ajouté
float_open
17 September 2026 12:52