Spraay X402 Mcp Server

💧 Spraay x402 MCP Server

面向 AI Agent 的全栈 DeFi 基础设施——183 个按次付费工具，由 Base 上的 192 个端点 Spraay x402 Gateway 提供支持，并支持 Solana、Ethereum、XRP 和 Stellar 支付通道。

将 Claude、Cursor 或任何 MCP 客户端连接到链上支付、批量付款、兑换、跨链桥接、薪资发放、开票、托管、预言机数据、分析、200 多种 AI 模型、GPU/计算、研究 API、搜索/RAG 等功能。Agent 通过 x402 protocol 按请求支付 USDC——无需 API 密钥或账户。

工具列表会在构建时根据实时网关清单生成 （npm run sync），因此权威目录和定价始终以网关为准——请参阅工具目录。网关的 24 个端点免费（无需付款）。

---

快速开始

安装后即可使用——无需配置、API 密钥或环境变量。 首次运行时，服务 会自动创建钱包，将其保存到 ~/.spraay/.session，并将地址输出到 stderr。 向该地址存入 Base 上的 USDC，即可开始调用工具。

请阅读安全与钱包安全——这些工具会转移 真实资金。

一键安装（Claude Code）

claude mcp add spraay -s user -- npx -y spraay-x402-mcp

手动配置（Cursor / Claude Desktop）

Cursor（.cursor/mcp.json）或 Claude Desktop（claude_desktop_config.json）：

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

就是这么简单。首次运行时会输出类似内容：

💧 Spraay created a new wallet: 0xABC…123
   Private key saved to ~/.spraay/.session (keep it safe — it controls funds).
   Fund this address with USDC on Base to start paying for tool calls.

可选——使用自己的钱包

若要使用自己掌控的密钥签名，而不是自动创建的钱包，请在环境中设置 EVM_PRIVATE_KEY（它会覆盖会话钱包）。 切勿将原始密钥粘贴到已提交的配置文件中——请使用专用热钱包， 并且仅存入 Agent 可使用的资金。请参阅 安全与钱包安全。

远程 URL（本机无需钱包）

结算由网关端处理；客户端不会持有签名密钥。

{
  "mcpServers": {
    "spraay": {
      "url": "https://spraay-x402-mcp--plagtech.run.tools"
    }
  }
}

Smithery

smithery mcp add Plagtech/Spraay-x402-mcp

从源码安装

git clone https://github.com/plagtech/spraay-x402-mcp
cd spraay-x402-mcp
npm install
npm run build
npm start                     # auto-creates a wallet on first run

---

工具目录

183 个工具，涵盖网关的 33 个类别。各领域亮点：

领域	涵盖内容
AI 与推理	200+ 个大模型（兼容 OpenAI）、钱包/交易分类、合约说明、摘要
计算	通过 Replicate、Chutes、OpenRouter 提供文本/图像/视频/TTS/STT/嵌入；批处理任务
计算期货	预付计算额度，享受阶梯折扣；按每次推理扣减
Bittensor	通过 SN64 / SN19 提供去中心化推理、图像生成和嵌入
支付	最多向 200 个收款人批量付款（Base、XRP Ledger、Stellar）；费用估算
薪资	在 Base、Ethereum、Solana 上执行稳定币薪资发放
开票与托管	加密货币原生发票和里程碑托管（持久化）
DeFi 与数据	兑换（Uniswap V3 / Aerodrome）、预言机价格/燃料费/外汇、跨链桥报价、余额、ENS/Basename
分析	钱包档案和解码后的交易历史
研究	2.5 亿+ 篇论文（OpenAlex）、arXiv、Crossref、PubMed、PubChem、美国人口普查、词典
搜索与 RAG	网页搜索、内容提取、问答
通信	电子邮件、短信、XMTP 消息、webhook
基础设施	多链 RPC、IPFS/Arweave 存储、cron 调度、结构化日志
身份与合规	KYC/制裁筛查、身份验证会话、审计跟踪、加密货币税务（FIFO、IRS 8949）
供应链（SCTP）	供应商注册、采购订单、发票验证、结算
机器人（RTP）	注册机器人、派发付费任务、由托管保障任务完成
信任与安全	ProofLayer 信任评分；免费的代币安全性、地址安全性和交易解码检查

24 个免费端点无需付款——燃料费/价格/链状态、地址和批量验证、ENS 解析、单位转换、x402 发现探测，以及模型/计算发现。

如需获取准确的最新工具列表及每个工具的定价，请查询实时清单：

curl https://gateway.spraay.app/.well-known/x402.json

价格从 $0.001（读取）到约 $0.10（薪资发放、托管释放、税务），以 Base 上的 USDC 结算。

---

工作原理

1. Agent 调用工具（例如 spraay_batch_execute）。
2. MCP 服务访问 Spraay x402 Gateway。
3. 网关返回 402 Payment Required，并附上 USDC 金额。
4. **远程模式：**结算由网关侧处理。 本地模式：@x402/axios 使用自动创建的钱包（或替换后的钱包）签署 USDC 微支付。
5. 网关验证付款并返回数据。

---

安全与钱包安全

这些工具可以发起真实的 USDC 付款。请像对待任何可访问资金的工具一样对待此服务。

• **自动创建的钱包中只会存放你转入的资金。**只向其中转入你愿意让 Agent 使用的 USDC 数量。钱包初始为空，因此在转入资金之前，全新安装无法转移资金；只读工具不受影响。
• **会话密钥存放在 ~/.spraay/.session。**请像保护任何秘密信息一样保护此文件——任何读取该文件的人都能控制此钱包。在 POSIX 系统上，该文件以 0600 权限写入。如果资金很重要，请备份此文件；删除该文件后，下次运行时会换用新钱包。
• 如果你不想在自己的设备上保留签名密钥，请优先使用远程 URL——结算由网关侧处理。
• 如果通过 EVM_PRIVATE_KEY 使用自己的密钥，请使用不控制任何其他资产的专用热钱包，并且切勿将原始私钥放入配置文件、问题单或任何已提交的文件中——仅将其保存在 shell 环境中。

发布的 npm 包只包含 dist/、README 和 LICENSE（使用 npm pack --dry-run 验证）——不含二进制文件、构建工具或安装脚本。

请将安全问题报告至 [email protected]，不要提交公开问题单。

---

要求

• Node.js 20+
• MCP 客户端——Claude Desktop、Cursor 或任何兼容 MCP 的客户端
• Base 上的 USDC——为自动创建的钱包（或你自己的钱包）转入资金；即使 $1 也足以支付数千次调用

环境变量

无需配置任何变量——服务无需任何配置即可运行。以下变量均为可选覆盖项。

变量	必需	默认值	说明
EVM_PRIVATE_KEY	否	在 ~/.spraay/.session 自动创建	使用你自己的密钥替换自动创建的钱包。请使用专用、按需注资的热钱包。
SPRAAY_GATEWAY_URL	否	https://gateway.spraay.app	覆盖网关 URL。

---

链接

• MCP 服务： mcp.spraay.app
• 网关： gateway.spraay.app
• 清单： gateway.spraay.app/.well-known/x402.json
• Smithery： smithery.ai/servers/Plagtech/Spraay-x402-mcp
• x402： x402.org

许可证

MIT