← Keptvow

Stop your agent paying bad wallets: one line

Keptvow checks the wallet your x402 agent is about to pay, from real payment history, and cancels the payment if it says stop. Free, no sign-up, no key.

1JavaScript

npm install keptvow
import { keptvowHooks } from "keptvow";
import { x402Client } from "@x402/core/client";

const client = keptvowHooks(new x402Client()); // then register your schemes as usual

The wallet each payment goes to is checked just before it is signed. A stop cancels the payment before any money moves, and the error says why. Works with @x402/fetch, @x402/axios and the other transports on the official client. Prefer to wrap fetch, which also reports whether each paid request delivered? See the docs.

2Python

pip install keptvow
import keptvow
from x402 import x402Client

client = keptvow.hooks(x402Client())   # or x402ClientSync(); register your schemes as usual

Same check, same cancel: x402 raises PaymentAbortedError with Keptvow's reason.

3Claude, Cursor or any MCP app

Add to CursorAdd to VS Code

claude mcp add --transport http keptvow {URL}/mcp

That's for Claude Code. In Claude or ChatGPT, add {URL}/mcp as a custom connector. Anywhere else, add it as an MCP server; no key is needed. The tool to call before paying is check_payment.

4Any language: one HTTP call

curl "{URL}/v1/check?pay_to=0xSELLER_WALLET&amount_usd=5"

A 0x wallet or a Solana address. The answer is one word and the reason:

okMany independent buyers paid this seller and came back. Pay.
carefulNot enough evidence that is hard to fake. Fine for small amounts; split anything big.
stopBuyers paid and got nothing, a bot behind the wallet broke deals, or the wallet is on the US sanctions list. Don't pay.

What to expect

A new or quiet seller gets careful, not stop, and the answer says so: small payments are fine. Keptvow reads the payments of the sellers it follows (the public x402 lists) on Base, Solana and other blockchains, and says when it has no record of a wallet. If Keptvow can't be reached, the payment goes ahead by default; set failOpen: false to block it instead. Keptvow only reads: it never holds money or keys.

Running many agents? Platform plans lift the free limits: see pricing. Everything else, including delivery reports and signed answers: the docs.