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
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
License
Proprietary — see subscription terms. Source: github.com/Rumblingb/agent-wallet-mcp