Back to Browse

X402 Examples MCP Server

FinanceLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Agent wallet with spending limits: pays x402 and MPP APIs (Base, Tempo), phone approval over limit.

About

Agent wallet with spending limits: pays x402 and MPP APIs (Base, Tempo), phone approval over limit.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (2 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (6/6 approved).

13 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Private key of the agent's own wallet (a separate wallet holding only what the agent may spend)Required

Environment variable: AGENT_KEY

Most USDC per payment or transfer without asking you, e.g. 5Optional

Environment variable: LIMIT_USDC_PER_TX

Daily USDC budget, e.g. 20Optional

Environment variable: LIMIT_USDC_PER_DAY

Telegram bot that asks you to approve anything over a limitRequired

Environment variable: TELEGRAM_BOT_TOKEN

Your Telegram chat id (approvals go only there)Optional

Environment variable: TELEGRAM_CHAT_ID

Instead of LIMIT_* and TELEGRAM_*: a wallet server keeping one budget for all your agentsOptional

Environment variable: WALLET_SERVER_URL

The agent key (awk_…) from the wallet server's dashboardRequired

Environment variable: WALLET_SERVER_KEY

base (default), ethereum, optimism, arbitrum, polygon or bscOptional

Environment variable: CHAIN

Most a single x402 API call may cost, in dollars (default 1)Optional

Environment variable: MAX_PAYMENT_USD

Optional presign-guard credit key (pgc_…) to pay the $0.01 checks from prepaid creditsRequired

Environment variable: PRESIGN_CREDIT_KEY

Optional RPC URL for the chainOptional

Environment variable: RPC_URL

off to never pay MPP charges on Tempo (default on: paid in USDC.e on Tempo from the same address)Optional

Environment variable: TEMPO

4217 (Tempo, default) or 42431 (Moderato testnet)Optional

Environment variable: TEMPO_CHAIN

Optional Tempo RPC URLOptional

Environment variable: TEMPO_RPC_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-fizzl13-presign-guard-wallet": {
      "env": {
        "CHAIN": "your-chain-here",
        "TEMPO": "your-tempo-here",
        "RPC_URL": "your-rpc-url-here",
        "AGENT_KEY": "your-agent-key-here",
        "TEMPO_CHAIN": "your-tempo-chain-here",
        "TEMPO_RPC_URL": "your-tempo-rpc-url-here",
        "MAX_PAYMENT_USD": "your-max-payment-usd-here",
        "TELEGRAM_CHAT_ID": "your-telegram-chat-id-here",
        "LIMIT_USDC_PER_TX": "your-limit-usdc-per-tx-here",
        "WALLET_SERVER_KEY": "your-wallet-server-key-here",
        "WALLET_SERVER_URL": "your-wallet-server-url-here",
        "LIMIT_USDC_PER_DAY": "your-limit-usdc-per-day-here",
        "PRESIGN_CREDIT_KEY": "your-presign-credit-key-here",
        "TELEGRAM_BOT_TOKEN": "your-telegram-bot-token-here"
      },
      "args": [
        "-y",
        "presign-guard-wallet-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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, on your phone (installable app) 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.

Reviews

No reviews yet

Be the first to review this server!