ScalpStream Data

ScalpStream MCP サーバー

Claude Desktop、Claude Code、Cursor、およびあらゆる MCP クライアント向けの従量課金型 MCP サーバーです。米国の製品リコール情報、米国の国境での待ち時間、最安の燃料価格を提供し、Base 上の x402 を通じて USDC で精算します。

x402 を通じて、自分のウォレットを使い、呼び出し時に少量の事実データを購入する MCP サーバーです。1 回あたり約 $0.01で、アカウントもサブスクリプションも API キーも不要です。

ほとんどの MCP サーバーは、すでに API キーを持っている API をラップしています。このサーバーは、利用するたびに支払いを行います。販売者もキーを保持しません。ガス代はファシリテーターが負担して精算するため、システム内のキーはあなたのものだけです。プロセスの実行中はメモリ内に保持され、どこにも書き込まれません。

資金を入金する前から役立ちます。 キーを設定していなくても、有料ツールはすべて無料プレビューと正確な見積もり価格を返すため、購入を決める前に何を購入するのか確認できます。

ツール

ツール	得られる情報
product_recalls	FDA、NHTSA、CPSC を横断して、製品、ブランド、原材料、または車両の有効な米国リコール情報を 1 回のクエリで取得します。重大度は 1 つの尺度に統一され、危険性、対処方法、特定の製品が対象かどうかを判断できるロット番号も含まれます。
border_crossings	車両の移動時間と現在の CBP 待ち時間を合わせた合計所要時間で、車線の種類ごとに米国の入国港を順位付けします。最寄りの入国港が最も速いとは限りません。
cheapest_fuel	場所と燃料グレードごとの最安燃料価格です。スペイン、フランス、イタリアではスタンドごとの価格、米国では公式の地域平均価格を提供します。
air_quality	世界各地の現在の AQI と汚染物質、屋外での運動に関する EPA ベースの判定、今後の時間帯で最も空気がきれいになる時間帯を提供します。
payment_status	設定内容と支出額を確認できます。ネットワーク呼び出しは行わず、料金もかかりません。

提供を終了したツールは バージョンに記載されています。

インストール

Docker（ツールチェーン不要）

公開イメージは ghcr.io/dv1-321/scalpstream-mcp です。シェルのないベースイメージ上で非 root ユーザーとして実行され、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

これにより $(go env GOPATH)/bin に scalpmcp が配置されます。

{
  "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 Actors としても実行され、ウォレットではなく 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 フィールドを使用してください。

支出の安全性

実際にお金が動くため、支出超過を防ぐよう、設計上、上限を超える場合は拒否します。

• 署名を行う前に、両方の上限を確認します。 拒否された場合は費用がかからず、ネットワークにも接続しません。
• 上限が未設定の場合は、必ずデフォルト値が適用され、「無制限」にはなりません。 設定行が欠けていても、支出が無制限になってはなりません。
• 支出は、データが実際に配信された場合にのみ記録されます。 有料リクエストがその後失敗した場合、何も処理されなかったかのように示すのではなく、決済状態が不明であることをエラーで通知します。チェーンと照合する必要がある場合があります。
• ガス代はファシリテーターが負担するため、ウォレットに必要なのは USDC のみで、ETH は不要です。

1～2 ドル分を入金した使い捨てのキーを使用してください。大切な残高を保有するキーは決して使わず、ホスト型サービスにキーを渡さないでください。キーを保持するのはこのサーバーだけとし、保持する場合もメモリ内に限ります。

識別、レート制限、ログ

このサーバーが送信するすべてのリクエストには、未払いのリクエストにも有料の再試行にも、次のヘッダーが含まれます。 User-Agent: scalpmcp/<version> (+https://github.com/DV1-321/scalpstream-mcp) このヘッダーにはプログラム名とバージョンのみが含まれ、ユーザーに関する情報は含まれません。

各 ScalpStream ホストでは、User-Agent ごとに毎分 60 リクエストのエッジレート制限が適用されます。このサーバーのすべてのインストールでは同じ User-Agent が使用されるため、各ホストでその上限を共有します。ツール呼び出しあたり 1 リクエストであれば、通常のエージェント利用を大幅に上回る量です。429 が返された場合、共有の上限がその分の残り時間で使い切られていることを意味し、キーや予算に問題があるわけではありません。

このサーバーはツール呼び出しごとに、ツール名、有料かどうか、結果が完全なものかプレビューか、最後の HTTP ステータス、経過時間（ミリ秒）を stderr に 1 行書き込みます。例： 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 をご覧ください。