rumblingb avatar

Agent Wallet Mcp

rumblingb/agent-wallet-mcp

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.

GitHub stars
1
tools
8
last updated
Jun 3, 2026

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

wallet_createCreate a new wallet for an agent

Create a new wallet for an agent

No parameter schema in public metadata yet.

wallet_balanceGet balance, total spent, monthly budget, and pending count

Get balance, total spent, monthly budget, and pending count

No parameter schema in public metadata yet.

wallet_depositAdd funds to a wallet

Add funds to a wallet

No parameter schema in public metadata yet.

wallet_withdrawRemove funds; rejected if monthly budget would be exceeded

Remove funds; rejected if monthly budget would be exceeded

No parameter schema in public metadata yet.

wallet_transferMove funds between two wallets atomically; honors source budget

Move funds between two wallets atomically; honors source budget

No parameter schema in public metadata yet.

wallet_transactionsRecent transaction history, newest first

Recent transaction history, newest first

No parameter schema in public metadata yet.

wallet_set_budgetSet or remove monthly spending cap (0 = no limit)

Set or remove monthly spending cap (0 = no limit)

No parameter schema in public metadata yet.

wallet_invoiceGenerate a numbered invoice record between two agents

Generate a numbered invoice record between two agents

No parameter schema in public metadata yet.

Sponsors

Readme

AgentPay

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

View the full README on GitHub

Details

Repository
github.com/rumblingb/agent-wallet-mcp
Category
AI & LLM Tools
Registry
MCP registry, active

More from rumblingb

Related AI & LLM Tools MCP servers

View all
1agentarena avatarAgent Arena Registryagentarena/agent-arenaOn-chain ERC-8004 agent registry. Search, register, and check reputation across 16 chains.0stars
2chrischall avatarGemini Mcpchrischall/gemini-mcpGenerate and edit images with Google Gemini (Nano Banana / Nano Banana Pro) image models.0stars
3sairaj-reddy avatarAibooma - AI Agent Registrysairaj-reddy/aiboomaAI agent registry — search, discover, register, and connect agents via MCP.0stars
4hustada avatarCollective Memoryhustada/collective-memoryMCP server for persistent, semantic memory across AI sessions0stars
5bluecolumnconsulting-lgtm avatarBluecolumn Memorybluecolumnconsulting-lgtm/bluecolumn-mcpPersistent memory for AI agents — audio intelligence + Music Memory ingestion and recall0stars
6suede-ai avatarAgentic Commerce Catalogsuede-ai/suede-ai-appAI music, video, image, and voice tools callable by agents with USDC payments via x402 on Base.0stars