Q402 Mcp

io.github.quackai-org/q402-mcp · v0.11.34

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

Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add q402-mcp -e Q402_TRIAL_API_KEY=<Q402_TRIAL_API_KEY> -e Q402_MULTICHAIN_API_KEY=<Q402_MULTICHAIN_API_KEY> -e Q402_PRIVATE_KEY=<Q402_PRIVATE_KEY> -e Q402_AGENTIC_PRIVATE_KEY=<Q402_AGENTIC_PRIVATE_KEY> -e Q402_ENABLE_REAL_PAYMENTS=<Q402_ENABLE_REAL_PAYMENTS> -e Q402_MAX_AMOUNT_PER_CALL=<Q402_MAX_AMOUNT_PER_CALL> -e Q402_ALLOWED_RECIPIENTS=<Q402_ALLOWED_RECIPIENTS> -e Q402_RELAY_BASE_URL=<Q402_RELAY_BASE_URL> -e Q402_AGENT_WALLET_ADDRESS=<Q402_AGENT_WALLET_ADDRESS> -e Q402_API_KEY=<Q402_API_KEY> -e Q402_WALLET_ID=<Q402_WALLET_ID> -e Q402_BUILDER_CODE=<Q402_BUILDER_CODE> -- npx -y @quackai/[email protected]

claude_desktop_config.json

{
  "mcpServers": {
    "q402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quackai/[email protected]"
      ],
      "env": {
        "Q402_TRIAL_API_KEY": "<Q402_TRIAL_API_KEY>",
        "Q402_MULTICHAIN_API_KEY": "<Q402_MULTICHAIN_API_KEY>",
        "Q402_PRIVATE_KEY": "<Q402_PRIVATE_KEY>",
        "Q402_AGENTIC_PRIVATE_KEY": "<Q402_AGENTIC_PRIVATE_KEY>",
        "Q402_ENABLE_REAL_PAYMENTS": "<Q402_ENABLE_REAL_PAYMENTS>",
        "Q402_MAX_AMOUNT_PER_CALL": "<Q402_MAX_AMOUNT_PER_CALL>",
        "Q402_ALLOWED_RECIPIENTS": "<Q402_ALLOWED_RECIPIENTS>",
        "Q402_RELAY_BASE_URL": "<Q402_RELAY_BASE_URL>",
        "Q402_AGENT_WALLET_ADDRESS": "<Q402_AGENT_WALLET_ADDRESS>",
        "Q402_API_KEY": "<Q402_API_KEY>",
        "Q402_WALLET_ID": "<Q402_WALLET_ID>",
        "Q402_BUILDER_CODE": "<Q402_BUILDER_CODE>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "q402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quackai/[email protected]"
      ],
      "env": {
        "Q402_TRIAL_API_KEY": "<Q402_TRIAL_API_KEY>",
        "Q402_MULTICHAIN_API_KEY": "<Q402_MULTICHAIN_API_KEY>",
        "Q402_PRIVATE_KEY": "<Q402_PRIVATE_KEY>",
        "Q402_AGENTIC_PRIVATE_KEY": "<Q402_AGENTIC_PRIVATE_KEY>",
        "Q402_ENABLE_REAL_PAYMENTS": "<Q402_ENABLE_REAL_PAYMENTS>",
        "Q402_MAX_AMOUNT_PER_CALL": "<Q402_MAX_AMOUNT_PER_CALL>",
        "Q402_ALLOWED_RECIPIENTS": "<Q402_ALLOWED_RECIPIENTS>",
        "Q402_RELAY_BASE_URL": "<Q402_RELAY_BASE_URL>",
        "Q402_AGENT_WALLET_ADDRESS": "<Q402_AGENT_WALLET_ADDRESS>",
        "Q402_API_KEY": "<Q402_API_KEY>",
        "Q402_WALLET_ID": "<Q402_WALLET_ID>",
        "Q402_BUILDER_CODE": "<Q402_BUILDER_CODE>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "q402-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@quackai/[email protected]"
      ],
      "env": {
        "Q402_TRIAL_API_KEY": "<Q402_TRIAL_API_KEY>",
        "Q402_MULTICHAIN_API_KEY": "<Q402_MULTICHAIN_API_KEY>",
        "Q402_PRIVATE_KEY": "<Q402_PRIVATE_KEY>",
        "Q402_AGENTIC_PRIVATE_KEY": "<Q402_AGENTIC_PRIVATE_KEY>",
        "Q402_ENABLE_REAL_PAYMENTS": "<Q402_ENABLE_REAL_PAYMENTS>",
        "Q402_MAX_AMOUNT_PER_CALL": "<Q402_MAX_AMOUNT_PER_CALL>",
        "Q402_ALLOWED_RECIPIENTS": "<Q402_ALLOWED_RECIPIENTS>",
        "Q402_RELAY_BASE_URL": "<Q402_RELAY_BASE_URL>",
        "Q402_AGENT_WALLET_ADDRESS": "<Q402_AGENT_WALLET_ADDRESS>",
        "Q402_API_KEY": "<Q402_API_KEY>",
        "Q402_WALLET_ID": "<Q402_WALLET_ID>",
        "Q402_BUILDER_CODE": "<Q402_BUILDER_CODE>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`Q402_TRIAL_API_KEY` Optional, secret	Recommended 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)…
`Q402_MULTICHAIN_API_KEY` Optional, secret	Recommended 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 s…
`Q402_PRIVATE_KEY` Optional, secret	Mode 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…
`Q402_AGENTIC_PRIVATE_KEY` Optional, secret	Mode 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…
`Q402_ENABLE_REAL_PAYMENTS` Optional	Live-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…
`Q402_MAX_AMOUNT_PER_CALL` Optional	Per-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 trans…
`Q402_ALLOWED_RECIPIENTS` Optional	Optional comma-separated lowercase EVM addresses. When set, q402_pay rejects any recipient not on this allowlist.
`Q402_RELAY_BASE_URL` Optional	Override 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_AGENT_WALLET_ADDRESS` Optional	Server-managed Agent Wallet picker (walletMode='agentic-server' only). Lowercased agent wallet address (the hex 0x... shown on the Agent tab of your dashboard) selecting which of your Agent Wallets to spend from when you hold more than one (max 10 per owner). Omit to use the default wallet. Ignored…
`Q402_API_KEY` Optional, secret	DEPRECATED 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 de…
`Q402_WALLET_ID` Optional	DEPRECATED soft-migration alias for Q402_AGENT_WALLET_ADDRESS (one release of overlap from v0.6.0). The server still accepts it but logs a deprecation notice. New installs should set Q402_AGENT_WALLET_ADDRESS directly.
`Q402_BUILDER_CODE` Optional	Optional Base Builder Code for onchain attribution (ERC-8021 / Base Builder Codes). When set, every q402_x402_fetch payment includes your code as the client/intermediary in the x402 payment extension so payments are attributed onchain. Format: 1-32 lowercase letters, numbers, or underscores. Leave…

Details

Package	`@quackai/[email protected]` (NPM, stdio)
First published	3 Nov 2026
Last updated	3 Nov 2026
Registry name	`io.github.quackai-org/q402-mcp`

More finance and crypto servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use Q402 Mcp often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-quackai-org-q402-mcp/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-quackai-org-q402-mcp)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.