Imf

IMF — 国際通貨基金データ

国際通貨基金のマクロデータベースです。190 以上の加盟国を対象に、国別の GDP、インフレ、経常収支、財政収支、為替レート、債務、雇用、人口統計を提供します。国際比較における標準的なマクロデータソースです。無料で、認証も不要です。

Pipeworx の一部です。AI エージェントを 1881 以上のライブデータソースにつなぐ MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、承認、公開のいずれも行っていません。

AI エージェントにとって重要な理由

国際比較マクロ分析では、IMF のデータベース（WEO — 世界経済見通し、IFS — 国際金融統計、BOP — 国際収支）が標準的な情報源です。FRED が米国に重点を置くのに対し、IMF は世界全体を対象とし、データを調和しています。世界銀行が開発に重点を置くのに対し、IMF はマクロ経済、財政、金融に重点を置いています。

一般的なワークフロー：

• 国別マクロスナップショット。 特定の国の GDP、インフレ、経常収支を取得します。
• 国際比較。 複数の国について同じ指標を取得し、比較します。
• 時系列分析。 トレンド分析のために過去のデータを取得します。

trade_country_profile 複合ツールで使用され、Comtrade（貿易フロー）や BLS（米国の労働市場）との組み合わせが適しています。

認証

不要です。IMF Data API は完全に公開されており、無料で利用できます。

主なデータベース

データベース	対象範囲	用途
WEO（世界経済見通し）	年次・半年次	GDP、インフレ、財政、経常収支の予測
IFS（国際金融統計）	月次・四半期	通貨、銀行、物価、政府財政
BOP（国際収支）	四半期	経常勘定、資本勘定、金融勘定
DOTS（貿易方向統計）	月次	二国間貿易（Comtrade のミラー統計）
GFS（政府財政統計）	年次	政府の歳入、歳出、債務

よくある注意点

• 国コードの違い。 IMF は ISO 3 文字コード（USA、GBR、DEU）を使用します。Comtrade は 3 桁の数字、Census は 2 文字を使用します。複数の情報源を連携するには、コードの変換が必要です。
• WEO の発行は年 2 回です。 4 月と 10 月に発行されます。予測は発行ごとに大きく変わることがあるため、必ず発行時点を明記してください（例：「WEO 2024 年 10 月版」）。
• 為替レートの定義はさまざまです。 期間平均、期末値、購買力平価（PPP）、実質実効為替レートがあります。IMF のデータにはこれらすべてが含まれるため、どの定義を使うかを指定してください。
• データに欠損がある場合があります。 小規模経済や政治的に孤立した国（北朝鮮、ベネズエラ、エリトリア）では、データが断続的です。IMF API は null を返します。null をゼロとして扱わないでください。
• 実質値と名目値。 GDP の既定値は、米ドル建ての名目値（当年価格）です。時系列や高インフレ経済間の比較では、通常、実質値（インフレ調整済みの固定価格）または PPP 調整済みの値を使用します。
• 公表の遅れ。 年次データは、国からの報告状況に応じて 6～18 か月遅れて公表されます。四半期データはより早く、主要経済では約 2～3 か月の遅れです。

クイックスタート

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

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

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

https://gateway.pipeworx.io/imf/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 も、同じゲートウェイと 1881 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

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

最初の呼び出しにアカウントは必要ありません。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/get_datasets を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

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

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

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

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

npx -y @pipeworx/mcp-imf

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

ask_pipeworx を使用する

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

ask_pipeworx({ question: "your question about Imf data" })

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

詳細

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

ライセンス

MIT