io.github.bitgett/q402-mcp

io.github.bitgett/q402-mcp·v0.1.3·Finance & Payments

Quality Score

/100

Q402 — gasless USDC/USDT payments across 7 EVM chains, callable from any MCP client.

Repository →

§01 Install

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "q402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quackai/q402-mcp"
      ],
      "env": {
        "Q402_API_KEY": "<your-q402_api_key>",
        "Q402_PRIVATE_KEY": "<your-q402_private_key>",
        "Q402_ENABLE_REAL_PAYMENTS": "0",
        "Q402_MAX_AMOUNT_PER_CALL": "5",
        "Q402_ALLOWED_RECIPIENTS": "<q402_allowed_recipients>",
        "Q402_RELAY_BASE_URL": "https://q402.quackai.ai/api"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "q402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quackai/q402-mcp"
      ],
      "env": {
        "Q402_API_KEY": "<your-q402_api_key>",
        "Q402_PRIVATE_KEY": "<your-q402_private_key>",
        "Q402_ENABLE_REAL_PAYMENTS": "0",
        "Q402_MAX_AMOUNT_PER_CALL": "5",
        "Q402_ALLOWED_RECIPIENTS": "<q402_allowed_recipients>",
        "Q402_RELAY_BASE_URL": "https://q402.quackai.ai/api"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y @quackai/q402-mcp

§02 Environment variables

Q402_API_KEY

secret

Q402 API key from https://q402.quackai.ai/dashboard. q402_test_* keys keep the server in sandbox mode; q402_live_* keys are required for real on-chain transactions.

Q402_PRIVATE_KEY

secret

Hex-encoded EVM private key used to sign payment authorizations. Required only for real on-chain payments (live mode).

Q402_ENABLE_REAL_PAYMENTS

Set to '1' to allow real on-chain transactions. Any other value (or unset) keeps the server in sandbox mode regardless of API key tier.

Q402_MAX_AMOUNT_PER_CALL

Per-call USD-equivalent cap. Any q402_pay request with amount above this is rejected before signing.

Q402_ALLOWED_RECIPIENTS

Optional comma-separated lowercase EVM addresses. When set, q402_pay rejects any recipient not on this allowlist.

Q402_RELAY_BASE_URL

Override for the Q402 relay endpoint. Defaults to https://q402.quackai.ai/api when unset; useful for self-hosted Q402 deployments.

§03 MCP Quality Score · methodology

freshness

completeness

installability

documentation

stability

§04 Alternatives in Finance & Payments

ai.baselight/baselight

Query Baselight's public catalog of 70,000+ datasets — finance, demographics, sports, and more.

DeepLedger — AI Bookkeeper for QuickBooks

ai.deepledger/mcp

AI bookkeeping for QuickBooks Online — 28 tools for transactions, reports, and bank feeds

Lattiq x402 Trading Signals

ai.lattiq/x402-trading-signals

Regime-aware ES1/NQ futures trading signals. HMM + 15 quant strategies. x402 USDC micropayments.