# walletcap for Coinbase payments MCP

> walletcap for Coinbase payments MCP is an open-source MCP server for finance and payments. Per-payment and rolling 24-hour USDC limits in front of Coinbase's payments MCP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://coriolislabs.github.io/WalletCap/coinbase-agentic-wallet-budget/
- **Repository:** https://github.com/coriolislabs/walletcap/tree/HEAD/js
- **MCP Registry name:** io.github.coriolislabs/walletcap
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

walletcap sits between an AI client and Coinbase's payments MCP server, or the `awal` Agentic Wallet CLI, and checks each outgoing payment against a budget before the wallet signs. You run `npx walletcap-mcp --wallet 0x...` as the server entry in the client config, and it launches Coinbase's installed bundle behind itself. The owner sets limits once with `npx walletcap set`, for example a cap per payment and per day.

`send` and `make_http_request_with_x402` are counted. Tools that move no money, such as balance, address, sign-in and payment discovery, pass through. Any other tool, including trading, is refused and removed from the tool list because it cannot be counted, unless you allow it by name. JSON-RPC batches and non-MCP methods are refused. An x402 payment is priced from the endpoint's own 402 response, and the wallet is capped at exactly that amount.

Only USDC is counted; a send in another asset is refused. If a wallet reports a failure, the payment stays held and is listed until you check the chain and void it. The budget file serves a single host and cannot be shared over NFS, SMB or Docker bind mounts. The wider README compares walletcap against Coinbase's own spend controls in an offline crash test.

## Features

- **Per-payment cap:** Refuses any single send or x402 payment over the limit.
- **Rolling 24-hour budget:** Counts spend across restarts and across processes on one host.
- **x402 pricing:** Prices a payment from the endpoint's 402 reply and caps the wallet at that amount.
- **Tool allow-listing:** Money-moving tools it cannot count are hidden unless you allow them.
- **Held payments:** Unknown outcomes stay held until you void them after checking the chain.
- **CLI wrapper:** `npx walletcap awal` runs Coinbase's CLI behind the same budget.

## Good for

- Give a Claude Desktop agent a Coinbase wallet with a fixed daily spend
- Cap each x402 micropayment an agent makes
- Audit which payments are still held after a crash
- Stop an agent from using trading tools on a payments wallet

## Install

### Claude Code (Terminal)

```sh
claude mcp add walletcap -- npx -y walletcap
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "walletcap": {
      "command": "npx",
      "args": [
        "-y",
        "walletcap"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "walletcap": {
      "command": "npx",
      "args": [
        "-y",
        "walletcap"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "walletcap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "walletcap"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "walletcap": {
      "command": "npx",
      "args": [
        "-y",
        "walletcap"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "walletcap": {
      "command": "npx",
      "args": [
        "-y",
        "walletcap"
      ]
    }
  }
}
```

## FAQ

### Which assets are counted?

Only USDC. A send in any other asset is refused.

### Does the limit survive a restart?

Yes, the budget is stored in a file and holds across restarts and replicas on one host.

### Can two machines share one budget?

No. The budget file serves one host and cannot be shared over a network volume.

### How do I add it to Claude Desktop?

Replace the payments server entry with command npx and args walletcap-mcp --wallet 0xYourAgentWallet.

### Is walletcap for Coinbase payments MCP free?

Yes. walletcap for Coinbase payments MCP is open source, so you can use and self-host it for free.

### How do I add walletcap for Coinbase payments MCP to Claude Code?

Run this command in your terminal: claude mcp add walletcap -- npx -y walletcap

### What are the best alternatives to walletcap for Coinbase payments MCP?

The closest alternatives to walletcap for Coinbase payments MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/walletcap-for-coinbase-payments-mcp
