Treasury Fiscal

米国財務省財政データ

米国財務省の Fiscal Data API です。日次の財務省現金残高、未償還公的債務、連邦政府の歳入と歳出、関税収入、為替レート、貯蓄債券の償還データを提供します。「連邦財政赤字」と「国家債務」の実際の数値を確認できます。無料で、認証は不要です。

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

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

米国の財政方針に関するマクロ経済の質問（債務水準、日次の現金残高、月次の歳入、関税収入など）には、Treasury Fiscal Data が信頼できる最新の情報源です。FRED が月次の集計値を公開する一方、Treasury はその基礎となる日次の台帳を公開しています。

よくある利用例：

• 国家債務。 「現在の公的債務はいくらですか？」→ treasury_debt → 政府内債務と民間保有分に分けた未償還総額を取得します。
• 関税収入。 「Treasury は 2024 年に関税収入をいくら徴収しましたか？」→ treasury_customs_revenue({year: 2024})。
• 歳入／歳出。 資金源別の日次 Treasury 現金残高（預金と引き出し）。
• 為替レート。 外貨取引に関する Treasury の報告レート（連邦政府の請負業者や助成金受給者が使用）。
• 入札結果。 「直近の 10 年債入札の最高利回りはいくらでしたか？」→ treasury_auction_results({security_type: "Note", term: "10-Year"}) → 直近の決済済み入札の最高利回り、応札倍率、CUSIP、募集額／落札額を取得します。対象は短期国債、中期国債、長期国債、TIPS、変動利付債（FRN）です。

関税関連の情報として、trade_bilateral_analysis コンパウンドで使用されています。

認証

不要です。Treasury Fiscal Data は完全に公開されており、無料で、API キーも必要ありません。

知っておきたいデータセット

データセット	更新頻度	用途
日次財務省報告書	日次	現金残高、預金、引き出し
月次財務省報告書	月次	歳入、歳出、財政赤字
未償還公的債務	日次	債務総額、政府内債務と民間保有分
関税収入	月次	関税徴収額
財務省報告為替レート	四半期ごと	連邦会計の公式レート
貯蓄債券	月次	発行、償還
入札	入札ごと（日次に近い）	短期国債／中期国債／長期国債／TIPS／FRN の最高利回り／利率、応札倍率、CUSIP

更新頻度

• 日次財務省報告書：約午後 3 時（米国東部時間）、T+1（翌営業日）
• 月次報告書：約月半ばに前月分を公開
• 公的債務：日次
• 為替レート：四半期ごとに更新（再調整されます。リアルタイムの市場レートではありません。最新レートには FX／外国為替パックを使用してください）

Pipeworx はこれらに合った TTL でキャッシュします。

よくある落とし穴

• 公的債務と総債務。 「民間保有債務」には、政府内保有分（社会保障信託基金など）は含まれません。報道の見出しで通常取り上げられるのは総債務で、アナリストが注目するのは民間保有債務です。どちらもデータに含まれています。
• 関税収入 ≠ 関税のみ。 反ダンピング関税、相殺関税、手数料が含まれます。純粋な関税収入を調べるには、呼び出しレスポンス内の品目コードで絞り込んでください。
• 財務省の為替レートは市場レートではありません。 連邦政府の会計処理に用いられる、四半期ごとに再調整されたレートです。リアルタイムの為替レートには、専用の exchange-rate または frankfurter パックを使用してください。
• 日次の現金残高はGDPではありません。 財務省の現金残高はストック指標で、GDPはフロー指標です。混同しないでください。
• 会計年度と暦年。 連邦会計年度は10月1日から9月30日までです。歳入と歳出は、既定では会計年度ベースで報告されます。暦年の数値が必要な場合は、明示的に絞り込んでください。
• 入札の多くは新規発行ではなく、追加発行です。 財務省は、既存のノート／債券のCUSIPを残存期間が短い状態で再発行します（たとえば、発行から2か月後に入札された「10年債」は、「9年10か月」の期間として表示されます）。treasury_auction_results の term フィルターは、証券の当初の名目期間（レスポンスの original_term）に一致するため、「10-Year」で検索すれば該当する証券が見つかります。新規発行か追加発行かを判別するには、レスポンスの term／original_term を使用してください。
• TIPSとFRNは、ソースデータでは独立した security_type として扱われません。 財務省は、インフレ連動または変動金利のフラグを付けて、これらを Note／Bond としてファイルに登録しています。security_type: "TIPS" または "FRN" を指定すると、ツールが適切に処理します。生のAPIで security_type:eq:TIPS フィルターを使うと、結果は0件になります。
• 短期国債で報告されるのは利回りではなく金利です。 短期国債では high_yield_pct は null です。代わりに high_investment_rate_pct（債券換算利回り）または high_discount_rate_pct（実際に入札された割引率）を使用してください。

クイックスタート

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

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

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

https://gateway.pipeworx.io/treasury-fiscal/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツールである ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール一式を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールとともに、およそ30個の共有ツールが表示されます。接続の initialize レスポンスには正確なスコープが記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な設計であり、偶然に多重化されているわけではありません。メタツールを使えば、ask_pipeworx 経由でカタログ全体を横断して問い合わせることで、このパックが扱わない質問にもスコープ限定の接続から回答できます。そのため、2つ目の MCP サーバーを追加する必要はありません。現時点では、これらのメタツールを含めずにパックのエンドポイントをマウントする方法はありません。追加のスキーマがもたらすコンテキストコストに比べてルーティングの利点が小さい場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

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

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

どちらのURLも、同じゲートウェイと同じ1,819以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらの接続からも、ask_pipeworx ですべてのツールを利用できます。

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

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

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

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

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

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

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

npx -y @pipeworx/mcp-treasury-fiscal

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

ask_pipeworx での使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。 これは、上記のパックエンドポイントだけでなく、フルゲートウェイでも機能します。

ask_pipeworx({ question: "your question about Treasury Fiscal data" })

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

詳細

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

ライセンス

MIT