Summary
Gives your agent a local numeric ledger to track spending, enforce monthly budgets, and transfer funds to other agents without touching real money. It stores wallet state and transaction history as JSON files in `~/.agentwallet/` and exposes eight tools: create wallets, check balances, deposit, withdraw, transfer between agents, view transaction history, set monthly spending caps, and generate numbered invoices. Withdrawals and transfers are rejected synchronously if they'd exceed the agent's budget. Useful if you're running multi-agent systems where you want to simulate costs, enforce resource limits, or model agent-to-agent billing without integrating an actual payment provider. The wallet is purely local accounting, not connected to banks or blockchain.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
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 mcp
Claude 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 number
Budget 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
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
