Softbot Studio agent tools

softbot-mcp

适用于 Softbot Studio 按次付费 Agent 工具的 MCP 服务。每次调用均通过 x402 使用 Solana 主网上的 USDC 直接从你自己的钱包支付。无需账户或 API 密钥，调用失败不收费。

工具	功能	价格（USDC）
read_url	将网页转换为简洁的 Markdown，并附带元数据	0.003
extract_structured	提取表格、JSON-LD、联系人、链接和 CSS 选择器字段	0.004
check_solana_token	代币安全判定（安全／谨慎／避免）	0.01
check_email	检查电子邮件的可送达性、是否为一次性邮箱及拼写错误	0.002
check_domain	检查邮件域名（MX、SPF/DMARC/DKIM、注册时间）	0.002
check_wallet	Solana 钱包资料及 OFAC 匹配检查	0.005
check_website	检查网站可信度、钓鱼风险及仿冒情况	0.003
screenshot_url	网页截图（以 MCP 图片形式返回）	0.01
page_to_pdf	将网页转换为 A4 PDF（嵌入式资源）	0.01
softbot_status	会话支出、预算和钱包信息（免费）	0

所有付费工具都接受 dry_run: true，并返回价格和端点，但不会扣款。

免费试用

每个钱包使用每种工具的前 3 次调用均免费。服务会使用你的密钥自动为 x402 sign-in-with-x 挑战签名（仅签名，不会转移资金），试用次数用完后再正常付款。结果中会显示 free_trial 和 trial_remaining。设置 SOFTBOT_NO_TRIAL=1 可始终付费。

配置（环境变量）

• SOLANA_PRIVATE_KEY（付费调用必需）是持有少量 USDC 的钱包密钥对（无需 SOL，因为 Facilitator 会支付网络费用）。支持 base58 格式或 solana-keygen 生成的 JSON 字节数组。请使用余额较低的专用钱包。
• MAX_SPEND_USDC 是每个会话的预算。默认值为 0.25，超出预算的调用会被拒绝。
• SOFTBOT_DRY_RUN=1 会让所有工具仅返回价格，不执行付费操作。
• SOLANA_RPC_URL 为可选项，默认使用公共主网 RPC。

Claude Desktop

claude_desktop_config.json：

{
  "mcpServers": {
    "softbot": {
      "command": "npx",
      "args": ["-y", "softbot-mcp"],
      "env": { "SOLANA_PRIVATE_KEY": "<base58 or [..] key>", "MAX_SPEND_USDC": "0.25" }
    }
  }
}

Cursor

~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "softbot": {
      "command": "npx",
      "args": ["-y", "softbot-mcp"],
      "env": { "SOLANA_PRIVATE_KEY": "<base58 or [..] key>", "MAX_SPEND_USDC": "0.25" }
    }
  }
}

安全

• 密钥仅在本地用于为 x402 USDC 转账签名，绝不会被记录日志或发送到任何地方。
• 如果服务请求的金额超过标示价格，或请求支付的资产不是 USDC，客户端会拒绝付款。
• 服务进程重启时，预算会重置。

开发

npm install && npm run build
node test/smoke.mjs          # list tools + dry run each
SOLANA_PRIVATE_KEY=... node test/smoke.mjs paid   # one $0.002 check_domain call

采用 MIT 许可证。