{
  "markdown": "<p align=\"center\">\n  <img src=\"assets/logo.png\" width=\"80\" alt=\"AgentPay\">\n</p>\n\n# AgentWallet MCP\n\nYour 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.\n\nThe 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.\n\n## What your agent can do\n\n- Create a wallet for any agent ID and fund it with an initial balance\n- Check current balance, monthly spend total, and pending transactions at any time\n- Deposit and withdraw from any wallet, with automatic budget enforcement on withdrawal\n- Transfer between two agent wallets in a single atomic operation — both sides recorded\n- Set a hard monthly spending cap: withdrawals and transfers that would exceed it are rejected at the time of the call\n- Generate numbered invoice records (`INV-000001`, etc.) for agent-to-agent service billing\n\n## Installation\n\n**Requires:** Python 3.10+, `mcp` package.\n\n```bash\npip install mcp\n```\n\n**Claude Desktop** — add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"agent-wallet\": {\n      \"command\": \"python\",\n      \"args\": [\"/absolute/path/to/agent-wallet-mcp/server.py\"]\n    }\n  }\n}\n```\n\n**Cursor** — add to `.cursor/mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"agent-wallet\": {\n      \"command\": \"python\",\n      \"args\": [\"/absolute/path/to/agent-wallet-mcp/server.py\"]\n    }\n  }\n}\n```\n\n## Tool Reference\n\n| Tool | Description | Key params |\n|------|-------------|------------|\n| `wallet_create` | Create a new wallet for an agent | `agent_id` (required), `initial_balance` (default: 0) |\n| `wallet_balance` | Get balance, total spent, monthly budget, and pending count | `agent_id` |\n| `wallet_deposit` | Add funds to a wallet | `agent_id`, `amount`, `source` |\n| `wallet_withdraw` | Remove funds; rejected if monthly budget would be exceeded | `agent_id`, `amount`, `destination` |\n| `wallet_transfer` | Move funds between two wallets atomically; honors source budget | `from_agent_id`, `to_agent_id`, `amount`, `reason` |\n| `wallet_transactions` | Recent transaction history, newest first | `agent_id`, `limit` (default: 20) |\n| `wallet_set_budget` | Set or remove monthly spending cap (0 = no limit) | `agent_id`, `monthly_budget` |\n| `wallet_invoice` | Generate a numbered invoice record between two agents | `from_agent_id`, `to_agent_id`, `amount`, `description` |\n\n## Data Storage\n\n```\n~/.agentwallet/\n├── wallets/\n│   └── <agent_id>.json        # balance, budget, total_spent\n├── transactions/\n│   └── <agent_id>.json        # full transaction history\n├── invoices/\n│   └── INV-000001.json        # invoice records\n└── _invoice_counter.json      # auto-incrementing invoice number\n```\n\n## Budget Enforcement\n\nWhen `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.\n\n## Pricing\n\n| Plan | Price | Included |\n|------|-------|----------|\n| Pro | $19/month | Unlimited wallets, transactions, and invoices |\n\n[Subscribe via Stripe](https://buy.stripe.com/dRm6oJ4Hd2Jugek0wz1oI0m)\n\n## License\n\nProprietary — see subscription terms. Source: [github.com/Rumblingb/agent-wallet-mcp](https://github.com/Rumblingb/agent-wallet-mcp)\n",
  "bytes": 3645,
  "sha": "24fd3e81d373814b1d09bae41b38bf9ea767d1afbdf90cacca8cfea3d29df989",
  "repo_slug": "rumblingb/agent-wallet-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rumblingb_agent_wallet_mcp_27e92c2f/readme"
}