agent-wallet-mcp

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

Subscribe via Stripe

License

Proprietary — see subscription terms. Source: github.com/Rumblingb/agent-wallet-mcp