MCP 服务器

petty-cash

io.github.theluckystrike/petty-cash
商业与运营 金融与投资 公开且可连接 MCP 2026-07-28

此 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.
输入模式
{'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.
只读 幂等
输入模式
{'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.
输入模式
{'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.
只读 幂等
输入模式
{'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.
输入模式
{'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.
输入模式
{'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.
输入模式
{'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.
输入模式
{'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.
可能执行破坏性操作
输入模式
{'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}
已更改
license_activate
2026年9月21日 02:56
已更改
license_status
2026年9月21日 02:56
已更改
float_report
2026年9月21日 02:56
已更改
replenish_request
2026年9月21日 02:56
已更改
reconcile
2026年9月21日 02:56
已更改
voucher_delete
2026年9月21日 02:56
已更改
voucher_add
2026年9月21日 02:56
已更改
topup_record
2026年9月21日 02:56
已更改
float_open
2026年9月21日 02:56
已添加
license_activate
2026年9月17日 12:52
已添加
license_status
2026年9月17日 12:52
已添加
float_report
2026年9月17日 12:52
已添加
replenish_request
2026年9月17日 12:52
已添加
reconcile
2026年9月17日 12:52
已添加
voucher_delete
2026年9月17日 12:52
已添加
voucher_add
2026年9月17日 12:52
已添加
topup_record
2026年9月17日 12:52
已添加
float_open
2026年9月17日 12:52