Superstables

Lists the services a budget can pay: each one's name, URL, price, chain and whether its output is sample data. With once, lists what Single purchase on superstables.com can buy instead. chain narrows the list to one chain, such as base-sepolia. A price is what the seller asked for last and may have changed. Reads a list and moves no funds.

Search the services this chat can buy through Superstables: each one's id, what it returns, its price in a test token, the chain it is paid on and its inputs. q matches words in the id, name and description; chain matches a chain's id or name. Reads a public catalogue and moves no funds.

Reads one budget approval from the approval link the Superstables CLI printed: its kind, state, whether it is final, its steps and their transaction hashes. Pass the whole link. It doesn't return the link's token and moves no funds.

One agent's budget as list_my_budgets shows it, read from the chain now, with the owner's last action for it (setup, grant, revoke or fund) and whether that is final. revoke says whether the latest revoke on record is final, in a block but not final yet, or unknown. Treat a revoke as done, and a new grant as usable, only once it is final. Moves no funds.

The Superstables account connected to this chat: id, nullable name, active wallets (oldest first), client_name, registration and scopes. address and namespace identify the first wallet, or are both null if none. Namespace is eip155 for Ethereum or solana for Solana. Moves no funds.

Reads a purchase this chat asked for: whether the owner approved it, whether it was paid, the service's answer and the receipt. Show the owner the approval link and match code before calling this tool. Then keep calling it with wait_seconds 25 in the same turn while the result says to keep waiting. It also works when called later. A payment whose outcome is not known yet is reported as unknown, never as unpaid.

The agents linked to this Superstables account and their budgets: each agent's id, label, chain, budget, what is left to spend, what it has used (null when not counted), its gas balance and the state of its budget. Reads the chain now and moves no funds.

Gives the price, recipient and chain find_budget_services lists for one of its services, and when that price was last checked. With agent, also says whether what is left of that agent's budget covers it. This is the listed price, not a live one: the Superstables CLI's budget buy reads the seller's live price and recipient, and checks them, before it pays. Any other URL is refused. Doesn't contact the seller, sign transactions or move funds.

Removes an agent from this account, off chain, once Superstables confirms it has no spending permission. A live Tempo key must be revoked even if its current budget is spent. Moves no funds.

Gives the owner the link to revoke an agent's budget, for an agent from list_my_budgets. The owner signs the revoke with their wallet on superstables.com. This tool signs and sends nothing and does not revoke the budget.

Requests approval to buy one service from find_services. Returns an approval link and match code. Any account member may review and sign the payment in a wallet on superstables.com; nothing is paid until then. Use a new operation_id for each purchase. Within this connection, retrying that ID returns the request while it is kept, without creating another. Revoking and reconnecting starts a new connection.

Only for a coding agent on the owner's machine, such as Claude Code or Codex, sending a block that its own Superstables CLI signed and whose agent key and records stay on that machine. A chat app is refused: never ask the owner to paste a signed block into a chat. Without such a block, don't call this tool or build the block yourself. Sends a budget request that the CLI signed with --sign-only to superstables.com for the owner's approval. Pass the CLI's JSON block unchanged: method, path, headers and body. Superstables checks the agent's signature over that exact request, so it can't be changed here, and refuses a request sent twice or after its time window. A request to add an agent must use owner proof version 2. Returns the request id, the owner's approval link, the match code, when the link expires and the wallets of the account the request is on. Nothing changes until the owner approves with their wallet on superstables.com.

Follows one budget approval until it is final or wait_seconds pass (at most 25). Pass the approval link the Superstables CLI printed, or the request_id submit_budget_request returned for this account. Returns what get_budget_request returns. A request awaiting the owner doesn't establish whether the owner has approved it, a transaction in a block is not final until the chain says so, and an unknown outcome is not a failure. Moves no funds.