x402 Seller

本地服务

x402-seller-0ay3.onrender.com金融数据08 周前更新

关于 x402 Seller

x402 Seller 将 x402-seller 的付费端点提供为 MCP 工具，供 Agent 获取加密货币、DeFi、链上读取、网页阅读和 AI 文本任务。可先在说明模式下查看付款要求，配置钱包后则通过 Base 上的 x402 自动支付。

主要功能

01从发现文档动态生成工具
02覆盖加密货币与 DeFi 数据
03支持网页阅读和 AI 文本任务
04无钱包时说明付款要求
05配置钱包后自动支付

适用场景

01通过 Agent 查询付费加密货币数据
02了解工具调用所需的付款条件
03使用 USDC 在 Base 上自动结算调用

MCP 相关

MCP 服务将来源端点发现文档中的每个付费资源映射为工具。未配置钱包时返回付款说明；配置 `BUYER_PRIVATE_KEY` 后通过 x402 支付并返回结果及结算凭据。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "entreprisedaney33-rgb-x402-seller": {
      "command": "npx",
      "args": [
        "-y",
        "x402-seller-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
        "X402_ORIGIN": "<X402_ORIGIN>"
      }
    }
  }
}

启动命令npx -y x402-seller-mcp

需要配置的环境变量

BUYER_PRIVATE_KEY密钥EVM private key (0x...) of a throwaway wallet funded with a small amount of USDC on Base. Leave unset for explain-only mode (tool calls describe the 402 payment challenge instead of paying).

X402_ORIGINWhich x402-compatible server to expose as MCP tools.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmx402-seller-mcp0.1.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

x402-seller-mcp

一个 MCP 服务，可将 x402-seller 的所有付费端点——加密货币价格、DeFi 数据、链上读取、网页阅读、由 Claude 驱动的文本任务——转换为 Agent 可调用的工具（适用于 Claude Desktop、Cursor 或任何 MCP 客户端）。

工具会在启动时根据服务自身的 /.well-known/x402.json 发现文档生成，而不是手动列出，因此工具列表始终与源站实际提供的内容一致。

两种模式

未配置钱包（默认）——调用工具时会请求端点，获取实际的 402 Payment Required 挑战，并返回通俗易懂的说明（价格、网络、如何启用付款），而不是实际数据。无需任何设置即可安全试用。
已配置钱包（已设置 BUYER_PRIVATE_KEY）——调用会通过 x402（借助 @x402/fetch）自动付费，并返回实际结果以及结算凭证（付款方地址、交易哈希）。

安装

npx x402-seller-mcp

安装就这么简单——在仅说明模式下试用，无需克隆、构建或配置任何内容。

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "x402-seller": {
      "command": "npx",
      "args": ["-y", "x402-seller-mcp"]
    }
  }
}

若要启用自动付款，请添加 env 块（参见下文的启用付款）：

{
  "mcpServers": {
    "x402-seller": {
      "command": "npx",
      "args": ["-y", "x402-seller-mcp"],
      "env": {
        "BUYER_PRIVATE_KEY": "0x..."
      }
    }
  }
}

编辑配置后，重启 Claude Desktop。

Cursor

Cursor 使用相同的 mcpServers 结构——将相同的代码块添加到 ~/.cursor/mcp.json（或项目的 .cursor/mcp.json），然后从 Settings → MCP 重新加载 MCP 服务。

启用付款

⚠️ 请使用专用临时钱包，切勿使用持有大量资金的钱包。 你在此处设置的私钥可以在 Base 上签署 USDC 转账，金额上限为每次工具调用的价格（此服务上的所有端点每次调用收费 $0.005–$0.02）——但原则上，任何能在其环境中访问该密钥的进程都可以使用它。请为此 MCP 服务生成一个新钱包，并在 Base 上存入几美元的 USDC，不要存入更多。

生成钱包（任何 EVM 钱包均可——例如使用 viem：node -e "const {generatePrivateKey,privateKeyToAccount}=require('viem/accounts');const k=generatePrivateKey();console.log(k, privateKeyToAccount(k).address)"，或通过 MetaMask / 任意钱包应用导出）。
向该钱包地址发送少量 Base 上的 USDC（此服务使用的结算网络）——按当前价格，几美元足以支付数百次调用。
在 MCP 客户端配置中（参见上面的示例）或直接运行服务时的 Shell 环境中，将 BUYER_PRIVATE_KEY 设置为该钱包的私钥（以 0x... 为前缀的十六进制字符串）。
重启 MCP 服务（或 MCP 客户端）。之后，工具调用便会自动付款并返回实际结果。

配置

环境变量	必填	默认值	用途
`BUYER_PRIVATE_KEY`	否	(未设置)	用于支付工具调用费用的 EVM 私钥。未设置时 = 仅说明模式。
`X402_ORIGIN`	否	`https://x402-seller-0ay3.onrender.com`	要作为工具提供的 x402 服务；如有需要，可将其指向其他兼容 x402 的服务（或本地开发实例）。

工具

源站发现文档中的每个付费资源对应一个工具，命名为 <method>_<path>（例如 get_api_gas_base、post_api_web_read）。运行服务并调用 tools/list，或直接查看 /.well-known/x402.json，即可获取当前完整列表和每个工具的输入架构。这里特意不重复列出这些信息，以免与源站的实时内容不一致。

开发

git clone https://github.com/entreprisedaney33-rgb/x402-seller.git
cd x402-seller/mcp
npm install
node server.js          # runs on stdio, waits for a client

test/manual-test.mjs 是一个独立测试脚本，它会像 MCP 客户端那样（通过 StdioClientTransport）启动服务，并使用官方 Client 类调用 listTools()，然后以两种模式调用 callTool()。运行 npm install 后，可直接通过 node test/manual-test.mjs 运行（如果父级仓库的 .env 中存在 BUYER_PRIVATE_KEY，脚本会读取该变量，以便测试付费路径）。