[ MCP / @quackai/q402-mcp ]
v0.11.15 live

Your agent gets a checking account.

Gasless stablecoin payments across 12 EVM chains, from any MCP client. One install, then ask your AI to set it up. 43 tools, one package.

InstallOpen dashboard
Try asking your agent
Pay 5 USDC to 0xA1b2…9F3c on Base.What is in my agent wallet, and on which chains?Bridge 10 USDT to Mantle, then earn yield on it.
npm npm GitHub GitHub Docs
Works with
ClaudeCodexCursorClineCopilotHermes+ any
[ Install ]

Pick your client. One package underneath.

Same @quackai/q402-mcp server for every client. CLI for Claude and Codex, a JSON snippet for Cursor, Cline and Copilot, YAML for Hermes.

$claude mcp add q402 -- npx -y @quackai/q402-mcp
Writes the q402 entry into ~/.claude.json for you, no editing by hand.

Claude Code CLI or Claude Desktop. Reload or restart the app after running.

→

Restart, then ask “Set up Q402”. It runs q402_doctor, creates ~/.q402/mcp.env, and walks you through pasting keys in your editor, never in chat.

[ Wallet mode ]

Do I need a private key?

Two modes use a local private key; one lets Q402 sign server-side. Most users want Mode C, no PK, just an API key.

Mode CRecommended
Server signs for you

No PK in env. No MetaMask popup. Best for AI agents. Free-trial keys work here too (BNB Chain + Avalanche).

~/.q402/mcp.env
Q402_MULTICHAIN_API_KEY=q402_live_...   # paid plan
Q402_TRIAL_API_KEY=q402_live_...        # or the free trial
Q402_ENABLE_REAL_PAYMENTS=1
Mode B
Local Agent Wallet PK

Mode C's wallet, your private key. Export once from the dashboard. Local signing, MetaMask untouched.

~/.q402/mcp.env
Q402_AGENTIC_PRIVATE_KEY=0x...
Q402_MULTICHAIN_API_KEY=q402_live_...
Q402_ENABLE_REAL_PAYMENTS=1
Mode A
Your MetaMask EOA signs

Signs directly via EIP-7702 (shows "Smart account", reversible). Use a fresh wallet.

~/.q402/mcp.env
Q402_PRIVATE_KEY=0x...
Q402_MULTICHAIN_API_KEY=q402_live_...
Q402_ENABLE_REAL_PAYMENTS=1
Change later by editing ~/.q402/mcp.env. q402_doctor asks on first install.
[ Live demo ]

The exact tool your agent calls.

Change the amount or token. The table re-ranks all 12 chains by gas, the same q402_quote the MCP server returns to the agent.

Amount
$
#ChainGas tokenApprox gasSender
  • 01Stablechain 988USDT0$0.0005$0.00
  • 02Basechain 8453ETH$0.0008$0.00
  • 03Robinhood Chainchain 4663ETH$0.0008$0.00
  • 04BNB Chainchain 56BNB$0.0010$0.00
  • 05Scrollchain 534352ETH$0.0010$0.00
  • 06Arbitrum Onechain 42161ETH$0.0015$0.00
  • 07X Layerchain 196OKB$0.0020$0.00
  • 08Mantlechain 5000MNT$0.0020$0.00
  • 09Monadchain 143MON$0.0020$0.00
  • 10Avalanche C-Chainchain 43114AVAX$0.0030$0.00
  • 11Injective EVMchain 1776INJ$0.0040$0.00
  • 12Ethereum Mainnetchain 1ETH$1.20$0.00
Sending $50 USDC, USDT, RLUSD, or USDG. Agent picks Stable by default. Sender always pays $0; gas comes from the developer's gas tank.
[ 43 tools ]

Only what an agent should reach for.

No hidden admin endpoints. Nothing moves funds outside the confirm-and-sign flow. Grouped by what they do, with the auth each one needs.

Setup and read5
  • q402_doctorno auth
    Install + ongoing health check. Call on "set up Q402".
  • q402_quoteno auth
    Compare gas across all 12 chains. Read-only.
  • q402_balanceapi key
    Verify key + remaining quota.
  • q402_agentic_infoapi key
    Agent Wallet info: addresses, caps, ERC-8004 id. Read-only.
  • q402_wallet_statusprivate key
    Per-chain EIP-7702 delegation state. Read-only.
Memory3
  • q402_memory_summaryapi key
    Summarize treasury activity: spend by chain and source, top vendors, schedules, requests, escrow, failures. Read-only.
  • q402_vendor_historyapi key
    Total paid to a vendor, or a vendor leaderboard with recurring cadence. Read-only.
  • q402_agent_spend_reportapi key
    Per-Agent-Wallet spend with each wallet's caps. Read-only.
