ScalpStream Data

ScalpStream MCP 服务

适用于 Claude Desktop、Claude Code、Cursor 和任何 MCP 客户端的按次付费 MCP 服务：美国商品召回、美国边境等待时间和最低燃油价格，通过 Base 上的 x402 使用 USDC 结算。

这是一个 MCP 服务，使用你自己的钱包，通过 x402 在调用时购买小型事实数据集——每次调用约 $0.01，整个流程无需账户、订阅或 API 密钥。

大多数 MCP 服务都封装了一个你已有密钥的 API。这个服务则按需付费。卖家也不持有任何密钥：结算通过赞助 Gas 费的促进方完成，因此系统中唯一的密钥就是你的密钥；它只在进程的生命周期内保存在内存中，绝不会写入任何位置。

即使尚未充值，它也有用。 未配置密钥时，每个付费工具都会返回免费预览和确切报价，让你在决定购买前了解将要购买的内容。

工具

工具	可获取内容
product_recalls	通过一次查询，查找 FDA、NHTSA 和 CPSC 发布的针对产品、品牌、成分或车辆的有效美国召回信息，其中包括统一到同一标准的严重程度、危害、补救措施，以及用于判断特定商品是否受影响的批次号。
border_crossings	按总用时对美国入境口岸排名，即驾车时间加当前 CBP 等待时间，并按车道类型分类。最近的口岸往往不是最快的。
cheapest_fuel	按地点和燃油等级查询最低价格。西班牙、法国和意大利提供加油站级数据；美国提供官方区域平均价格。
air_quality	查询全球任意地点的当前 AQI 和污染物、基于 EPA 标准的户外运动建议，以及未来空气最清洁的时段。
payment_status	查看已配置的内容和已花费金额。不发起网络调用，也不产生费用。

已撤下的工具列于 版本下。

安装

Docker（无需工具链）

已发布的镜像为 ghcr.io/dv1-321/scalpstream-mcp。它以非 root 用户身份运行在不含 Shell 的基础镜像上，并通过 stdin/stdout 使用 MCP，因此只需要 -i：

docker run -i --rm ghcr.io/dv1-321/scalpstream-mcp:latest

Claude Desktop（claude_desktop_config.json）或任何支持命令配置的 MCP 客户端，仅预览模式：

{
  "mcpServers": {
    "scalpstream": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/dv1-321/scalpstream-mcp:latest"]
    }
  }
}

Claude Code：

claude mcp add scalpstream -- docker run -i --rm ghcr.io/dv1-321/scalpstream-mcp:latest

要启用付费调用，请将密钥放入客户端的 env 块中，并使用裸 -e NAME 转发——只传入名称，这样密钥值就不会出现在命令行中：

{
  "mcpServers": {
    "scalpstream": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "EVM_BASE_PRIVATE_KEY", "-e", "SCALPMCP_BUDGET_USD",
               "ghcr.io/dv1-321/scalpstream-mcp:latest"],
      "env": {
        "EVM_BASE_PRIVATE_KEY": "0x...",
        "SCALPMCP_BUDGET_USD": "2.00"
      }
    }
  }
}

每个版本也都带有标签（如 :v0.1.9），供需要固定版本的安装使用；MCP 注册表条目会固定到确切的标签。

Claude Code 也可以将其作为插件使用。插件会安装相同的 Docker 命令，无需配置密钥，并附带 scalpstream-data 技能：

/plugin marketplace add DV1-321/scalpstream-mcp
/plugin install scalpstream@scalpstream-mcp

Gemini CLI 会读取本仓库根目录下的 gemini-extension.json：

gemini extensions install https://github.com/DV1-321/scalpstream-mcp

两者都会固定版本标签并以仅预览模式启动。要启用付费功能，请按上述说明将密钥添加到已安装服务的 env 中；切勿将密钥添加到清单中。

Go

go install github.com/DV1-321/scalpstream-mcp/cmd/scalpmcp@latest

