PocketQuota
PocketQuota is an MCP budget-ledger server for viewing and managing daily quotas, pools, transactions, notifications, and schedules.
Read today's quota, pool balances, overspend and insolvency status.
List dated journal entries, including reversals and automatic allocations, with start/end/offset filters.
Record user-authorized expenses, income, and transfers idempotently; daily overspend is covered by flex.
Reverse incorrect manual transactions while preserving audit history.
Record explicitly supplied real balances via reconciliation without automatically adjusting the ledger.
List and acknowledge budget-exhausted notifications after successful owner delivery.
Configure daily allowance, carry-over, settlement/review times, and effective dates with manage scope.
Adjust pool balances with an audit reason.
Create, edit, pause, and list daily or monthly credit schedules.
Explicitly settle a day early; automatic settlement also runs on the server.
Supports read-only, bookkeeping, and budget-management permission scopes.
Connects Hermes agents via standard MCP stdio to PocketQuota, allowing them to record transactions, query budgets, manage quota settings, and stay synchronized with the same web account ledger.
Provides an OpenAI-compatible function-calling adapter and REST/OpenAPI interface so OpenAI-compatible agents can interact with PocketQuota to record spending, check remaining limits, and manage budget rules.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PocketQuota 午饭花了 18.5,记日常池。"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
v0.3.1 · 双环与双光轨同时显示今日额度和日常池总余额,配合蓄水池、保险柜与共享账本。更新详情
今天,还能自由花多少?
PocketQuota 把这个问题变成一条看得见的额度。
给日常消费设定限额,把节省下来的钱存进灵活池;需要多一点空间时,自动从灵活池补足。你可以随手在网页记一笔,也可以直接告诉自己的 Agent——两边始终共用同一本账。
日常有边界,灵活有余地。
Related MCP server: agent-budget
一个额度面板,掌握消费节奏
看见额度 | 让规则运转 | 和 Agent 协作 |
今日剩余、资金池余额、消费趋势一眼可见 | 每日结余自动划转,补贴与生活费按时入账 | 对话记账、查询预算、核对账目、接收额度提醒 |
黑白主题,线形光轨与圆环自由切换 | 补记、撤销、余额调整都有完整记录 | 网页账号与 Agent 共享同一份预算和通知 |
额度随消费变化:扣款时粒子轻轻消散,入账时光带汇入。三套光谱配色,搭配清爽的黑白界面,把每天看预算变成一件舒服的事。
把钱分好,把选择留给自己
资金池 | 为你做什么 |
日常池 | 每天的默认消费来源,用每日限额把握节奏 |
灵活池 | 接住每日结余,承接超额消费,也可直接指定使用 |
保底池 | 单独留存的一份安心,由你明确安排用途 |
例如:每天额度 ¥60,今天已经花了 ¥50,再记一笔 ¥25。PocketQuota 会自动分配 日常 ¥10 + 灵活 ¥15,清楚展示每一分钱的去向。
月底回顾、每日核对、临时调整,都可以在同一个地方完成。CSV 导出支持日期筛选、中文列名和各资金池实际扣款额,方便继续用 Excel 整理。
当可消费预算耗尽,界面会切换为醒目的红色 “赤字 · 已破产” 状态,并生成供通知 Agent 领取的额度事件。提醒流程见 Agent 通知指南。
一句话记账,剩下交给规则
“午饭花了 18.5,记日常池。”
“这次旅行的车费 35,走灵活池。”
“今天还剩多少额度?”
“把每日限额改成 60,明天开始。”
“每月 1 号上午 9 点,给日常池记入 1800 生活费。”给你的 Agent 一枚本账号的专用令牌,就能让对话与网页保持同步。按需要选择 只读、记账、预算管理 三档权限。
你正在使用的工具 | 接入方式 |
Codex | |
Claude Code / Desktop、Cursor | |
VS Code Copilot、Gemini CLI | |
Hermes 与其他 MCP Agent | |
DeepSeek / OpenAI-compatible 与自建 Agent |
13 个 MCP 工具,一套统一账本接口。 配置步骤、工具权限与客户端验证情况集中在 Agent 接入文档。
开始体验
准备 Python 3.11+,运行三行命令:
git clone https://github.com/ReHowever/pocketquota.git
cd pocketquota
python3 -m pocketquota.server --demo --data .demo-data打开 本机演示,点击 “试用演示账本”,即可探索完整界面与虚构示例。
准备开始自己的预算时,使用 正式部署指南。支持直接运行、Python 安装包与 Docker。
自己掌握数据,也掌握规则
独立账号:每个用户拥有自己的账本,Agent 绑定同一账号。
随机初始密码:默认管理员与新建用户均使用随机强密码。
可追溯账本:金额精确到分,自动结算、补记和撤销都有记录。
按你的节奏:日限、生效日、结算时间、月对账日期和定期入账都可配置。
开源可扩展:MIT 许可,标准接口,适合个人使用和继续构建自己的工具。
继续探索
使用指南 · 部署与备份 · Agent 接入 · API · 设计说明 · 安全说明 · 发布验收
欢迎分享使用体验、提出功能建议,或通过 Issue 与 Pull Request 一起完善 PocketQuota。
Available Tools
13 toolsbudget_ack_notificationAIdempotent
Acknowledge an event only AFTER successful owner notification. Failed delivery must remain pending. Use one designated notification agent per ledger.
Inputs: id (required), request_id (required).
budget_adjust_poolAIdempotent
Requires manage scope and explicit user request. Set a pool's actual budget balance with an audit reason; this creates an adjustment entry, not a bank transfer.
Inputs: pool (required), reason (required), balance (required), request_id (required).
budget_configureAIdempotent
Requires manage scope and explicit user request. Change daily allowance or settlement/review times. Fetch budget_status first for settings.revision; effective date cannot be in the past.
Inputs: revision (required), request_id (required), name, effective, +5 more.
budget_notificationsARead-only
List unacknowledged budget-exhausted notifications. Only notify the ledger owner through an authorized channel. Empty list means remain silent. Use event ID to deduplicate delivery.
Inputs: no named parameters.
budget_reconcileBIdempotent
Record a user's explicitly supplied real balances. Never fabricate actual balances from expected values. Does not automatically adjust the ledger.
Inputs: actual (required), period (required), request_id (required), note.
budget_recordBIdempotent
Record user-authorized expense, income or transfer. Default pool daily. Excess daily quota or exhausted daily pool is immediately covered by flex. Reuse request_id when retrying this same user request.
Inputs: amount (required), request_id (required), date, kind, +4 more.
budget_reverseBIdempotent
Reverse an incorrect manual transaction, preserving audit. Only on user authorization; do not silently delete or hide history.
Inputs: id (required), reason (required), request_id (required).
budget_scheduleAIdempotent
Requires manage scope and explicit user request. Create/edit/pause a daily or monthly credit schedule. Only accounting, not a payment. Existing schedule IDs come from budget_schedules.
Inputs: amount (required), request_id (required), id, day, +5 more.
budget_schedulesBRead-only
List recurring credit schedules and their IDs.
Inputs: no named parameters.
budget_settleAIdempotent
Requires manage scope. Explicitly settle a day early; automatic settlement already runs on the server. Safe to retry with the same request_id.
Inputs: request_id (required), date.
budget_statusARead-only
Read today's quota, pool balances, overspend and insolvency status. Money returned in integer cents.
Inputs: no named parameters.
budget_summaryARead-only
Read expected pool balances and settlements for a day YYYY-MM-DD or completed month YYYY-MM.
Inputs: period (required).
budget_transactionsCRead-only
Read dated journal entries, including reversals and automatic allocations.
Inputs: end, start, offset.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Most tools target clearly distinct actions or resources, with readable boundaries between recording, reversing, settling, scheduling, and notification handling. Minor potential confusion exists between budget_status and budget_summary, and between budget_adjust_pool and budget_reconcile, though descriptions clarify the different effects.
All tools use a consistent budget_ prefix and snake_case. Suffixes mix nouns and verbs (budget_status, budget_record, budget_schedules, budget_ack_notification), which is readable but not a strict verb_noun pattern.
The 13 tools are well within a manageable range and each appears to serve a distinct budget/quota workflow. The set is neither thin nor bloated for a ledger-style server.
Core workflows are covered: status, transaction recording/reversal, summaries, reconciliation, scheduling, settlement, and notification acknowledgement. Minor gaps may exist around explicit pool lifecycle management and detailed single-record retrieval, but agents can work around them via existing list and adjustment tools.
Maintenance
Related MCP Connectors
The budget app your AI agent can use. Check budgets and log spending, with no bank logins.
Budget & cost control for AI agents — per-agent spend caps + rate limits before each call.
Agentic workflow budget approvals with usage receipts.
Personal finance ledger for AI agents — query spending, track bills, forecast cash flow.
Related MCP Servers
- AlicenseAqualityCmaintenanceSpending limits for AI agents. Create budgets, enforce limits, track spend across x402, cards, MPP, or any payment rail.7Apache 2.0
- AlicenseNot gradedqualityDmaintenanceBudget management and cost tracking MCP server for autonomous agents, enabling budget creation, cost recording, spending projections, and alert rules.MIT
- AlicenseNot gradedqualityCmaintenanceManages token budgets for AI agents, enabling tracking and enforcement of usage limits with built-in EU AI Act compliance.75 PyPIMIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables agents to track real-time token spend and cost velocity, automatically throttle or freeze execution when budgets are exceeded, and enforce sandbox and safety guardrails.MIT