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.
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.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.
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.
No PK in env. No MetaMask popup. Best for AI agents. Free-trial keys work here too (BNB Chain + Base).
Q402_MULTICHAIN_API_KEY=q402_live_... # paid plan Q402_TRIAL_API_KEY=q402_live_... # or the free trial Q402_ENABLE_REAL_PAYMENTS=1
Mode C's wallet, your private key. Export once from the dashboard. Local signing, MetaMask untouched.
Q402_AGENTIC_PRIVATE_KEY=0x... Q402_MULTICHAIN_API_KEY=q402_live_... Q402_ENABLE_REAL_PAYMENTS=1
Signs directly via EIP-7702 (shows "Smart account", reversible). Use a fresh wallet.
Q402_PRIVATE_KEY=0x... Q402_MULTICHAIN_API_KEY=q402_live_... Q402_ENABLE_REAL_PAYMENTS=1
~/.q402/mcp.env. q402_doctor asks on first install.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.
- 01Stablechain 988USDC and USDT both alias to USDT0USDT0$0.0005$0.00
- 02Basechain 8453OP Stack L2, EIP-7702 via Isthmus. USDT is bridgedETH$0.0008$0.00
- 03Robinhood Chainchain 4663Arbitrum Nitro L2. USDG only (Paxos Global Dollar)ETH$0.0008$0.00
- 04BNB Chainchain 56BNB$0.0010$0.00
- 05Scrollchain 534352zkEVM L2, EIP-7702 since Euclid Phase 2ETH$0.0010$0.00
- 06Arbitrum Onechain 42161Native USDC (not USDC.e) + USDTETH$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 1L1, volatile gas. RLUSD (Ripple USD) Ethereum-onlyETH$1.20$0.00
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.
q402_doctorno authInstall + ongoing health check. Call on "set up Q402".q402_quoteno authCompare gas across all 12 chains. Read-only.q402_balanceapi keyVerify key + remaining quota.q402_agentic_infoapi keyAgent Wallet info: addresses, caps, ERC-8004 id. Read-only.q402_wallet_statusprivate keyPer-chain EIP-7702 delegation state. Read-only.
q402_memory_summaryapi keySummarize treasury activity: spend by chain and source, top vendors, schedules, requests, escrow, failures. Read-only.q402_vendor_historyapi keyTotal paid to a vendor, or a vendor leaderboard with recurring cadence. Read-only.q402_agent_spend_reportapi keyPer-Agent-Wallet spend with each wallet's caps. Read-only.
q402_paylive modeSingle-recipient gasless USDC / USDT / RLUSD / USDG send. Sandbox by default.q402_batch_paylive modeUp to 20 recipients in one signed batch (trial: 5 with your own key; server-managed Agent Wallet batch is paid Multichain-only).
q402_receiptno authFetch + locally verify a Trust Receipt.
q402_recurring_listapi keyList recurring rules + next run.q402_recurring_createapi keyAuthor a recurring rule (paid Multichain only).q402_recurring_firesapi keyLast 50 fires for one rule (timestamps + txHashes).q402_recurring_pauseapi keyPause a rule. Reversible.q402_recurring_resumeapi keyResume a paused or stopped rule.q402_recurring_skip_nextapi keySkip only the next fire. Cadence preserved.q402_recurring_cancelapi keyPermanently stop a rule.
q402_yield_reservesno authMarkets + supply APY across curated lending vaults on BNB and Base. Read-only.q402_yield_positionsapi keyYour open yield positions + total supplied. Read-only.q402_yield_depositlive modeSupply stablecoins into a curated lending vault (BNB USDC/USDT, Base USDC). Mode C. Sandbox by default.q402_yield_withdrawlive modeWithdraw from a lending vault on BNB or Base ("max" = full). Sandbox by default.
q402_stakelive modeGasless 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 modeGasless unstake of matured Q on BNB by record index, or all matured (per-record exit). Sandbox by default.q402_stake_positionslive modeRead-only: the Agent Wallet's Q stakes (indices, maturity, exitable) + liquid Q balance.
q402_bridge_quoteno authQuote CCIP fee for a USDC bridge on eth / avax / arbitrum.q402_bridge_sendlive keyExecute a CCIP USDC bridge from your Agent Wallet (Mode C). Sandbox by default.q402_bridge_historyowner sigList recent CCIP bridges. Owner-sig auth via dashboard.q402_bridge_gas_tankowner sigLINK + native Gas Tank bucket per CCIP chain.
q402_clear_delegationprivate key / api keyClear 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).
q402_request_createapi keyPublish a payment request (invoice). No funds move; returns a /pay link + req_ id.q402_request_statusno authLook up a request by req_ id: amount, recipient, status. Read-only.q402_request_paylive modePay a request gaslessly from your own Agent Wallet. Terms locked to the request.
q402_escrow_createapi keyCreate a gasless non-custodial escrow (pending record, moves no funds); optional walletId funds it from an Agent Wallet.q402_escrow_statusno authRead an escrow's state, parties, amount, and tx hashes. Read-only.q402_escrow_locklive modeFund a pending escrow gaslessly (EIP-7702); the server signs for an Agent-Wallet buyer.q402_escrow_releaselive modeBuyer releases a locked escrow to the seller (gasless).q402_escrow_refundlive modePermissionless refund to the buyer after the timeout / resolve window.q402_escrow_disputelive modeA party disputes an open escrow (requires a named arbiter).
q402_redstone_feedsno authWhich RedStone feeds this deployment can drive triggers off. Read-only.q402_redstone_trigger_createlive modeArm a gasless payout that fires once when a RedStone feed (NAV / price) crosses a threshold.q402_redstone_trigger_listlive modeList the Agent Wallet's RedStone triggers + their fire history.q402_redstone_trigger_cancellive modePermanently stop a RedStone trigger.
Full reference, EIP-7702 details, Trust Receipt + safety guards: /docs, MCP for AI Clients · what the Agent Wallet does
npm 
