dev.spendctl/spendctl

up checked 2026-11-10T23:37:29.831Z

Unclaimed · Unverified

Publisher-provided title

spendctl

Publisher-provided description

Spend policy for AI agents that pay (x402, MPP). Login-free sandbox, real sidecar, no real funds.

Summary by lookupd

Lets an agent make policy-governed x402 payments in a sandbox, with budgets, host allowlists, approvals, and receipts; no real funds.

Install

Claude Code, remote (streamable-http)

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

Codex, remote (streamable-http)

codex mcp add spendctl --url https://mcp.spendctl.dev/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Publisher-provided text

sandbox_create Creates an isolated spendctl sandbox and returns its sandbox_id. Call it first: every other tool needs the sandbox_id, and one sandbox serves a whole conversati
sandbox_pay Fetches one of the sandbox's paid endpoints (HTTP 402, x402) through the spendctl sidecar, which applies the sandbox agent's budget, allowlist and approval poli
await_approval Waits for the decision on a payment that sandbox_pay reported as held, without paying again: long-polls the sandbox sidecar for up to timeoutSeconds (default 10
withdraw_approval Takes back a payment that sandbox_pay reported as held, as a real agent does when the task that needed the payment was cancelled or superseded: nothing is paid,
check_budget Shows the sandbox agent's spending limits, what has been spent in each window and what is left. Use it before a paid call when the remaining budget matters, or
list_receipts Lists the sandbox agent's most recent payment attempts, newest first: paid (amount and mock transaction hash), refused (reason codes) and waiting for approval.
get_policy Returns the sandbox's spendctl.yaml as text: the preset name and the agent's budgets, allowed hosts and approval rules. Use it to explain why a payment was refu
approve Approves or denies a payment that sandbox_pay reported as waiting for approval, as the human approver would with `spendctl approve`. Use it only with an approva

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/dev.spendctl/spendctl.svg)](https://lookupd.com/servers/dev.spendctl/spendctl)