Speccy x402 MCP

@speccy-agent/x402-mcp

封装 Speccy 付费 x402 端点的 MCP 服务。为任何兼容 MCP 的 AI Agent 提供五种超能力工具——预测市场数据、沙盒化 Python 执行器、FFmpeg 媒体转换、实时网页搜索和多语言文本转语音；该服务会代表你按次使用 USDC 在 Base 上付款。

Agent 无需了解 x402。Agent 端无需设置钱包。只需安装服务并将 Agent 指向它，即可开始使用。

工具

工具	描述	每次调用的费用
get_prediction_markets	Polymarket 热门预测市场（按交易量、流动性或 startDate 排序）	$0.01 USDC
exec_python	在隔离的 Docker 沙盒中运行 Python 3.12 代码（无网络、只读文件系统、30 秒超时、输出上限为 64KB）	$0.02 USDC
transform_media	对视频／音频文件运行 FFmpeg（3 个级别：copy $0.005、transform $0.05、heavy $0.20）	$0.005–$0.20 USDC
web_search	通过 Tavily 实时网页搜索和提取（3 种模式：搜索 $0.005、提取 $0.02、智能搜索和提取 $0.05）	$0.005–$0.05 USDC
tts_synthesize	通过 Supertonic 3 进行多语言文本转语音（31 种语言、10 种语音、44.1 kHz WAV）。tts 级别（≤200 个字符）和 tts-long 级别（≤5000 个字符，自动分块）	$0.005–$0.02 USDC

安装

npm install -g @speccy-agent/x402-mcp

配置

设置运营方钱包密钥（该钱包负责为每次调用支付 x402 费用）：

export SPECCY_MCP_WALLET_KEY="0x..."   # operator wallet private key

可选覆盖项：

• SPECCY_MCP_API_BASE（默认值为 https://api.speccy.cloud）——Polymarket 端点
• SPECCY_MCP_EXEC_BASE（默认值为 https://exec.speccy.cloud）——沙盒执行端点
• SPECCY_MCP_AUDIO_BASE（默认值为 https://audio.speccy.cloud）——Supertonic TTS 端点

接入兼容 MCP 的 Agent

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "speccy-x402": {
      "command": "speccy-x402-mcp",
      "env": { "SPECCY_MCP_WALLET_KEY": "0x..." }
    }
  }
}

任何 MCP 客户端（stdio）：

SPECCY_MCP_WALLET_KEY=0x... speccy-x402-mcp

架构

[Agent] → MCP tool call (stdio) → [this server] → x402 paid fetch → [Speccy endpoint on VPS]
                                                                → [CDP facilitator] → on-chain USDC transfer

服务持有一个运营方钱包。每次调用都会触发从该钱包支付 x402 费用。结算提醒会通过 Notifier 机器人发送到运营方的 Telegram（与 HTTP 端点使用同一后端）。

说明

• 钱包密钥不会离开运营方的机器（存储在环境变量中，而非配置文件中）。
• 请为钱包充值 Base 主网上的 USDC（eip155:8453）和少量 ETH 作为备用金（仅当钱包进行非 x402 转账时才会使用）。
• 目前仅在 Base 主网上结算。要使用测试网或其他链，需要设置 X402_NETWORK 环境变量并配置匹配的 facilitator。
• 每次调用都是独立且无状态的——没有会话，服务端也不保存状态。

源码／问题反馈

• 源码：github.com/speccy-ai/x402-mcp（占位链接）
• 问题／功能请求：在代码仓库中提交 issue，或通过 Telegram 联系 @SpeccyNotifierbot

许可证

MIT——Philip（Esla）为 Speccy 创作。