Set up in five minutes.
Install with npm, create the wallet in your terminal, set your rules, and connect your agent host.
Five minutes, and a small amount of USDG.
The key is created on your computer and encrypted with your passphrase. Fund the wallet with only what you are willing to let an agent spend.
Until you turn it on, every payment waits for you, including the ones inside your rules.
# install (Node.js 22.12 or newer) npm install -g https://github.com/reinpay/reinpay/archive/refs/heads/main.tar.gz # in your own terminal reinpay init reinpay payee add "Weather API" 0xRecipient --tokens=USDG reinpay rule daily USDG 25 reinpay rule approve-above USDG 5 reinpay address # fund this with a small amount # connect your agent host, for example Claude Code claude mcp add --scope user reinpay -- reinpay mcp # later reinpay pending reinpay approve RP-00042
| Default rule | USDG | ETH |
|---|---|---|
| Daily budget | 25 | 0.005 |
| Max per payment | 10 | 0.002 |
| Asks you above | 5 | 0.001 |
| Repeat guard | 10 minutes | |
Eleven MCP tools. None of them can approve.
wallet_statusAddress, ETH and USDG balances, today's budget left per token, the rulesget_rulesThe rules and the payees the agent may payrequest_paymentAsk for one payment; returns the decision and the receiptget_receiptOne receipt by idlist_receiptsRecent receipts, optionally by statusverify_receiptRead a sent payment back from the chain and check it against its receiptspending_reportSent, waiting and blocked per day and token, top payeesreview_rulesSuggestions for the owner's rules, each with the command to runread_payment_linkRead an ethereum: payment link: who, how much, and whether the payee is on the listcheck_paymentDry run: what would happen to a payment now, without recording anythingfreeze_walletStop every payment until the owner unfreezes it. The agent can freeze, never unfreezeEverything you run in your terminal.
reinpay init [--import]Create or import the encrypted wallet. Terminal only.reinpay addressPrint the wallet addressreinpay statusBalances, budget left today, the rules, the config seal and how long it stays unlockedreinpay rule daily|weekly|monthly|max|approve-above <token> <amount>Set a rule for USDG or ETHreinpay rule repeat-guard <minutes>Hold repeats for that long (0 turns it off)reinpay payee add <name> <0xaddress> [--tokens=USDG,ETH]Add a payeereinpay payee list | remove | off | onManage payeesreinpay payee limit <name> daily|max <token> <amount|off>A payee's own daily budget or max per paymentreinpay pendingPayments waiting for youreinpay approve | reject <RP-id>Decide a waiting paymentreinpay receipts [--status=sent] [--json | --csv]Everything, newest first, or a spreadsheetreinpay report [--days=7] [--json | --csv]Sent, waiting and blocked per day, top payeesreinpay token add <0xaddress> | list | removeSpend another ERC-20, verified on Sourcify firstreinpay profiles · --profile=<name>One wallet per agentreinpay autosend on|offSend payments inside every rule without asking (needs unlock)reinpay unlock [--for=12h|30m|1d|0] | lockUnlock for a while (12 hours by default, 0 means until you lock), or lock nowreinpay sealSign your rules and payees with the wallet key. Run it once after updating to 0.5.0reinpay verify <RP-id> | --allRead sent payments back from Robinhood Chain and check them against their receiptsreinpay doctorTen checks of your setup, each with what to do nextreinpay freeze [reason] · unfreezeStop every payment now; unfreeze is terminal onlyreinpay rule breaker <count> <minutes> | offFreeze by itself when the agent is blocked that often (default 5 in 10 minutes)reinpay payee until <name> 30d|12h|offA payee that expires on its own (also --until=30d on payee add)reinpay rule first-payment ask|offMake the first payment to every payee wait for youreinpay statement [--days=30]A spending statement signed with your wallet keyreinpay statement check <file>Check anyone's statement: the signature, then every payment on the chainreinpay digest [--days=1] [--dry]A short summary to your Telegram or webhook, for a daily schedulereinpay check <payee> <amount> [token]Dry run: what would happen now. Nothing recorded or signedreinpay grant <token> <amount> --for=2hExtra budget for a while, on top of the daily budget (grant list | clear)reinpay backup · restore <file>Move the wallet to another computer; the key stays encryptedreinpay payee export · import <file>Share a signed payee list; import runs the usual checks and skips lookalikesreinpay notify secretA new signing secret for webhook notifications (x-reinpay-signature)reinpay mcp --read-onlyThe MCP server without request_payment, for agents that should only readreinpay payee category <payee> <name|off>Put a payee in a categoryreinpay rule category <name> daily <token> <amount|off>A daily budget shared by every payee in a categoryreinpay rule hours 9-18|off [--weekdays]Outside these local hours, every payment waits for youreinpay rule per-hour <count|0>At most this many payments sent or waiting in any hourreinpay schedule add <payee> <amount> <token> daily|weekly|monthlyA payment that comes back; still checked by every rulereinpay schedule runAsk for every payment that is due. Put it on cronreinpay pay <ethereum:… link>Pay from a payment link, only to a payee on your listreinpay notify at <percent|off>A message when that share of today's budget is usedreinpay approve <RP-id> [RP-id …] | --allApprove several with one yes; each is checked and simulated againreinpay rule memo <chars|off>Block requests that do not say what they are forreinpay rule expire-after 24h|offUnanswered requests expire and free the budgetreinpay profiles --statusEvery agent's wallet on one screenreinpay freeze --all · unfreeze --allStop or restart every agent at oncereinpay rule usd max|daily <amount|off>Limits in dollars across USDG and ETHreinpay priceThe ETH price from two on-chain pools that the dollar limits usereinpay sandboxTry Reinpay with no money: real rules, real mainnet simulation, pretend balancereinpay payee challenge · proveA payee proves it controls its address with a signed messagereinpay rule require-proven on|offPayments to unproven payees wait for youreinpay share <RP-id> · share checkA signed proof of one payment, anyone can check it on the chainreinpay reviewSuggestions for your rules from your own receiptsreinpay notify telegram <bot-token> <chat-id> | webhook <url> | off | testA message when a payment waits for youQuestions owners ask first.
Do I need to trust this website?
No. The website never sees a key. The wallet runs on your computer; the app page only reads public balances and, if you choose, asks your browser wallet to send a transfer you review first.
Which agent hosts work?
Any MCP host that runs a local command: Claude Code, Cursor, Codex, Windsurf, VS Code and others. Run reinpay mcp as a stdio server.
What can it pay in?
USDG and ETH on Robinhood Chain mainnet (chain id 4663) are built in. You can add other ERC-20s with reinpay token add; each one must be verified on Sourcify, and nothing is spent until you set its budget.
Can I run more than one agent?
Yes. Give each agent its own wallet with --profile=<name>: separate key, rules, payees and receipts, so one agent cannot spend another's budget.
What happens if my agent loops?
The repeat guard holds the same payee, token and amount within 10 minutes for you, and the daily budget caps the rest.
How much should I put in?
Only what you are willing to let an agent spend. Until you turn on autosend, every payment waits for you anyway.
What if something edits my config file?
Since 0.5.0 your rules and payees are sealed with your wallet key. If config.json is changed outside Reinpay, for example a payee added by another program, nothing is signed until you check reinpay rules and run reinpay seal.
How do I know a payment really went through?
Run reinpay verify RP-…. It reads the transaction back from Robinhood Chain and checks that it succeeded, came from your wallet, and paid that payee that exact amount of that token. Your agent can do the same with the verify_receipt tool.
Something is not working. Where do I start?
Run reinpay doctor. It checks Node.js, the RPC, the chain, the wallet, the seal, the unlock, ETH for fees, payees and budgets, and says what to do for anything that is off.
How do I stop everything right now?
Run reinpay freeze. Every request is blocked, autosend stops and approvals are refused until you run reinpay unfreeze in your terminal. The wallet also freezes itself if the agent is blocked 5 times in 10 minutes.
Can I prove what my agent spent?
Yes. reinpay statement writes every sent payment in a period to a file signed with your wallet key. Whoever you send it to runs reinpay statement check: it confirms your wallet signed it, that nothing was changed, and that every payment is on Robinhood Chain as written.
How do I move Reinpay to a new computer?
Run reinpay backup on the old one. It writes your key (still encrypted with your passphrase), rules, payees and receipts to one file. Install Reinpay on the new computer and run reinpay restore file.json. Keep that file as safe as the key itself.
Can my team share one payee list?
Yes. reinpay payee export writes your payees to a file signed with your wallet key. A teammate runs reinpay payee import: it shows who signed it and adds only payees that pass the usual checks, skipping lookalike addresses and token contracts.
Can I give different kinds of spending their own budget?
Yes. Put payees in categories with reinpay payee category, then set reinpay rule category compute daily USDG 10. Every payment must fit both your overall daily budget and its category's. You can also set payment hours and a cap on payments per hour.
Can Reinpay pay a subscription every month?
Yes. reinpay schedule add "Weather API" 5 USDG monthly, then run reinpay schedule run from cron. Each payment still goes through every rule and the mainnet simulation, and waits for you unless autosend is on.
Can I set a budget in dollars?
Yes. reinpay rule usd daily 50 caps a day at 50 dollars across USDG and ETH together, and reinpay rule usd max 20 caps any single payment. ETH is priced from two WETH/USDG pools on Robinhood Chain; if they disagree by more than 2%, the payment is blocked rather than guessed.
I run several agents. Can I see them all?
Give each its own wallet with --profile=<name>, then reinpay profiles --status shows them all on one screen, and reinpay freeze --all stops every one at once.
Can I try it before I put money in?
Yes. reinpay sandbox runs five requests through the real rules and real mainnet simulations with a throwaway wallet and a pretend balance. Nothing is signed or sent.
Is it free?
Yes. Open source under MIT. You pay only the network fee in ETH for each payment.