使用说明
💧 Spray x402 MCP服务器
用于AI代理的全栈DeFi基础设施——183个按呼叫付费工具,由Base上的192个端点Spray x402网关支持,具有Solana、以太坊、XRP和Stellar支付轨道。
将Claude、Cursor或任何MCP客户端连接到链上支付、批量支付、, 交换、桥接、工资单、发票、托管、oracle数据、分析、200+AI 模型、GPU/计算、研究API、搜索/RAG等。代理人支付USDC 通过请求 x402协议 -没有API密钥,没有帐户。
工具列表是在构建时从实时网关清单生成的 (
npm run sync),因此权威的目录和定价始终在 网关--请参阅 刀具目录网关的24个端点是 自由 (无需付款)。
快速开始
安装并运行-- 没有配置,没有API密钥,没有env变量。 第一次运行时
服务器自动创建钱包,并将其保存到 ~/.spraay/.session,并打印
stderr的地址。在Base上用USDC为该地址充值,并开始调用工具。
阅读 安全和钱包安全 --这些工具移动 真正的资金。
单线安装(克劳德代码)
claude mcp add spraay -s user -- npx -y spraay-x402-mcp
手动配置(光标/克劳德桌面)
光标 (.cursor/mcp.json)或 克劳德桌面版 (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 在您的环境中(它会覆盖会话钱包)。
切勿将原始密钥粘贴到已提交的配置文件中 --使用专用热
钱包只能用代理人可能花的钱来支付。看
安全和钱包安全.
远程URL(您的计算机上没有钱包)
结算由网关端处理;你的客户永远不会持有签名密钥。
{
"mcpServers": {
"spraay": {
"url": "https://spraay-x402-mcp--plagtech.run.tools"
}
}
}
史密瑟里
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个类别。按地区划分的亮点:
| 区域 | 它涵盖了什么 |
|---|---|
| 人工智能与推理 | 200+LLM(兼容OpenAI)、钱包/tx分类、合约解释、摘要 |
| 计算 | 跨复制、滑槽、OpenRouter的文本/图像/视频/TTS/STT/嵌入;批处理作业 |
| 计算期货 | 预付计算积分,享受等级折扣;根据推论得出结论 |
| 比特张量 | 通过SN64/SN19进行去中心化推理、图像生成和嵌入 |
| 支付 | 批量支付最多200名收款人(Base、XRP Ledger、Stellar);估计数 |
| 工资单 | Stablecoin工资单在Base、以太坊和Solana上运行 |
| 发票和托管 | 加密原生发票和里程碑托管(持久) |
| DeFi和数据 | 掉期(Uniswap V3/机场)、甲骨文价格/天然气/外汇、过桥报价、余额、ENS/Basename |
| 分析 | 钱包配置文件和解码的交易历史 |
| 研究 | 超过2.5亿篇论文(OpenAlex)、arXiv、Crossref、PubMed、PubChem、美国人口普查、词典 |
| 搜索和RAG | 网络搜索、内容提取、问答 |
| 沟通 | 电子邮件、短信、XMTP消息、webhooks |
| 基础设施 | 多链RPC、IPFS/Arweave存储、cron调度、结构化日志 |
| 身份与合规 | KYC/制裁筛选、认证会议、审计跟踪、加密税(FIFO、IRS 8949) |
| 供应链(SCTP) | 供应商注册、采购订单、发票验证、结算 |
| 机器人(RTP) | 注册机器人、分派付费任务、托管支持的完成 |
| 信任与安全 | ProofLayer信任评分;免费令牌安全、地址安全和tx解码检查 |
24个免费端点 无需付款——天然气/价格/供应链状态、地址& 批验证、ENS分辨率、单位转换、x402发现探针,以及 模型/计算发现。
有关准确的当前工具列表和每个工具的定价,请查询实时清单:
curl https://gateway.spraay.app/.well-known/x402.json
定价范围从0.001美元(读取)到0.10美元(工资、托管释放、税款), 以美元结算。
运作原理
- 代理调用工具(例如。
spraay_batch_execute). - MCP服务器点击 Spray x402网关.
- 网关响应
402 Payment Required金额为USDC。 - 远程模式: 结算由网关端处理。
本地模式:
@x402/axios签署自动创建的USDC小额支付 (或覆盖)钱包。 - 网关验证支付并返回数据。
安全和钱包安全
这些工具可以启动 实际美元支付.像对待任何工具一样对待服务器 有资金准入。
- 自动创建的钱包只保存您发送的内容。 仅用以下方式为其提供资金 你愿意让代理人花多少美元。它开始是空的,所以很新鲜 安装在您为其提供资金之前无法移动资金;只读工具无论如何都能工作。
- 会议密钥位于
~/.spraay/.session. 像保护任何文件一样保护该文件 秘密——任何读到它的人都控制着钱包。它是用0600POSIX系统上的权限。如果资金很重要,请备份它;删除它 下次运行时转到新钱包。 - 首选远程URL 如果你不想在你的机器上保留签名密钥-- 结算由网关端处理。
- 如果您通过以下方式携带自己的钥匙
EVM_PRIVATE_KEY,使用a 专用热钱包 不控制其他资产,以及 从不 将原始私钥放入配置中 文件、问题或任何已提交的文件——仅将其保存在shell环境中。
已发布的npm包仅提供 dist/, README,以及 LICENSE (验证
随着 npm pack --dry-run)--没有二进制文件,没有构建工具,没有安装脚本。
向报告安全问题 security@spraay.app,不是公共问题。
需求
- Node.js 20+
- MCP客户端 --Claude Desktop、Cursor或任何兼容MCP的客户端
- 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/.nearned/x402.json
- 史密斯利: smithery.ai/servers/Plagtech/Spray-x402-mcp
- x402: x402.org
许可证
麻省理工学院
