spendctl
Hosted sandbox for testing spend limits on AI agents that pay with x402 or MPP
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.spendctl.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"spendctl": {
"url": "https://mcp.spendctl.dev/mcp"
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools