spendctl
v0.1.0Spend policy for AI agents that pay (x402, MPP). Login-free sandbox, real sidecar, no real funds.
Endpoint health
online- Last checked
- 11/20/2026, 8:17:23 AM
- Latency
- 295 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:dev.spendctl%2Fspendctl
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"dev.spendctl/spendctl": {
"url": "https://mcp.spendctl.dev/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
8 shown · authentication unknown
Approve or deny a held sandbox payment
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 approval id from this sandbox; in the real product a human decides, in the sandbox the model plays that role. Returns the approval id and its new status (approved or denied). An approved payment completes when sandbox_pay is called again with the same approvalId; a denied one stays refused. Deciding the same approval twice keeps the first decision.
Schema valid · SHA-256 510122b03682…
View input schema
{ "type": "object", "properties": { "sandbox_id": { "type": "string", "pattern": "^[0-9a-f]{32}$", "description": "The sandbox_id returned by sandbox_create (32 hex characters)" }, "approvalId": { "type": "string", "description": "The approval id returned by sandbox_pay in its \"waiting for approval\" result (Approval id: ...)" }, "decision": { "default": "approve", "description": "approve releases the held payment; deny refuses it for good", "type": "string", "enum": [ "approve", "deny" ] }, "note": { "description": "Optional reason recorded with the decision, up to 200 characters", "type": "string", "maxLength": 200 } }, "required": [ "sandbox_id", "approvalId" ], "$schema": "https://json-schema.org/draft/2020-12/schema" }Wait for a held sandbox payment's decision
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, at most 20) and returns pending, approved, denied, expired or withdrawn, with the ledger entry and the decision deadline. This is what an agent does in the real product while a human decides; in the sandbox the model is also the approver (approve), so call approve from another turn or first. After approved, repeat sandbox_pay with approvalId to complete the payment. Read-only; never pays and never decides.
Connections
streamable-http
https://mcp.spendctl.dev/mcp