这会将 scalpmcp 放入 $(go env GOPATH)/bin：

{
  "mcpServers": {
    "scalpstream": {
      "command": "scalpmcp",
      "env": {
        "EVM_BASE_PRIVATE_KEY": "0x...",
        "SCALPMCP_MAX_PRICE_USD": "0.10",
        "SCALPMCP_BUDGET_USD": "2.00"
      }
    }
  }
}

完全省略 env 即可在仅预览模式下运行。

配置

变量	默认值	说明
EVM_BASE_PRIVATE_KEY	(未设置)	持有少量 USDC 的 Base 主网密钥。未设置 = 仅预览模式。
SCALPMCP_MAX_PRICE_USD	0.10	拒绝任何报价超过此金额的单次调用。
SCALPMCP_BUDGET_USD	2.00	进程累计花费达到此金额后拒绝调用。
SCALPMCP_FUEL_URL、_BORDER_URL、_RECALL_URL	在线服务	覆盖服务源地址，以便针对模拟服务进行测试。

无需加密钱包即可付款

相同的数据也通过 Apify Actor 提供，费用从你的 Apify 套餐中扣除，而非钱包。Apify 托管的 MCP 服务可将任何 Actor 作为工具公开，因此无法持有密钥的 MCP 客户端也能通过 Apify 账户获取相同的查询结果：

数据	Apify MCP 链接
燃油价格	https://mcp.apify.com?tools=rolescout/fuelscout-cheapest-fuel-prices
美国边境等待时间	https://mcp.apify.com?tools=rolescout/borderscout-us-border-wait-times
美国商品召回信息	https://mcp.apify.com?tools=rolescout/recallscout-us-product-recalls

这些链接使用你的 Apify 账户进行身份验证；此服务与它们无关，也绝不会需要你的 Apify 令牌。

预览模式示例

截取自未使用密钥时运行的镜像。payment_status 是本地数据：

{
  "paid": false,
  "complete": true,
  "source": "local",
  "data": {
    "paid_mode_enabled": false,
    "paid_calls": 0,
    "spent_atomic_usdc": "0",
    "price_per_call": "$0.01 USDC",
    "rails": ["USDC on Base (used by this client)", "USDC on Arbitrum", "USDC on Polygon", "USDC on Solana", "XRP on XRPL", "RLUSD on XRPL"],
    "custody": "The seller holds no keys. This client signs with your own Base key, held only in memory for the process lifetime.",
    "how_to_enable": "Ask the user to add EVM_BASE_PRIVATE_KEY ... to the MCP server's environment ... Never request, accept or echo the key in chat. ..."
  }
}

使用 {"product": "infant formula"} 调用 product_recalls 且不提供密钥时，返回结果为 paid: false, complete: false，服务会在 data 下返回免费预览，并在 price 下返回报价——这是预期结果，并非错误：

{
  "paid": false,
  "complete": false,
  "source": "https://recallscout.scalpstream.com/preview",
  "reason": "no spending key configured (set EVM_BASE_PRIVATE_KEY in the MCP server's environment to enable paid calls)",
  "price": { "network": "eip155:8453", "amount_usd": "0.0100", "amount_atomic": "10000", "asset": "0x8335...2913", "pay_to": "0x..." },
  "note": "This is the FREE PREVIEW, not the paid dataset. The paid call returns the full result described by this tool.",
  "howto": "Ask the user to add EVM_BASE_PRIVATE_KEY ... Never request, accept or echo the key in chat. ...",
  "data": {
    "service": "RecallScout",
    "what": "Machine-payable US recall lookups across three regulators at once: FDA (food, drugs, medical devices), NHTSA (vehicles) and CPSC (consumer products). ...",
    "parameters": { "product": "product, brand or ingredient — matched as a phrase across FDA and CPSC", "make": "...", "model": "...", "year": "...", "include_ended": "...", "limit": "..." },
    "honesty": "If an agency cannot be reached the response says so in sources_failed and sets complete=false. A lookup that could not consult all three is never reported as an all-clear.",
    "source": "US FDA (openFDA enforcement), US NHTSA (vehicle safety recalls), US CPSC (saferproducts.gov). Public domain / US Government works.",
    "disclaimer": "..."
  }
}

