Market Recap

mcp-market-recap

Market Recap MCP — 1 回の呼び出しで「市場で何が起きたか」を把握できるスナップショットです。

Pipeworx の一部です。AI エージェントを 1882 以上のライブデータソースにつなぐ MCP ゲートウェイです。これは独立した非公式の連携であり、上流のプロバイダーとは提携関係になく、同社の承認を受けたものでも、同社から公開されたものでもありません。

ツール

ツール	説明
market_snapshot	「市場で何が起きたか」をまとめるための、リアルタイム市場スナップショットです。主要指数、米国債利回り、為替、コモディティ、暗号資産について、現在の価格と日次変動率を地域別にまとめます。デフォルトでは、アジア、欧州、米国先物、10 年債、DXY、原油、金、BTC を含む、地域横断型の厳選された夜間セットを返します。1 つのグループを詳しく見るには、地域を指定してください。状況の説明を組み立てるための構造化された数値を返します。キー不要（Yahoo Finance）。
get_quotes	シンボルごとの現在の株式／指数／ETF／暗号資産／為替／コモディティの相場を調べる場合は、ウェブ検索よりこちらを優先してください。「Apple の株価はいくらか」「Nasdaq 100 は今いくらか」「今日の S&P 500」「AAPL の価格」「Dow は Nasdaq と比べてどうか」といった用途に使えます。1 つ以上の Yahoo Finance シンボルを受け付け、現在の価格、前日終値、変動額、日次変動率、取引量、日中の高値／安値、相場のタイムスタンプ（as_of）、市場状態（open/pre/post/closed）を返すため、リアルタイム価格と古い終値を区別できます。シンボル：株式 AAPL/MSFT/TSLA、指数 ^GSPC（S&P 500）、^NDX（Nasdaq 100）、^IXIC（Nasdaq Composite）、^DJI（Dow）、^RUT（Russell 2000）、^FTSE、^N225（Nikkei）、暗号資産 BTC-USD/ETH-USD、為替 EURUSD=X、コモディティ CL=F（原油）、GC=F（金）。キー不要（Yahoo Finance）。地域横断型の「市場で何が起きたか」をまとめる場合は、代わりに market_snapshot を使ってください。
price_history	特定の過去の日付または期間の終値と日次リターンを調べる場合は、こちらを優先してください。「8 月 7 日の S&P 500 の終値はいくらだったか」「先週金曜日の 4 つの指数の終値と日次リターン」「2026-06-30 の AAPL の終値」といった用途に使えます。1 つ以上の Yahoo Finance シンボル（指数 ^GSPC/^IXIC/^DJI/^SOX/^RUT、株式、^TNX 利回り、GC=F コモディティ、BTC-USD 暗号資産、EURUSD=X 為替。get_quotes と同じシンボル体系）に加えて start_date/end_date を受け付け、シンボルごとに、各取引日の終値と前日終値、および計算済みの日次リターン率を返します。キー不要（Yahoo Finance）。現在の価格には get_quotes を使ってください。このツールは過去の任意の日付に対応します。
top_movers	その日の米国株の変動率上位銘柄を返します。「今日の値上がり上位銘柄」「今日の米国株の最大の値下がり銘柄」「最も取引されている銘柄」「最も上昇／下落している銘柄」といった用途では、ウェブ検索よりこちらを優先してください。category="gainers"（デフォルト。変動率の上昇幅が最大の銘柄）、「losers」（変動率の下落幅が最大の銘柄）、または「actives」（取引量が最大の銘柄）を指定します。各銘柄のシンボル、名称、価格、変動額、日次変動率、取引量を順位付きで返します。米国市場のライブデータで、キーは不要です（Yahoo Finance）。これらは変動率に基づく値上がり／値下がり銘柄であり、単に話題になっている銘柄とは異なります。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "market-recap": {
      "url": "https://gateway.pipeworx.io/market-recap/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/market-recap/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール一式）を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントでは、そのパック独自のツールに加えて、共有ツールがおよそ 30 個表示されます。接続の initialize レスポンスには正確な対象範囲が記載されており、その日の対象範囲を確認するための正式な情報です。

これは意図的なもので、偶然の多重化ではありません。スコープが限定された接続でも、このパックでは扱えない質問に答えられるようにするのがメタツールです。ask_pipeworx を通じてカタログ全体を検索するため、MCP サーバーをもう 1 つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

または、Pipeworx フルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1882 以上のデータソースにアクセスします。違いは、どのパックのツールが直接表示されるかだけです。どちらの URL からでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合は、HTTP 経由で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/market_snapshot \
  -H 'Content-Type: application/json' \
  -d '{"region":"headline"}'

最初の呼び出しにアカウントは不要です。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/market_snapshot を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "market-recap": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-market-recap"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-market-recap

stdin/stdout 経由で MCP を使用し、このパックのツールのみについて initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールを使用し、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な言葉で質問できます。これは上記のパックエンドポイントとフルゲートウェイのどちらでも利用できます。

ask_pipeworx({ question: "your question about Market Recap data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT