io.github.Rumblingb/agent-wallet-mcp
Agent wallet and budget management for AI agents
Install
The installation steps are in the documentation below. Documentation
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
AgentWallet MCP
Your agent can maintain its own sandboxed spend ledger, enforce monthly budgets on itself, transfer funds to other agents, and generate formal invoices — all without touching your financial accounts.
The wallet is a local numeric ledger (stored in ~/.agentwallet/). It is not connected to any bank, payment processor, or blockchain. Use it to model agent-to-agent accounting and spending limits within your own infrastructure.
What your agent can do
- Create a wallet for any agent ID and fund it with an initial balance
- Check current balance, monthly spend total, and pending transactions at any time
- Deposit and withdraw from any wallet, with automatic budget enforcement on withdrawal
- Transfer between two agent wallets in a single atomic operation — both sides recorded
- Set a hard monthly spending cap: withdrawals and transfers that would exceed it are rejected at the time of the call
- Generate numbered invoice records (
INV-000001, etc.) for agent-to-agent service billing
Installation
Requires: Python 3.10+, mcp package.
pip install mcpClaude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"agent-wallet": {
"command": "python",
"args": ["/absolute/path/to/agent-wallet-mcp/server.py"]
}
}
}Cursor — add to .cursor/mcp.json in your project root:
{
"mcpServers": {
"agent-wallet": {
"command": "python",
"args": ["/absolute/path/to/agent-wallet-mcp/server.py"]
}
}
}Tool Reference
| Tool | Description | Key params |
|---|---|---|
wallet_create | Create a new wallet for an agent | agent_id (required), initial_balance (default: 0) |
wallet_balance | Get balance, total spent, monthly budget, and pending count | agent_id |
wallet_deposit | Add funds to a wallet | agent_id, amount, source |
wallet_withdraw | Remove funds; rejected if monthly budget would be exceeded | agent_id, amount, destination |
wallet_transfer | Move funds between two wallets atomically; honors source budget | from_agent_id, to_agent_id, amount, reason |
wallet_transactions | Recent transaction history, newest first | agent_id, limit (default: 20) |
wallet_set_budget | Set or remove monthly spending cap (0 = no limit) | agent_id, monthly_budget |
wallet_invoice | Generate a numbered invoice record between two agents | from_agent_id, to_agent_id, amount, description |
Data Storage
~/.agentwallet/
├── wallets/
│ └── <agent_id>.json # balance, budget, total_spent
├── transactions/
│ └── <agent_id>.json # full transaction history
├── invoices/
│ └── INV-000001.json # invoice records
└── _invoice_counter.json # auto-incrementing invoice numberBudget Enforcement
When monthly_budget > 0, the server rejects any withdrawal or transfer where total_spent + amount > monthly_budget. The check runs synchronously before the balance is modified. Set monthly_budget to 0 to remove the limit.
Pricing
| Plan | Price | Included |
|---|---|---|
| Pro | $19/month | Unlimited wallets, transactions, and invoices |
License
Proprietary — see subscription terms. Source: github.com/Rumblingb/agent-wallet-mcp
Frequently asked questions
What is io.github.Rumblingb/agent-wallet-mcp?
Agent wallet and budget management for AI agents
How do I install io.github.Rumblingb/agent-wallet-mcp?
Follow the installation steps in its documentation, shown on this page and in its repository.
Is io.github.Rumblingb/agent-wallet-mcp open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.Rumblingb/agent-wallet-mcp?
It is published by Rumblingb. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.