使用密钥时，相同的调用会返回 paid: true, complete: true，并在 data 下返回召回列表。所有工具都使用这一种响应封装；应根据 complete 字段决定后续操作。

支出安全

这涉及真实资金，因此设计上宁可拒绝，也不超支：

• 签署任何内容之前都会检查两项限额。 拒绝请求不产生费用，也不会访问网络。
• 未设置限额时使用默认值，绝不视为“无限额”。 缺少配置行不能导致支出不受限制。
• 只有在实际交付数据时才记录支出。 如果付费请求随后失败，错误会说明结算状态未知，而不会暗示资金未发生变动——你可能需要对照链上记录进行核对。
• **Gas 费由 facilitator 代付，**因此钱包需要 USDC，而不需要 ETH。

请使用只存入一两美元的临时密钥。不要使用存有你在意余额的密钥，也不要将密钥交给托管服务——只有此服务应持有它，并且也仅在内存中持有。

身份标识、速率限制和日志记录

此服务发出的每个请求都会携带标头 User-Agent: scalpmcp/<version> (+https://github.com/DV1-321/scalpstream-mcp)， 无论是未付费请求还是付费重试都如此。它标明程序及其版本，不包含任何与你有关的信息。

每个 ScalpStream 主机都会对每个 User-Agent 实施每分钟 60 个请求的边缘速率限制。此服务的每个安装实例都会发送相同的 User-Agent，因此在每台主机上，所有安装实例共用这一限额。每次工具调用仅发出一个请求，远高于 Agent 的正常使用量；收到 429 表示这一分钟内的共享限额已被占满，并非你的密钥或预算出了问题。

每次工具调用都会向 stderr 写入一行——包括工具名称、是否付费、结果是完整数据还是预览、最后一个 HTTP 状态码以及经过的毫秒数，例如 scalpmcp: call tool=border_crossings paid=true complete=true status=200 ms=412 error=false。 日志绝不会记录参数值、支出密钥或付款载荷。

协议

通过 stdio 使用 MCP 2025-06-18。如果客户端首先发出 2026-07-28 的 server/discover 调用，会收到 JSON-RPC -32601（找不到方法）；这是该版本要求回退到 initialize 的信号，随后服务会协商使用 2025-06-18。

支付渠道

卖家接受 Base、Arbitrum、Polygon 和 Solana 上的 USDC，以及 XRP Ledger 上的 XRP 或 RLUSD。此客户端使用 Base 上的 USDC 付款，无论服务器列出的顺序如何，都会优先选择它，而非其他 EVM 支付渠道。

数据不代表什么

每个响应都附带自己的免责声明和来源说明；请仔细阅读。召回结果属于公共安全信息，不构成法律或医疗建议。

版本

本仓库的发行版本即 Git 标签；每个版本都会发布到 MCP 注册表，名称为 io.github.DV1-321/scalpstream-mcp，并发布为 ghcr.io/dv1-321/scalpstream-mcp 镜像。CHANGELOG.md 中列出了各版本的详细信息。

已在 0.1.10 中撤下：options_research、municipal_income、 crypto_research 和 crypto_yields。 支撑这些工具的 ScalpStream Research 看板已撤下。其主机上的所有路径都会在任何付款发生前返回 410 Gone，并附带 "error": "withdrawn"，因此调用其中任一工具的 0.1.9 或更早版本服务会收到 410，而非数据，且不会产生任何费用。请升级到 0.1.10 或更高版本，此后这些工具均不再列出。

air_quality 仍然保留。AirScout 现在通过可自托管的 Open-Meteo 提供自己的 Copernicus CAMS 预报副本，并在每条答复中注明 Open-Meteo 和 Copernicus 的出处。

许可证

MIT——详见 LICENSE。