Treasury Tic

@pipeworx/treasury-tic

米国財務省のTreasury International Capital（TIC）Systemが提供する、国・月別の米国証券の対外保有額です。「中国は米国債をXドル保有している」という見出しの根拠となる資本フロー調査です。treasury-fiscal パックが扱う日次の財政台帳とは別の財務省システムであり、FREDにもこの系列はありません。

Pipeworx の一部です。AI エージェントを1837以上の稼働中データソースに接続するMCPゲートウェイです。これは独立した非公式のインテグレーションであり、上流プロバイダーとの提携、承認、公開はありません。

ツール

• tic_foreign_holdings(country?, month?, limit?) — 国・月別の米国長期証券（国債、政府機関債、社債、株式）の対外保有額です。特定の国の直近の推移を調べるには country を指定します。省略すると、指定月の対外保有額上位国のランキングを返します。
• tic_major_treasury_holders(country?, month?, limit?) — 「米国債の主要外国保有者」ランキングです。米国債を保有する外国の個別保有者のうち約20の上位保有者に加え、「その他すべて」の区分、総計、外国公的部門（中央銀行／政府）の内訳を返します。金融メディアが国別に引用するのは、この数値です。

認証

認証情報は不要です。上流は認証情報なしで応答し、_apiKey も受け付けません。

データソース

• 米国財務省、Treasury International Capital（TIC）System — 国・証券種別に分類された米国長期証券の対外保有額に関する月次調査と、そこから算出される「米国債の主要外国保有者」ランキングです。米国連邦政府のデータで、再利用の制限はありません。

更新頻度と対象範囲

• 月次で、基準月からおよそ6週間後に公開されます（例：8月分のデータは10月中旬に公開）。
• tic_foreign_holdings は、ほぼすべての国と地域別／機関部門別の集計区分（合計、「そのうち：」の内訳）を対象とし、多くの国について2011年以前までさかのぼれます。
• tic_major_treasury_holders に個別の名称が掲載されるのは、上位約20の保有者だけです。それ以外はすべて「その他すべて」にまとめられます。規模の小さい国を指定すると、found: false と tic_foreign_holdings への案内が返されます。こちらのツールではその国も対象になります。

よくある注意点

• この2つのツールが答える質問は異なります。 同じ国・月について、tic_foreign_holdings の treasury_holdings_usd_mil と tic_major_treasury_holders の holdings_usd_bil は、同じ基礎調査に基づくため近い値になりますが、バイト単位で一致するとは限りません。「主要外国保有者」ランキングは、財務省が独自に作成した表であり、Table 1を機械的に再分類したものではありません。
• 単位が異なります：tic_foreign_holdings は米ドル百万単位、tic_major_treasury_holders は米ドル十億単位で報告します。各レスポンスにはそれぞれ unit フィールドがあるので、単位を推測せず確認してください。
• 国名は、公開元が使用するラベルに解決できる必要があります。「China」は小規模なエイリアステーブルを介して「China, Mainland」に解決されます。解決できない名前の場合、空の結果ではなく、候補とともに found: false が返されます。
• 改訂が行われることがあります。 どちらのファイルも呼び出しごとに最新データを取得するため、過去月の数値に月途中で修正が加わると、最初に取得した時点の値に固定されず、すぐに反映されます。

クイックスタート

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

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

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

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

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

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

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

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

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

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

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

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

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

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

または、起動することを確認するために、直接実行してください。

npx -y @pipeworx/mcp-treasury-tic

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

ask_pipeworx を使う

ツールを直接呼び出す代わりに、平易な英語で質問できます。この方法は、上記のパックエンドポイントとフルゲートウェイの両方で利用できます。

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

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

詳細

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

ライセンス

MIT