Macro Snapshot について
米国と世界の経済指標をまとめて把握するための、分析者やエージェント向けMCPサーバーです。FRED系列とリアルタイムの暗号資産データを構造化されたスナップショットにまとめ、個別のFRED系列の直近履歴も提供します。
主な機能
- 01金利・インフレ・雇用指標を一括表示
- 02米国債利回り曲線とスプレッドを表示
- 03GDP・S&P 500・VIX・BTCを収録
- 04データ群ごとの日付と鮮度を提示
- 05FRED系列ごとの履歴を取得
活用シーン
- 01マクロ経済の概況を素早く確認
- 02逆イールドやインフレの状況を確認
- 03スナップショット内の指標の直近データを確認
MCP 対応
マクロスナップショットと個別のFRED系列を照会するツールをMCPクライアントに公開します。Pipeworxゲートウェイまたはローカルのstdio MCPサーバー経由で接続できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://gateway.pipeworx.io/macro-snapshot/mcpclaude mcp add --transport http pipeworx-io-macro-snapshot https://gateway.pipeworx.io/macro-snapshot/mcp{"mcpServers":{"pipeworx-io-macro-snapshot":{"type":"http","url":"https://gateway.pipeworx.io/macro-snapshot/mcp"}}}Cursor で開く{"servers":{"pipeworx-io-macro-snapshot":{"type":"http","url":"https://gateway.pipeworx.io/macro-snapshot/mcp"}}}VS Code で開く{"mcpServers":{"pipeworx-io-macro-snapshot":{"type":"http","url":"https://gateway.pipeworx.io/macro-snapshot/mcp"}}}{"mcpServers":{"pipeworx-io-macro-snapshot":{"serverUrl":"https://gateway.pipeworx.io/macro-snapshot/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
mcp-macro-snapshot
macro-snapshot MCP — 1 回の呼び出しで経済の状態を把握できます。
Pipeworx の一部です。AI エージェントを 1882 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、承認、公開のいずれもしていません。
ツール
| ツール | 説明 |
|---|---|
macro_snapshot | 1 回の呼び出しで米国および世界経済の現在の状態を取得します。FF 金利、米国債のイールドカーブ全体(3 か月/2 年/10 年+10 年-2 年および10 年-3 か月のスプレッドと逆イールドフラグ)、CPI とコア CPI の前年同月比、失業率、非農業部門雇用者数(前月比の変化を含む)、実質 GDP 成長率、S&P 500、VIX、広義の USD 指数、BTC を取得します。FRED の系列(連邦準備制度の経済データ)16 件とライブの暗号資産データを組み合わせて並列処理し、構造化されたダッシュボードと、人が読みやすい注記(逆イールド、インフレ率と FRB の 2%目標との比較、VIX の上昇)を返します。指標を 10 件、個別に取得する代わりに使用してください。引数はありません。各構成要素の日付は一致しません。日次系列(金利、市場データ)の隣に、100 日以上古い場合がある四半期 GDP が並びます。各グループには独自の as_of マップがあり、freshness には全期間と最も古い構成要素が示されます。フィールドをトップレベルの as_of と比較する前に、これらを確認してください。トップレベルの as_of は最新の日次系列のみを示します。 |
indicator | 1 件の FRED 系列(連邦準備制度の経済データ)の最近の履歴を読み込みます。macro_snapshot に含まれる項目や、その他の FRED 系列 ID を詳しく確認できます。よく使われる ID:UNRATE(失業率)、DFF(FF 金利)、DGS10/DGS2/DGS3MO(米国債利回り)、CPIAUCSL(CPI 指数)、CPILFESL(コア CPI 指数)、PAYEMS(非農業部門雇用者数)、VIXCLS(VIX)、SP500、MORTGAGE30US(30 年住宅ローン金利)、WALCL(FRB のバランスシート)、DTWEXBGS(広義の USD 指数)、T10Y2Y/T10Y3M(イールドカーブのスプレッド)。直近の観測値から順に並べたデータと、最新の値を返します。 |
クイックスタート
MCP クライアント(Claude Desktop、Cursor、Windsurf など)に追加します。
{
"mcpServers": {
"macro-snapshot": {
"url": "https://gateway.pipeworx.io/macro-snapshot/mcp"
}
}
}
このエンドポイントが実際に提供するもの
https://gateway.pipeworx.io/macro-snapshot/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール(ask_pipeworx、discover_tools、search_within、remember/recall など、ゲートウェイ全体で利用できるツール群)も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールとともに、およそ 30 件の共有ツールが一覧表示されます。接続の initialize 応答には正確な範囲が示され、その日の情報として正式な回答になります。
これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うと、このパックの範囲外の質問にも、カタログ全体を対象にルーティングする ask_pipeworx を通じて回答できます。MCP サーバーをもう 1 台追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマにかかるコンテキストコストがルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに 1 回接続してください。
また、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
どちらの URL も、同じゲートウェイと同じ 1882 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。
MCP クライアントがない場合:HTTP で呼び出す
curl -X POST https://gateway.pipeworx.io/v1/tools/macro_snapshot \
-H 'Content-Type: application/json' \
-d '{}'
最初の呼び出しにはアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/macro_snapshot を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。
単体での実行(ゲートウェイアカウント不要)
このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへのラウンドトリップも不要です。
{
"mcpServers": {
"macro-snapshot": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-macro-snapshot"]
}
}
}
または、直接実行して起動を確認します。
npx -y @pipeworx/mcp-macro-snapshot
stdin/stdout 経由で MCP を使用し、initialize/tools/list/tools/call に応答します。ただし、対象はこのパックのツールのみであり、上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールを使用しますが、ask_pipeworx によるルーティングは利用できません。
ask_pipeworx での使用
ツールを直接呼び出す代わりに、平易な英語で質問できます。 これは、上記のパックエンドポイントだけでなく、フルゲートウェイでも機能します。
ask_pipeworx({ question: "your question about Macro Snapshot data" })
ゲートウェイが適切なツールを選び、引数を自動的に設定します。
詳細
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。