io.github.quackai-org/q402-mcp

io.github.quackai-org/q402-mcp

Q402 - gasless payments, yield, escrow, bridge & NAV triggers on 12 EVM chains. Sandbox-default.

View repository →

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "q402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quackai/q402-mcp@0.11.34"
      ],
      "env": {
        "Q402_TRIAL_API_KEY": "<your Q402_TRIAL_API_KEY>",
        "Q402_MULTICHAIN_API_KEY": "<your Q402_MULTICHAIN_API_KEY>",
        "Q402_PRIVATE_KEY": "<your Q402_PRIVATE_KEY>",
        "Q402_AGENTIC_PRIVATE_KEY": "<your Q402_AGENTIC_PRIVATE_KEY>",
        "Q402_ENABLE_REAL_PAYMENTS": "1",
        "Q402_MAX_AMOUNT_PER_CALL": "200",
        "Q402_RELAY_BASE_URL": "https://q402.quackai.ai/api",
        "Q402_API_KEY": "<your Q402_API_KEY>"
      }
    }
  }
}
Environment variables
  • Q402_TRIAL_API_KEYsecretRecommended path: skip this UI and run `q402_doctor` after install - it stores secrets in ~/.q402/mcp.env, which the server auto-loads. Fill this field directly ONLY if your MCP client manages secrets for you. Value is a Free Trial API key from https://q402.quackai.ai/event - BNB Chain (permanent) + Base (permanent) + Mantle limited-time (2026-08-21~08-28 UTC+9), 500 sponsored TXs, gas covered by Q402. Avalanche trial has ended. BNB and Base payments auto-route to this key when set (same rule for q402_pay and q402_batch_pay up to 5 recipients).
  • Q402_MULTICHAIN_API_KEYsecretRecommended path: skip this UI and run `q402_doctor` after install - it stores secrets in ~/.q402/mcp.env, which the server auto-loads. Fill this field directly ONLY if your MCP client manages secrets for you. Value is a Paid Multichain API key from https://q402.quackai.ai/payment - full 12-chain support with per-chain Gas Tank. Auto-routed for non-BNB payments and whenever keyScope='multichain' is chosen.
  • Q402_PRIVATE_KEYsecretMode A - real EOA signing. Hex-encoded EVM private key (0x + 64 hex chars) of YOUR MetaMask wallet, used to sign payment authorizations LOCALLY on your machine. After your first payment that wallet shows as 'Smart account' in MetaMask (EIP-7702 delegation, reversible via q402_clear_delegation). Use a fresh wallet, not your main one. Skip this and pick Mode B (Q402_AGENTIC_PRIVATE_KEY) or Mode C (server-managed Agent Wallet) if you'd rather keep your MetaMask untouched. Recommended path: run q402_doctor after install - it stores secrets in ~/.q402/mcp.env, which the server auto-loads.
  • Q402_AGENTIC_PRIVATE_KEYsecretMode B - local Agent Wallet signing. Hex-encoded EVM private key (0x + 64 hex chars) exported from your Agent Wallet at https://q402.quackai.ai/dashboard -> Agent tab -> Export. Signs LOCALLY just like Mode A, but the signer is your dedicated Agent Wallet - your MetaMask EOA is never touched. Pick this for AI-agent automation when you want a dedicated purse with per-tx + daily caps you set on the dashboard.
  • Q402_ENABLE_REAL_PAYMENTSLive-mode switch. 0 = sandbox (test mode, no funds move - every q402_pay returns a fake hash). 1 = real on-chain payments. Default 1 since v0.5.11: safe because mode only flips to live when a live API key (q402_live_*) is set AND one of (a) a valid 32-byte private key for local signing modes, OR (b) walletMode="agentic-server" with Q402_MULTICHAIN_API_KEY for the server-managed Agent Wallet path. Without either combination, the server stays in sandbox regardless of this flag.
  • Q402_MAX_AMOUNT_PER_CALLPer-call USD-equivalent cap for USDC/USDT/RLUSD. Any such q402_pay request with amount above this is rejected before signing. Q (QuackAI) is exempt by design (your own token; recipient allowlist + confirmation still apply). Lower this for a tighter agent blast-radius; raise for treasury-grade transfers.
  • Q402_RELAY_BASE_URLOverride for the Q402 relay endpoint. Defaults to https://q402.quackai.ai/api. Set explicitly when running against a self-hosted Q402 deployment or a non-canonical environment.
  • Q402_API_KEYsecretDEPRECATED legacy single-key env from pre-v0.5.0 installs. The server still reads it as a silent fallback so existing setups keep working, but new users should pick a scoped variant instead. Q402_TRIAL_API_KEY (Free Trial, BNB Chain + Base) and Q402_MULTICHAIN_API_KEY (full 12-chain surface) are designed to coexist - BNB and Base payments auto-route to the trial key, other chains use multichain. Only set Q402_API_KEY if you are migrating an existing pre-v0.5.0 install; do NOT set it alongside the scoped variants on a fresh install.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
0.11.34
Registry
active
Published
11/3/2026

More Developer Tools servers

Browse all Developer Tools →

Quadratic

quadratichq

AI access to Quadratic spreadsheets: open files, run Python/SQL, query connected databases.

Developer ToolsAdded 4 months ago

Quadratik

quadratik-ai

Search and manage 220M+ B2B contacts. Filter by title, industry, location, and more.

Developer ToolsAdded 6 months ago

Quady3D MCP

quady3dai

Generate 3D assets, quote credits, recover tasks and save model files to a project.

Developer ToolsAdded 1 week ago

io.github.qualienai/qualien-mcp

qualienai

MCP gateway for QA/SDET work: Playwright, files, GitHub, Jira, Postgres & more in one connection.

Developer ToolsAdded 1 month ago

QualityMax QA MCP

Quality-Max

Final release; the checks moved to 9lives (9l mcp). Local QA MCP: scan, inspect, repro, run tests.

Developer ToolsAdded 4 weeks ago

FineData

quality-network

FineData web scraping MCP — JavaScript rendering, captcha solving, markdown for AI agents

Developer ToolsAdded 2 months ago

Add the badge to your site

Show visitors that io.github.quackai-org/q402-mcp is listed here — it’s also the link we check for a free listing.

io.github.quackai-org/q402-mcp — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-quackai-org-q402-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="io.github.quackai-org/q402-mcp — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![io.github.quackai-org/q402-mcp — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-quackai-org-q402-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.