# spendctl

> spendctl is a freemium MCP server for finance and payments. Hosted sandbox for testing spend limits on AI agents that pay with x402 or MPP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://spendctl.dev/docs/sandbox/
- **MCP Registry name:** dev.spendctl/spendctl
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.spendctl.dev/mcp
```

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

```json
{
  "mcpServers": {
    "spendctl": {
      "url": "https://mcp.spendctl.dev/mcp"
    }
  }
}
```

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

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

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

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

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

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/spendctl