Pay2
  • q402_paylive mode
    Single-recipient gasless USDC / USDT / RLUSD / USDG send. Sandbox by default.
  • q402_batch_paylive mode
    Up to 20 recipients in one signed batch (trial: 5 with your own key; server-managed Agent Wallet batch is paid Multichain-only).
Receipts1
  • q402_receiptno auth
    Fetch + locally verify a Trust Receipt.
Recurring7
  • q402_recurring_listapi key
    List recurring rules + next run.
  • q402_recurring_createapi key
    Author a recurring rule (paid Multichain only).
  • q402_recurring_firesapi key
    Last 50 fires for one rule (timestamps + txHashes).
  • q402_recurring_pauseapi key
    Pause a rule. Reversible.
  • q402_recurring_resumeapi key
    Resume a paused or stopped rule.
  • q402_recurring_skip_nextapi key
    Skip only the next fire. Cadence preserved.
  • q402_recurring_cancelapi key
    Permanently stop a rule.
Yield4
  • q402_yield_reservesno auth
    Markets + supply APY across curated lending vaults on BNB and Base. Read-only.
  • q402_yield_positionsapi key
    Your open yield positions + total supplied. Read-only.
  • q402_yield_depositlive mode
    Supply stablecoins into a curated lending vault (BNB USDC/USDT, Base USDC). Mode C. Sandbox by default.
  • q402_yield_withdrawlive mode
    Withdraw from a lending vault on BNB or Base ("max" = full). Sandbox by default.
Staking3
  • q402_stakelive mode
    Gasless Q staking on BNB. Lock tiers 0-3 (30d/10%, 60d/15%, 120d/32%, 180d/40% APR). amount "max" supported. Sandbox by default.
  • q402_unstakelive mode
    Gasless unstake of matured Q on BNB by record index, or all matured (per-record exit). Sandbox by default.
  • q402_stake_positionslive mode
    Read-only: the Agent Wallet's Q stakes (indices, maturity, exitable) + liquid Q balance.
Bridge4
  • q402_bridge_quoteno auth
    Quote CCIP fee for a USDC bridge on eth / avax / arbitrum.
  • q402_bridge_sendlive key
    Execute a CCIP USDC bridge from your Agent Wallet (Mode C). Sandbox by default.
  • q402_bridge_historyowner sig
    List recent CCIP bridges. Owner-sig auth via dashboard.
  • q402_bridge_gas_tankowner sig
    LINK + native Gas Tank bucket per CCIP chain.
Delegation1
  • q402_clear_delegationprivate key / api key
    Clear EIP-7702 delegation on a chain (Mode A/B local key OR Mode C api key, server-signed). Sponsored except Ethereum (Gas Tank). Two-phase consentToken (preview then execute).
Requests3
  • q402_request_createapi key
    Publish a payment request (invoice). No funds move; returns a /pay link + req_ id.
  • q402_request_statusno auth
    Look up a request by req_ id: amount, recipient, status. Read-only.
  • q402_request_paylive mode
    Pay a request gaslessly from your own Agent Wallet. Terms locked to the request.
Escrow6
  • q402_escrow_createapi key
    Create a gasless non-custodial escrow (pending record, moves no funds); optional walletId funds it from an Agent Wallet.
  • q402_escrow_statusno auth
    Read an escrow's state, parties, amount, and tx hashes. Read-only.
  • q402_escrow_locklive mode
    Fund a pending escrow gaslessly (EIP-7702); the server signs for an Agent-Wallet buyer.
  • q402_escrow_releaselive mode
    Buyer releases a locked escrow to the seller (gasless).
  • q402_escrow_refundlive mode
    Permissionless refund to the buyer after the timeout / resolve window.
  • q402_escrow_disputelive mode
    A party disputes an open escrow (requires a named arbiter).
RedStone triggers4
  • q402_redstone_feedsno auth
    Which RedStone feeds this deployment can drive triggers off. Read-only.
  • q402_redstone_trigger_createlive mode
    Arm a gasless payout that fires once when a RedStone feed (NAV / price) crosses a threshold.
  • q402_redstone_trigger_listlive mode
    List the Agent Wallet's RedStone triggers + their fire history.
  • q402_redstone_trigger_cancellive mode
    Permanently stop a RedStone trigger.

Full reference, EIP-7702 details, Trust Receipt + safety guards: /docs, MCP for AI Clients · what the Agent Wallet does