Spend Guard

io.github.vulinh1704/spend-guard

Budgets, payee allowlists, price-spike checks and human approval for agents paying x402 paywalls

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "spend-guard": {
      "command": "npx",
      "args": [
        "-y",
        "@vulinh1704/spend-guard@0.2.0"
      ],
      "env": {
        "SPEND_GUARD_RAILS": "mock",
        "SPEND_GUARD_DASHBOARD_PORT": "4400",
        "SPEND_GUARD_APPROVAL_TIMEOUT": "55",
        "SPEND_GUARD_MOCK_NETWORK": "near-testnet",
        "ARC_PRIVATE_KEY": "<your ARC_PRIVATE_KEY>",
        "NEAR_PRIVATE_KEY": "<your NEAR_PRIVATE_KEY>"
      }
    }
  }
}
Environment variables
  • SPEND_GUARD_RAILSHow to pay: mock (pays nothing), near, arc, gateway, or a comma list. arc and gateway need ARC_PRIVATE_KEY, near needs NEAR_ACCOUNT_ID and NEAR_PRIVATE_KEY.
  • SPEND_GUARD_DASHBOARD_PORTPort of the approval dashboard on 127.0.0.1. 0 picks a free one; off means no dashboard, and payments that need approval are declined.
  • SPEND_GUARD_APPROVAL_TIMEOUTSeconds a payment waits for your answer before it is declined. Raise it together with your client's tool timeout.
  • SPEND_GUARD_MOCK_NETWORKNetwork the mock rail pretends to pay on.
  • ARC_PRIVATE_KEYsecretAgent key for the arc and gateway rails. Testnet keys only.
  • NEAR_PRIVATE_KEYsecretAgent key for the near rail. Testnet keys only.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
0.2.0
Registry
active
Published
10/31/2026
Browse all Developer Tools →

Add the badge to your site

Show visitors that Spend Guard is listed here — it’s also the link we check for a free listing.

Spend Guard — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-vulinh1704-spend-guard?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Spend Guard — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Spend Guard — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-vulinh1704-spend-guard?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.