Skip to content
MCP server

spendctl

Hosted sandbox for testing spend limits on AI agents that pay with x402 or MPP

Install
Pricing
Freemium
Platforms
API, CLI
Runs
Remotely
Version
0.1.0
Listing updated
2 days ago

About spendctl

spendctl is a freemium MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

Connecting to the hosted endpoint gives you a throwaway sidecar of its own, with a mock wallet, a mock x402 facilitator and two mock paid APIs (a weather lookup at $0.01 and a search at $0.02). No funds move and the sandbox cannot reach any host on the internet, so a model can try paying, being refused and asking for approval without risk.

Three presets shape the policy: default has comfortable caps, strict allows $0.015 per request and $0.03 per day for weather only, and approvals holds any payment at or above $0.015 until a human decides. Receipts record each attempt as paid, refused or waiting, with mock transaction hashes.

Limits are stated plainly: 200 governed payments, 1,000 recorded attempts and 20 pending approvals per sandbox, and a sandbox is deleted after 2 hours without calls or 24 hours after creation. The sandbox id is the only key to it, so nothing private belongs in one.

Install

Run in a terminal

claude mcp add --transport http spendctl https://mcp.spendctl.dev/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.spendctl.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "spendctl": {
      "url": "https://mcp.spendctl.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "spendctl": {
      "type": "http",
      "url": "https://mcp.spendctl.dev/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "spendctl": {
      "serverUrl": "https://mcp.spendctl.dev/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "spendctl": {
      "type": "http",
      "url": "https://mcp.spendctl.dev/mcp"
    }
  }
}

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

sandbox_create
Creates a sandbox and returns its id, policy and paid endpoints.
sandbox_pay
Fetches a paid endpoint through the sidecar, which applies the policy and pays or explains why not.
check_budget
Shows limits, spend per window and what is left.
list_receipts
Lists recent attempts: paid, refused or waiting.
get_policy
Returns the sandbox's spendctl.yaml.
approve
Approves or denies a held sandbox payment.
await_approval
Waits for an approval decision without paying again.
withdraw_approval
Takes back a held payment that is no longer needed.

What it does

Preset spend policies
Create a default, strict or approvals sandbox, each with its own caps and rules.
Mock paid endpoints
Weather and search APIs inside the sandbox charge small mock amounts over x402.
Human approval flow
Held payments can be approved, denied, awaited or withdrawn from the same chat.
Receipts and budget view
List recent attempts with reasons and see what is left of the budget.
No sign-in or install
Connect a Streamable HTTP address from Claude, Cursor, VS Code or any MCP client.

Good for

  • Try how an agent behaves when a payment is refused by policy
  • Rehearse a human approval step before wiring up real payments
  • Show a team how spend caps and receipts look without real funds
  • Test an MCP client against a Streamable HTTP server that needs no login

Pricing

Freemium

Sandbox is free; the sidecar's Free plan allows 1,000 governed payments a month, with Pro and Team tiers above it (prices not shown here)

Prices change. Check spendctl.dev before you buy.

spendctl FAQ

Does the sandbox spend real money?

No. It uses a throwaway wallet and mock facilitator, and no funds move.

Do I need an account?

No. The endpoint needs no login and no install.

How long does a sandbox last?

It is deleted after 2 hours without calls and at most 24 hours after creation.

Are there rate limits?

Yes: 5 sandboxes and 120 requests per minute per client address, with higher shared limits for claude.ai connector traffic.

Is spendctl free?

spendctl has a free plan, with paid plans for more usage or features.

How do I add spendctl to Claude Code?

Run this command in your terminal: claude mcp add --transport http spendctl https://mcp.spendctl.dev/mcp

What are the best alternatives to spendctl?

The closest alternatives to spendctl are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to spendctl

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools