原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。使用 Google 登录即可撰写评价。原型 · 每 30 分钟更新
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

Q402 MCP

作者:quackai-org版本 0.11.34i★ 1i在你的电脑上运行代码仓库 ↗
注册名称io.github.quackai-org/q402-mcp

安装方法

What it does

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

  • Connects 在你的电脑上运行
  • Account or key Needs Q402_MULTICHAIN_API_KEY, Q402_PRIVATE_KEY, Q402_AGENTIC_PRIVATE_KEY, Q402_API_KEY
  • Category 加密货币与区块链

为什么排在这里

列表按使用分(满分 100)排序,由以下部分组成

热度13/80GitHub 星标或每周下载量:较大的计 60,较小的计 20
新鲜度12/1230 天内有发布或代码更新得满分
仍在响应0/8上次检查时云端端点有响应
使用分25/100

质量: 基础检查通过 3/3 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)

安装

选择你使用的 AI 应用,然后复制设置。

用一句话让 AI 帮你安装

请帮我安装 Q402 MCP。按照 https://mcp.popnx.com/i/quackai-org-q402-mcp.md 操作,先把命令给我看,等我同意后再运行。

粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文

通过 3/3 项检查 · 在你的电脑上运行 · ✓ 命令已检查 2026年11月14日

第一步:你用哪个 AI?

选择你用的应用,步骤会显示在下方。

可连接 Claude,但需要先准备

需要 Q402 MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Node.js(只需一次) · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用

让 AI 帮你安装

把这段话复制到 Claude 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。

请在这台电脑上为 Claude 安装 MCP server Q402 MCP,按顺序:1) 用 node -v 检查是否有 Node.js。没有的话,请让我从 https://nodejs.org/en/download 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "mcpServers": { "q402": { "command": "npx", "args": [ "-y", "@quackai/q402-mcp" ], "env": { "Q402_MULTICHAIN_API_KEY": "your-value", "Q402_PRIVATE_KEY": "your-value", "Q402_AGENTIC_PRIVATE_KEY": "your-value", "Q402_API_KEY": "your-value" } } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) Q402_MULTICHAIN_API_KEY, Q402_PRIVATE_KEY, Q402_AGENTIC_PRIVATE_KEY, Q402_API_KEY 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 Q402 MCP 的工具真的出现了。

这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。

  1. 安装 Node.js(如果还没有)

    已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter

    node -v
    • 显示版本号(例如 v26.13.1)= 已安装,可跳过这一步
    • 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
    怎么打开终端

    Mac:按 ⌘ + Space,输入 Terminal 后按 Enter

    Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”

    还没安装: 打开官方下载页,选择 LTS 版本和点选式安装程序:Mac 用 .pkg · Windows 用 .msi。双击后一路下一步即可,不需要 curl 命令

    打开 Node.js 下载页 ↗

    装好后关掉终端再打开,重新运行同一条命令,应显示版本号: node -v

    安装一次,所有需要 Node.js 的工具都能用

  2. 注册并创建 Q402 MCP 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    获取密钥的方法见下方开发者的 README

  3. 打开电脑版 Claude 应用的设置文件

    SettingsDeveloperEdit Config

  4. 粘贴这些设置并保存文件

    {
      "mcpServers": {
        "q402": {
          "command": "npx",
          "args": [
            "-y",
            "@quackai/q402-mcp"
          ],
          "env": {
            "Q402_MULTICHAIN_API_KEY": "your-value",
            "Q402_PRIVATE_KEY": "your-value",
            "Q402_AGENTIC_PRIVATE_KEY": "your-value",
            "Q402_API_KEY": "your-value"
          }
        }
      }
    }

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

  5. 退出 Claude 再重新打开

  6. 试一试

    用 Q402 MCP 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude 说正在使用 Q402 MCP,或回答中出现 Q402 MCP 的工具名称,就表示连接成功

8 项可选设置(不填也能用)

上面的命令不填这些也能用。想调整时再按开发者的说明添加。

  • Q402_TRIAL_API_KEY 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 secret…
  • Q402_ENABLE_REAL_PAYMENTS 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 AP… · 默认值 1
  • Q402_MAX_AMOUNT_PER_CALL USDC/USDT/RLUSD 每次调用的等值 USD 上限。任何金额超过此值的 q402_pay 请求都会在签名前被拒绝。Q(QuackAI)按设计豁免(您自己的代币;由收款人白名单与……
    查看英文原文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 + co…
    · 默认值 200
  • Q402_ALLOWED_RECIPIENTS 可选的、以逗号分隔的小写 EVM 地址列表。设置后,q402_pay 会拒绝任何不在此允许列表中的收款人。
    查看英文原文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. Set explicitly when running against a self-hosted Q402 deployment or a non-canonical environment. · 默认值 https://q402.quackai.ai/api
  • Q402_AGENT_WALLET_ADDRESS 服务器托管的 Agent Wallet 选择器(仅适用于 walletMode='agentic-server')。填写小写的 agent wallet 地址(仪表板 Agent 标签页中显示的 0x... 十六进制地址),用于选择您的 Agent Wallet。
    查看英文原文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 t…
  • Q402_WALLET_ID Q402_AGENT_WALLET_ADDRESS 的已弃用软迁移别名(自 v0.6.0 起与其并存一个版本)。服务器仍接受该变量,但会记录弃用提示。新安装应设置 Q402_AGENT_WALLE…
    查看英文原文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_WALLE…
  • Q402_BUILDER_CODE 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…

说明为自动翻译,变量名保持原样;不确定时请查看原文。

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

ChatGPT 暂时无法连接 Q402 MCP

Q402 MCP 需要安装在你的电脑上,而 ChatGPT 只能连接在网上运行的服务器

你可以改用这些方式

A · 使用能连接 Q402 MCP 的应用

  • 需要 Q402 MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Node.js(只需一次) · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用
  • 需要 Q402 MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Node.js(只需一次)
  • 需要 Q402 MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Node.js(只需一次)
  • 需要 Q402 MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Node.js(只需一次)

B · 加密货币与区块链 类中能连接 ChatGPT 的其他服务器

从同类中使用较多的里挑选,仅限用地址即可连接、无需密钥的

可连接 Claude Code,但需要先准备

需要 Q402 MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Node.js(只需一次)

让 AI 帮你安装

把这段话复制到 Claude Code 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。

请在这台电脑上为 Claude Code 安装 MCP server Q402 MCP,按顺序:1) 用 node -v 检查是否有 Node.js。没有的话,请让我从 https://nodejs.org/en/download 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):claude mcp add --scope user q402 --env Q402_MULTICHAIN_API_KEY=your-value --env Q402_PRIVATE_KEY=your-value --env Q402_AGENTIC_PRIVATE_KEY=your-value --env Q402_API_KEY=your-value -- npx -y @quackai/q402-mcp 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) Q402_MULTICHAIN_API_KEY, Q402_PRIVATE_KEY, Q402_AGENTIC_PRIVATE_KEY, Q402_API_KEY 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 Q402 MCP 的工具真的出现了。

这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。

  1. 安装 Node.js(如果还没有)

    已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter

    node -v
    • 显示版本号(例如 v26.13.1)= 已安装,可跳过这一步
    • 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
    怎么打开终端

    Mac:按 ⌘ + Space,输入 Terminal 后按 Enter

    Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”

    还没安装: 打开官方下载页,选择 LTS 版本和点选式安装程序:Mac 用 .pkg · Windows 用 .msi。双击后一路下一步即可,不需要 curl 命令

    打开 Node.js 下载页 ↗

    装好后关掉终端再打开,重新运行同一条命令,应显示版本号: node -v

    安装一次,所有需要 Node.js 的工具都能用

  2. 注册并创建 Q402 MCP 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    获取密钥的方法见下方开发者的 README

  3. 打开终端

    Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell

  4. 粘贴这条命令并按 Enter

    claude mcp add --scope user q402 --env Q402_MULTICHAIN_API_KEY=your-value --env Q402_PRIVATE_KEY=your-value --env Q402_AGENTIC_PRIVATE_KEY=your-value --env Q402_API_KEY=your-value -- npx -y @quackai/q402-mcp

    按 Enter 前,把“your-value”改成你的密钥

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

  5. 在 Claude Code 中输入 /mcp

    应能看到 Q402 MCP 在列表中并显示已连接

  6. 试一试

    用 Q402 MCP 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude Code 说正在使用 Q402 MCP,或回答中出现 Q402 MCP 的工具名称,就表示连接成功

8 项可选设置(不填也能用)

上面的命令不填这些也能用。想调整时再按开发者的说明添加。

  • Q402_TRIAL_API_KEY 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 secret…
  • Q402_ENABLE_REAL_PAYMENTS 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 AP… · 默认值 1
  • Q402_MAX_AMOUNT_PER_CALL USDC/USDT/RLUSD 每次调用的等值 USD 上限。任何金额超过此值的 q402_pay 请求都会在签名前被拒绝。Q(QuackAI)按设计豁免(您自己的代币;由收款人白名单与……
    查看英文原文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 + co…
    · 默认值 200
  • Q402_ALLOWED_RECIPIENTS 可选的、以逗号分隔的小写 EVM 地址列表。设置后,q402_pay 会拒绝任何不在此允许列表中的收款人。
    查看英文原文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. Set explicitly when running against a self-hosted Q402 deployment or a non-canonical environment. · 默认值 https://q402.quackai.ai/api
  • Q402_AGENT_WALLET_ADDRESS 服务器托管的 Agent Wallet 选择器(仅适用于 walletMode='agentic-server')。填写小写的 agent wallet 地址(仪表板 Agent 标签页中显示的 0x... 十六进制地址),用于选择您的 Agent Wallet。
    查看英文原文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 t…
  • Q402_WALLET_ID Q402_AGENT_WALLET_ADDRESS 的已弃用软迁移别名(自 v0.6.0 起与其并存一个版本)。服务器仍接受该变量,但会记录弃用提示。新安装应设置 Q402_AGENT_WALLE…
    查看英文原文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_WALLE…
  • Q402_BUILDER_CODE 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…

说明为自动翻译,变量名保持原样;不确定时请查看原文。

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Cursor,但需要先准备

需要 Q402 MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Node.js(只需一次)

让 AI 帮你安装

把这段话复制到 Cursor 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。

请在这台电脑上为 Cursor 安装 MCP server Q402 MCP,按顺序:1) 用 node -v 检查是否有 Node.js。没有的话,请让我从 https://nodejs.org/en/download 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "mcpServers": { "q402": { "command": "npx", "args": [ "-y", "@quackai/q402-mcp" ], "env": { "Q402_MULTICHAIN_API_KEY": "your-value", "Q402_PRIVATE_KEY": "your-value", "Q402_AGENTIC_PRIVATE_KEY": "your-value", "Q402_API_KEY": "your-value" } } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) Q402_MULTICHAIN_API_KEY, Q402_PRIVATE_KEY, Q402_AGENTIC_PRIVATE_KEY, Q402_API_KEY 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 Q402 MCP 的工具真的出现了。

这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。

  1. 安装 Node.js(如果还没有)

    已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter

    node -v
    • 显示版本号(例如 v26.13.1)= 已安装,可跳过这一步
    • 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
    怎么打开终端

    Mac:按 ⌘ + Space,输入 Terminal 后按 Enter

    Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”

    还没安装: 打开官方下载页,选择 LTS 版本和点选式安装程序:Mac 用 .pkg · Windows 用 .msi。双击后一路下一步即可,不需要 curl 命令

    打开 Node.js 下载页 ↗

    装好后关掉终端再打开,重新运行同一条命令,应显示版本号: node -v

    安装一次,所有需要 Node.js 的工具都能用

  2. 注册并创建 Q402 MCP 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    获取密钥的方法见下方开发者的 README

  3. 点击这个按钮打开 Cursor

    在 Cursor 中打开

    Cursor 会请你确认安装,点击 Install

  4. 填写你的密钥

    在 Q402 MCP 的设置中,Q402_MULTICHAIN_API_KEY, Q402_PRIVATE_KEY, Q402_AGENTIC_PRIVATE_KEY, Q402_API_KEY 还是空的,填入你的密钥并保存

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

  5. 在 Cursor 中以 Agent 模式打开 AI 聊天

  6. 试一试

    用 Q402 MCP 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Cursor 说正在使用 Q402 MCP,或回答中出现 Q402 MCP 的工具名称,就表示连接成功

8 项可选设置(不填也能用)

上面的命令不填这些也能用。想调整时再按开发者的说明添加。

  • Q402_TRIAL_API_KEY 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 secret…
  • Q402_ENABLE_REAL_PAYMENTS 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 AP… · 默认值 1
  • Q402_MAX_AMOUNT_PER_CALL USDC/USDT/RLUSD 每次调用的等值 USD 上限。任何金额超过此值的 q402_pay 请求都会在签名前被拒绝。Q(QuackAI)按设计豁免(您自己的代币;由收款人白名单与……
    查看英文原文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 + co…
    · 默认值 200
  • Q402_ALLOWED_RECIPIENTS 可选的、以逗号分隔的小写 EVM 地址列表。设置后,q402_pay 会拒绝任何不在此允许列表中的收款人。
    查看英文原文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. Set explicitly when running against a self-hosted Q402 deployment or a non-canonical environment. · 默认值 https://q402.quackai.ai/api
  • Q402_AGENT_WALLET_ADDRESS 服务器托管的 Agent Wallet 选择器(仅适用于 walletMode='agentic-server')。填写小写的 agent wallet 地址(仪表板 Agent 标签页中显示的 0x... 十六进制地址),用于选择您的 Agent Wallet。
    查看英文原文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 t…
  • Q402_WALLET_ID Q402_AGENT_WALLET_ADDRESS 的已弃用软迁移别名(自 v0.6.0 起与其并存一个版本)。服务器仍接受该变量,但会记录弃用提示。新安装应设置 Q402_AGENT_WALLE…
    查看英文原文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_WALLE…
  • Q402_BUILDER_CODE 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…

说明为自动翻译,变量名保持原样;不确定时请查看原文。

菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同

可连接 VS Code,但需要先准备

需要 Q402 MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Node.js(只需一次)

让 AI 帮你安装

把这段话复制到 VS Code 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。

请在这台电脑上为 VS Code 安装 MCP server Q402 MCP,按顺序:1) 用 node -v 检查是否有 Node.js。没有的话,请让我从 https://nodejs.org/en/download 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "servers": { "q402": { "type": "stdio", "command": "npx", "args": [ "-y", "@quackai/q402-mcp" ], "env": { "Q402_MULTICHAIN_API_KEY": "your-value", "Q402_PRIVATE_KEY": "your-value", "Q402_AGENTIC_PRIVATE_KEY": "your-value", "Q402_API_KEY": "your-value" } } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) Q402_MULTICHAIN_API_KEY, Q402_PRIVATE_KEY, Q402_AGENTIC_PRIVATE_KEY, Q402_API_KEY 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 Q402 MCP 的工具真的出现了。

这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。

  1. 安装 Node.js(如果还没有)

    已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter

    node -v
    • 显示版本号(例如 v26.13.1)= 已安装,可跳过这一步
    • 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
    怎么打开终端

    Mac:按 ⌘ + Space,输入 Terminal 后按 Enter

    Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”

    还没安装: 打开官方下载页,选择 LTS 版本和点选式安装程序:Mac 用 .pkg · Windows 用 .msi。双击后一路下一步即可,不需要 curl 命令

    打开 Node.js 下载页 ↗

    装好后关掉终端再打开,重新运行同一条命令,应显示版本号: node -v

    安装一次,所有需要 Node.js 的工具都能用

  2. 注册并创建 Q402 MCP 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    获取密钥的方法见下方开发者的 README

  3. 点击这个按钮打开 VS Code

    在 VS Code 中打开

    VS Code 会请你确认安装,点击 Install

  4. 填写你的密钥

    在 Q402 MCP 的设置中,Q402_MULTICHAIN_API_KEY, Q402_PRIVATE_KEY, Q402_AGENTIC_PRIVATE_KEY, Q402_API_KEY 还是空的,填入你的密钥并保存

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

  5. 在 VS Code 中以 Agent 模式打开 AI 聊天

  6. 试一试

    用 Q402 MCP 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 VS Code 说正在使用 Q402 MCP,或回答中出现 Q402 MCP 的工具名称,就表示连接成功

8 项可选设置(不填也能用)

上面的命令不填这些也能用。想调整时再按开发者的说明添加。

  • Q402_TRIAL_API_KEY 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 secret…
  • Q402_ENABLE_REAL_PAYMENTS 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 AP… · 默认值 1
  • Q402_MAX_AMOUNT_PER_CALL USDC/USDT/RLUSD 每次调用的等值 USD 上限。任何金额超过此值的 q402_pay 请求都会在签名前被拒绝。Q(QuackAI)按设计豁免(您自己的代币;由收款人白名单与……
    查看英文原文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 + co…
    · 默认值 200
  • Q402_ALLOWED_RECIPIENTS 可选的、以逗号分隔的小写 EVM 地址列表。设置后,q402_pay 会拒绝任何不在此允许列表中的收款人。
    查看英文原文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. Set explicitly when running against a self-hosted Q402 deployment or a non-canonical environment. · 默认值 https://q402.quackai.ai/api
  • Q402_AGENT_WALLET_ADDRESS 服务器托管的 Agent Wallet 选择器(仅适用于 walletMode='agentic-server')。填写小写的 agent wallet 地址(仪表板 Agent 标签页中显示的 0x... 十六进制地址),用于选择您的 Agent Wallet。
    查看英文原文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 t…
  • Q402_WALLET_ID Q402_AGENT_WALLET_ADDRESS 的已弃用软迁移别名(自 v0.6.0 起与其并存一个版本)。服务器仍接受该变量,但会记录弃用提示。新安装应设置 Q402_AGENT_WALLE…
    查看英文原文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_WALLE…
  • Q402_BUILDER_CODE 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…

说明为自动翻译,变量名保持原样;不确定时请查看原文。

菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同

其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看

查看所有支持 MCP 的应用 →

JSON 设置在下方“开发者专用”中

卡住了?问问正在用 Q402 MCP 的人💬 讨论 →
开发者专用:终端命令和 JSON 设置

安装在电脑上

Claude Code

claude mcp add --scope user q402 --env Q402_MULTICHAIN_API_KEY=your-value --env Q402_PRIVATE_KEY=your-value --env Q402_AGENTIC_PRIVATE_KEY=your-value --env Q402_API_KEY=your-value -- npx -y @quackai/q402-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "q402": {
      "command": "npx",
      "args": [
        "-y",
        "@quackai/q402-mcp"
      ],
      "env": {
        "Q402_MULTICHAIN_API_KEY": "your-value",
        "Q402_PRIVATE_KEY": "your-value",
        "Q402_AGENTIC_PRIVATE_KEY": "your-value",
        "Q402_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "q402": {
      "command": "npx",
      "args": [
        "-y",
        "@quackai/q402-mcp"
      ],
      "env": {
        "Q402_MULTICHAIN_API_KEY": "your-value",
        "Q402_PRIVATE_KEY": "your-value",
        "Q402_AGENTIC_PRIVATE_KEY": "your-value",
        "Q402_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "q402": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@quackai/q402-mcp"
      ],
      "env": {
        "Q402_MULTICHAIN_API_KEY": "your-value",
        "Q402_PRIVATE_KEY": "your-value",
        "Q402_AGENTIC_PRIVATE_KEY": "your-value",
        "Q402_API_KEY": "your-value"
      }
    }
  }
}

需要你填写的值

  • Q402_TRIAL_API_KEY 机密 env
    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 secret…
  • Q402_MULTICHAIN_API_KEY 机密 必填 env
    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 secret…
  • Q402_PRIVATE_KEY 机密 必填 env
    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 s…
  • Q402_AGENTIC_PRIVATE_KEY 机密 必填 env
    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 li…
  • Q402_ENABLE_REAL_PAYMENTS env
    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 AP…
  • Q402_MAX_AMOUNT_PER_CALL env
    USDC/USDT/RLUSD 每次调用的等值 USD 上限。任何金额超过此值的 q402_pay 请求都会在签名前被拒绝。Q(QuackAI)按设计豁免(您自己的代币;由收款人白名单与……
    查看英文原文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 + co…
  • Q402_ALLOWED_RECIPIENTS env
    可选的、以逗号分隔的小写 EVM 地址列表。设置后,q402_pay 会拒绝任何不在此允许列表中的收款人。
    查看英文原文Optional comma-separated lowercase EVM addresses. When set, q402_pay rejects any recipient not on this allowlist.
  • Q402_RELAY_BASE_URL env
    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 env
    服务器托管的 Agent Wallet 选择器(仅适用于 walletMode='agentic-server')。填写小写的 agent wallet 地址(仪表板 Agent 标签页中显示的 0x... 十六进制地址),用于选择您的 Agent Wallet。
    查看英文原文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 t…
  • Q402_API_KEY 机密 必填 env
    来自 v0.5.0 之前安装版本的已弃用单密钥环境变量。服务器仍会将其作为静默回退读取,以便现有配置继续工作,但新用户应改用有作用域的变量。Q402_TRI…
    查看英文原文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_TRI…
  • Q402_WALLET_ID env
    Q402_AGENT_WALLET_ADDRESS 的已弃用软迁移别名(自 v0.6.0 起与其并存一个版本)。服务器仍接受该变量,但会记录弃用提示。新安装应设置 Q402_AGENT_WALLE…
    查看英文原文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_WALLE…
  • Q402_BUILDER_CODE env
    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…

说明为自动翻译,变量名保持原样;不确定时请查看原文。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

一览

每周下载量i
392/周
许可证i
Apache-2.0
连接方式
在你的电脑上运行
最新版本i
0.11.34
发布到注册中心i
2026年11月3日
代码最后更新i
2026年11月3日
作者
quackai-org
软件包
npm: @quackai/q402-mcp
注册状态
活跃

哪些应用可以使用它

依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。

在你的电脑上运行,适用于

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

全部应用及其优缺点 →

它能做什么

它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月18日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 quackai-org 验证,该账户拥有此仓库

  • ✓ 通过

    仍在维护

    代码最后更新于15天前

  • ✓ 通过

    有许可证

    使用 Apache-2.0

  • – 不适用

    端点有响应

    它在你的电脑上运行,没有互联网端点

  • – 不适用

    使用 OAuth 登录

    在你的电脑上运行,改用本地设置

  • … 尚未检查

    工具描述中没有隐藏指令

    它在你的电脑上运行;我们只能读取互联网端点的工具列表

已公开的漏洞(OSV.dev)

OSV.dev 中没有 @quackai/q402-mcp@0.11.34 的记录

只检查这个版本的包本身,不包括所有依赖 · 检查于 2026年11月15日

我们检查什么 → · JSON

作者:申请重新检查或报告信息错误
给作者:在 README 中加徽章

如果你是作者,可把这段代码贴到 README。徽章会链接回本页。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/quackai-org-q402-mcp.svg)](https://mcp.popnx.com/en/servers/quackai-org-q402-mcp)

讨论

提问、分享技巧或报告无法使用。按“有帮助”数量排序。

还没有帖子,欢迎第一个提问或分享。

此处内容由用户撰写,不代表 PopNx 团队。

登录后发帖

用户评价

还没有评价

登录后写评价

与“加密货币与区块链”中的其他服务器比较i

  • 星标数多于此分类中其他 1754 个服务器的 84%
  • 发布到注册中心的时间比此分类中其他 1754 个服务器的 77% 更新
  • 基础检查结果等于或优于此分类中其他 1754 个服务器的 99%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

Q402 MCP 安全吗?

它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

你需要填写:Q402_MULTICHAIN_API_KEY, Q402_PRIVATE_KEY, Q402_AGENTIC_PRIVATE_KEY, Q402_API_KEY

它在我的电脑上运行还是在云端?

它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。

它还在维护吗?

GitHub 仓库最后更新于15天前,最新版本(0.11.34)于15天前进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Node.js。

有什么可以替代它?

同一分类中有:DexSQL, PayRam, DexPaprika, Alchemy MCP Server, X402 List MCP

功能相近的其他选择

同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。

如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

DexSQL

SQL for Android APK and DEX files: classes, methods, strings, references and smali.

作者:LSPosed正在增长★ 31831天前更新

在你的电脑上运行✓ lsposed.org

PayRam

Install, configure, operate and integrate self-hosted PayRam crypto payment gateways.

作者:PayRam正在增长★ 15842天前更新

在云端运行✓ 服务方 · payram.com

DexPaprika

DEX and on-chain data: liquidity pools, token prices, swaps, and trading volume.

作者:coinpaprika正在增长★ 1215天前更新

在云端运行✓ 服务方 · dexpaprika.com

X402 List MCP

Find and vet x402 payment APIs before your agent pays one: uptime, price, on-chain volume.

作者:mcccsm起步阶段↓ 80/周★ 1839天前更新

电脑或云端✓ 服务方 · x402-list.com
与相似项目对比
本项
Q402 MCP
DexSQLPayRamDexPaprikaAlchemy MCP ServerX402 List MCP
运行位置需要安装在电脑上需要安装在电脑上在云端运行,无需安装在云端运行,无需安装在云端运行,无需安装云端或安装在电脑上都可以
需要密钥是否否否否否
可在 Claude 中按 + 添加否否否否否否
基础检查3/32/33/44/44/45/5
许可证Apache-2.0NOASSERTION–MITMITMIT
价格登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

@quackai/q402-mcp

MCP server for Q402 - gasless USDC, USDT, RLUSD, and USDG payments across 12 EVM chains (USDG on Robinhood Chain), callable from Claude (Desktop / Code), OpenAI Codex CLI, and any other Model Context Protocol client.

Free trial available. 500 gasless transactions on BNB Chain + Base (USDC + USDT), no card. One wallet signature: https://q402.quackai.ai.

Limited-time bonus: Mantle (USDC + USDT) is also covered by trial keys during 2026-08-21~08-28 UTC+9.

Trial-scope policy: API keys minted under the free-trial program (plan: "trial") settle on BNB Chain (USDC/USDT gasless) and Base (USDC/USDT gasless) as permanent chains. Avalanche trial has ended — use a Multichain key for avax. Mantle (USDC/USDT gasless) is covered during the limited-time window 2026-08-21~08-28 UTC+9 — server-side time enforcement, returns TRIAL_BNB_ONLY outside the window. Paid API keys see the full 12-chain matrix at all times.

Quote → route → (optional) settle stablecoin payments across 12 EVM chains, from any MCP client. Recipient gets the full amount; sender pays $0 gas via Q402's EIP-7702 relayer.


Quick start

  1. Register the server with your client (one-line per client).
  2. Say "Set up Q402" to your agent. It runs q402_doctor → creates ~/.q402/mcp.env → walks you through pasting keys.
1. Register the server
ClientCommand / config
Claude Code (CLI)claude mcp add q402 -- npx -y @quackai/q402-mcp
Claude Desktop (app)Edit claude_desktop_config.json (Settings → Developer → Edit Config): { "mcpServers": { "q402": { "command": "npx", "args": ["-y", "@quackai/q402-mcp"] } } }. Restart the app.
OpenAI Codex CLIcodex mcp add q402 -- npx -y @quackai/q402-mcp (Windows fallback: see below)
CursorAdd to ~/.cursor/mcp.json: { "mcpServers": { "q402": { "command": "npx", "args": ["-y", "@quackai/q402-mcp"] } } }
ClineCline → Settings → MCP Servers → Edit JSON. Same shape as Cursor.
GitHub Copilot (VS Code)Add to .vscode/mcp.json - root key is servers, not mcpServers: { "servers": { "q402": { "command": "npx", "args": ["-y", "@quackai/q402-mcp"] } } }. Reload VS Code, then enable q402 in the Copilot Chat tools picker.
Hermes Agent (Nous Research)YAML, not JSON. Add under mcp_servers in ~/.hermes/config.yaml (see below), then run /reload-mcp.
Any other stdio MCP clientPoint it at npx -y @quackai/q402-mcp. No client-specific code.

Hermes Agent - YAML config ( ~/.hermes/config.yaml )

Hermes reads MCP servers from ~/.hermes/config.yaml under mcp_servers (YAML, not JSON):

mcp_servers:

q402: command: "npx" args: ["-y", "@quackai/q402-mcp"] enabled: true

After editing, run /reload-mcp in Hermes to load the tools. Or use the CLI: hermes mcp add q402 --command npx --args -y @quackai/q402-mcp.

Claude Code (the CLI, claude binary) and Claude Desktop (the macOS / Windows app) are different products. The claude mcp add command only exists in the CLI; the Desktop app needs the JSON config above.

Secrets are NOT in this config. The server reads them from ~/.q402/mcp.env (same pattern as AWS / Stripe / gh CLIs).

Windows: codex mcp add returns "Access is denied"

Some Windows setups block codex.exe from writing its own config. Add the stanza to ~/.codex/config.toml by hand:

[mcp_servers.q402]

command = "npx" args = ["-y", "@quackai/q402-mcp"]

Then restart Codex. Same effect as codex mcp add q402 -- npx -y @quackai/q402-mcp.

2. First-time setup

Restart your client, ask: > *"Set up Q402"*

The agent runs q402_doctor. On first install:

  1. Creates ~/.q402/mcp.env (placeholders)
  2. Opens it in your editor
  3. Walks you through pasting an API key + a signing path into the file, not into chat
  4. Restart + re-run q402_doctor to verify

Keys never paste into chat. Local modes sign on your machine; the key never leaves the device. Mode C (server-managed) needs no PK on the client.

Pick a signing mode
ModeEnvSignerNotes
AQ402_PRIVATE_KEYMetaMask EOA, localSimplest. Shows "Smart account" after first use (reversible via q402_clear_delegation). After EIP-7702 delegation to an older implementation, q402_x402_fetch is unavailable until q402_clear_delegation is called (gasless, reversible; next q402_pay re-delegates). If delegated to the current ERC-1271-capable implementation, q402_x402_fetch works normally.
BQ402_AGENTIC_PRIVATE_KEYAgent Wallet, localExport PK from the dashboard → Wallets → Danger Zone → Export private key. MetaMask untouched.
C(just an API key)Agent Wallet, server-managedNo PK on the client. One-shot pays accept Trial or Multichain keys; recurring needs Multichain on every chain (BNB included).

When more than one mode is set, q402_pay asks the user which to use. Picker: walletMode = "agentic-server" \| "agentic-local" \| "eoa".

Manual setup (no AI)

Create ~/.q402/mcp.env yourself with the template below. Live mode only flips when an API key + a signing path are populated, so saving the template as-is stays in sandbox. Q402_ENABLE_REAL_PAYMENTS=0 forces sandbox even with real keys.

# ~/.q402/mcp.env

── API key (pick one or both for auto-routing) ──

Q402_TRIAL_API_KEY= # Free Trial, BNB (permanent) + Base (permanent) + Mantle limited-time (from /event) Q402_MULTICHAIN_API_KEY= # Paid Multichain, all 12 chains (from /payment)

── Signing path - pick ONE of Mode A / B / C ──

Mode A: your MetaMask EOA's hex private key.

Hardware wallets (Ledger / Trezor) are NOT supported here - Q402

needs a raw hex key it can sign EIP-7702 type-4 authorizations with.

Q402_PRIVATE_KEY=

Mode B: exported Agent Wallet pk from the dashboard. Keeps your

MetaMask untouched. Get it at:

https://q402.quackai.ai/dashboard → Agent tab → Export

Q402_AGENTIC_PRIVATE_KEY=

Mode C: no PK needed. A Trial key also enables Mode C one-shot payments;

leave both PK lines blank. Q402 signs with the server-managed Agent Wallet.

Multichain key required for recurring, Mode C batch, and bridge/OFT.

Optional: pin one of your Agent Wallets when you have multiple (max 10).

Q402_AGENT_WALLET_ADDRESS=0x...

Live mode switch:

0 = sandbox (test mode, no funds move)

1 = real on-chain payments

Default 1 - safe because mode only flips to live when an API key AND

at least one valid signing path (A/B/C) are populated above.

Q402_ENABLE_REAL_PAYMENTS=1

Default Q402 deployment. Only change for self-hosted.

Q402_RELAY_BASE_URL=https://q402.quackai.ai/api

Safety guards (max-amount ships uncommented at $200; lower for tighter caps):

Q402_MAX_AMOUNT_PER_CALL=200

Q402_ALLOWED_RECIPIENTS=0xabc...,0xdef...

Pre-check (automatic trust-check before outgoing payments in live mode).

Triggers when paying a first-time counterparty OR amount >= $1.

Fee: $0.02 per check; verdict cached 7 days (no repeat charge within TTL).

Set to 1 to disable pre-check entirely (even first-time / large-amount pays).

Q402_DISABLE_PRECHECK=0

Then chmod 600 ~/.q402/mcp.env (Unix) and restart your client. That's the full configuration. Heads up on the EIP-7702 side effect: after your first live payment on a chain, your wallet will show 'Smart account' in MetaMask / OKX - that's the delegation Q402 uses for gasless settlement, reversible anytime via q402_clear_delegation. Important for x402 users: if EIP-7702 delegation is active on an older implementation, q402_x402_fetch cannot sign x402 payments until you call q402_clear_delegation (gasless on Base, reversible — the next q402_pay re-delegates automatically). Wallets delegated to the current ERC-1271-capable implementation work normally.

Advanced - explicit env injection

If you'd rather skip the file and inject env vars yourself (e.g. via Codex env_vars allow-list, a secrets manager, or shell exports), the server falls through to process.env - and process.env wins over file values on conflicts. So existing shell-export setups keep working unchanged.

Codex env_vars allow-list example

[mcp_servers.q402]

command = "npx" args = ["-y", "@quackai/q402-mcp"] startup_timeout_sec = 20.0 env_vars = [ "Q402_TRIAL_API_KEY", "Q402_MULTICHAIN_API_KEY", "Q402_PRIVATE_KEY", "Q402_AGENTIC_PRIVATE_KEY", "Q402_AGENT_WALLET_ADDRESS", "Q402_ENABLE_REAL_PAYMENTS", "Q402_RELAY_BASE_URL", ]

Then export the values in ~/.zshrc / ~/.bashrc. See the Codex config reference for the full schema.

Try it without any setup

q402_quote works with zero configuration - no API key, no private key, no env file. Ask:

*"Compare gas costs to send 50 USDC to vitalik.eth across all 12 Q402 chains."*


Q402_RELAY_BASE_URL overrides the relay endpoint. Set it explicitly when running against a self-hosted Q402 deployment or a non-canonical environment.


Tools exposed

52 tools, grouped by capability. Read-only by default; live mode needs a live API key, a signing path, and Q402_ENABLE_REAL_PAYMENTS=1. Rows marked live mode move funds and need an explicit in-chat confirmation.

ToolAuthPurpose
Payments & wallet
q402_doctornoneFirst-install onboarding + ongoing health check (per-scope quota, EIP-7702 state, relay reachability, slot-mismatch warnings).
q402_quotenoneCompare gas + supported tokens across chains.
q402_balanceapi keyVerify key + remaining quota.
q402_paylive modeSingle-recipient gasless transfer. Sandbox by default. In live mode, automatically runs a trust-check ($0.02) on the recipient before each payment when it is a first-time counterparty or the amount ≥ $1; verdict cached 7 days (no double-charge within TTL). Degrades to free basic verdict only when wallet balance exactly covers the transfer but not the $0.02 fee, or when only a non-USDC rail token is available. Pre-check never blocks the main transaction. Disable with Q402_DISABLE_PRECHECK=1.
q402_batch_paylive modeUp to 20 recipients per call. Trial: 5 - applies when paying with your own key (Mode A/B); server-managed Agent Wallet (Mode C) batch is paid Multichain-only. Same auto-routing as q402_pay. 6+ BNB batches with Trial set return status="ambiguous" so the agent asks how to split. xlayer + stable not batchable - use q402_pay in a loop.
q402_receiptnoneFetch + locally verify a Trust Receipt (rct_… id, ECDSA against the relayer EOA).
q402_wallet_statusprivate keyPer-chain EIP-7702 state for the EOA derived from Q402_PRIVATE_KEY.
q402_clear_delegationprivate key / api keyClear EIP-7702 delegation (Mode A/B local key OR Mode C api key, server-signed). Sponsored on every chain except Ethereum (billed to your Gas Tank). Two-phase consent (consentToken).
q402_agentic_infoapi keyAgent Wallet info (addresses, per-wallet caps, daily-spend used, ERC-8004 id). Drives Mode C.
Treasury memory
q402_memory_summaryapi keyTreasury overview over a window: USD-stablecoin spend by chain/source, top vendors, schedules, open requests/escrow, failures. Read-only.
q402_vendor_historyapi keyTotal paid to one vendor (or a vendor leaderboard) with recurring cadence. Read-only.

| q402_agent_spend_report | api ke

只显示了开头部分;其余内容请在仓库中阅读