presign-guard wallet

Agent wallet with limits: pays x402/MPP on Base, Tempo, XRP Ledger and Algorand; phone approval.

OtherJavaScriptv0.13.1

x402 examples

Spending limits for AI agents, approved from your phone

Give your agents a wallet without giving them a blank cheque:

  • presign-guard-wallet (npm): a viem wallet that checks every signature with presign-guard first (drainers, sanctions, unlimited approvals), keeps to your price per purchase and daily budget, and asks you on Telegram for anything above them. npm i presign-guard-wallet
  • presign-guard-agentkit (npm): the same for Coinbase AgentKit agents. Wrap the wallet provider in one line, and every transfer, swap, approval, permit and x402 payment is checked and kept to your limits. npm i presign-guard-agentkit
  • presign-guard-wallet-mcp (npm, MCP server): a wallet with spending limits for Claude, Cursor and any MCP client. The agent can pay x402 APIs and send USDC within your budget, and asks you on Telegram above it. npx -y presign-guard-wallet-mcp
  • wallet-server: one budget and one set of rules for all your agents, a live dashboard, approvals on the dashboard or Telegram, pause one agent or all, an activity log. It never holds keys or funds: agents still sign and pay themselves.

See the dashboard live (demo, example data) →

import { guardWallet } from "presign-guard-wallet";

const wallet = guardWallet(walletClient, {
  pay, // a fetch that pays x402, or creditKey for prepaid presign-guard checks
  server: { url: process.env.WALLET_SERVER_URL, key: process.env.WALLET_SERVER_KEY },
});
// Under your price: signs. Above it: you get a request on the dashboard and on Telegram.
// Red verdict: never signed. Server unreachable: stops instead of signing.

Try it from your phone: Actions → telegram-demo → Run workflow (a pretend agent, a stub wallet, no money moves).

Paid-API examples

Small, open examples of AI agents combining paid APIs with x402: each call is paid per request in USDC, with no accounts or API keys.

ExampleWhat it doesServicesCost per run
wallet-mcpMCP server presign-guard-wallet-mcp: wallet tools for any MCP client (pay x402 APIs, send USDC), every signature checked by presign-guard and kept to spending limits, Telegram or wallet-server approval above thempresign-guard$0.01 per checked signature (or prepaid credits)
agentkit-guardnpm package presign-guard-agentkit: wraps a Coinbase AgentKit wallet provider so every spending action is checked by presign-guard and kept to spending limits, with Telegram or wallet-server approval above thempresign-guard$0.01 per checked signature (or prepaid credits)
guard-walletnpm package presign-guard-wallet: a viem wallet that asks presign-guard before every signature, keeps to spending limits and asks you on Telegram above thempresign-guard$0.01 per checked signature (or prepaid credits)
crowding-checkPerp funding + CFTC leveraged-fund positioning + the Ichimoku cloud on 4h and 1d, combined into a short read ("crowded long + below the cloud = caution")Edge Agents, Ichimoku Signal$0.32
token-checkBefore buying, holding or accepting a token: a verdict (go / ask / stop) with reasons and market data, Solana and EVM tokens; pays on Solana or Basepresign-guard$0.01
safe-fetchnpm package x402-safe-fetch: the safe-pay logic as a drop-in fetch for your own agent (preflight, go / caution / no_go, budget cap, trusted hosts, 10-minute verdict cache)x402 Doctor + the endpoint$0.001 + the endpoint
safe-payBefore paying an x402 endpoint it has never used, the agent pays $0.001 for a preflight and pays only on go, within a budgetx402 Doctor + the endpoint$0.001 + the endpoint

Each example has a --dry-run that shows the prices without paying. Use a dedicated wallet with a little USDC, keep its key in your environment, and never commit it.

Check your own x402 endpoint for free with x402 Doctor.

These are examples of combining services, not trade advice.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y presign-guard-wallet-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-fizzl13-presign-guard-wallet": {
      "command": "npx",
      "args": [
        "-y",
        "presign-guard-wallet-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

presign-guard-wallet-mcpnpm

Compatible MCP Clients

presign-guard wallet works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More