Skip to content
MCP server

walletcap for Coinbase payments MCP

Per-payment and rolling 24-hour USDC limits in front of Coinbase's payments MCP

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.3.0
Listing updated
3 days ago

About walletcap for Coinbase payments MCP

walletcap for Coinbase payments MCP is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add walletcap -- npx -y walletcap

Add to claude_desktop_config.json

{
  "mcpServers": {
    "walletcap": {
      "command": "npx",
      "args": [
        "-y",
        "walletcap"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "walletcap": {
      "command": "npx",
      "args": [
        "-y",
        "walletcap"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

Free npm package; licence file in the repository

Prices change. Check coriolislabs.github.io before you buy.

walletcap for Coinbase payments MCP 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 to walletcap for Coinbase payments MCP

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government