mcpField
U
Usaspending

Usaspending

リモート
pipeworx.io法務・行政02 週間前に更新
リポジトリ公式サイト

Usaspending について

Usaspendingは、USAspending.govの米国連邦契約、助成金、融資、直接給付データを扱うMCPサーバーです。機関、受領者、業種別の支出分析に加え、期限切れ間近の受賞案件や請負業者のポートフォリオも調べられます。

主な機能

  1. 01連邦の受賞案件と支出の検索
  2. 02受領者、機関、業種で絞り込み
  3. 03義務額と年度別データの分析
  4. 04期限が近い受賞案件の検索
  5. 05請負業者の案件構成と期限の確認
  6. 06受賞案件の参照リンクを返却

活用シーン

  1. 01連邦請負業者と機関別収入の調査
  2. 02政策分野ごとの連邦投資の分析
  3. 03期限が近い政府契約から商機を探す

MCP 対応

連邦支出、受賞案件、期限切れ間近の契約、請負業者プロフィールを扱うツールをMCPクライアントに公開します。Pipeworxゲートウェイ経由、またはローカルのstdio MCPサーバーとして利用できます。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://gateway.pipeworx.io/usaspending/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

詳細

USAspending — 連邦政府の契約・助成金の受賞情報

米国財務省の USAspending.gov が提供する連邦政府の受賞情報データです。契約、助成金、融資、直接支払いが含まれます。連邦政府が2008年以降に授与したすべての金額(2001年まで遡るデータは網羅性にばらつきがあります)を、受領者、機関、下位機関、NAICS コード、業務実施場所ごとに分類して確認できます。無料で、認証も不要です。

Pipeworx の一部です。AI エージェントを1815以上の稼働中データソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流のプロバイダーとは提携しておらず、承認も受けておらず、同プロバイダーから公開されたものでもありません。

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

SAM.gov が「調達機会」(政府が何を購入しようとしているか)を扱うのに対し、USAspending は「受賞情報」(実際に契約された内容)を扱います。競合情報、ロビー活動費の ROI 分析、連邦政府のベンダー調査、政策分野に関する資金の流れの追跡において、信頼できる一次情報源となります。

一般的な利用例:

  • 「X は連邦政府の契約をどれくらい受注していますか?」 → get_federal_spending({recipient: "X"}) → 年別、機関別の受賞額。
  • 「国防総省の主要請負業者はどこですか?」 → 機関で絞り込んだ支出検索。
  • 「AI/サイバーセキュリティ/クリーンエネルギーへの連邦政府の投資額は?」 → キーワードと NAICS/PSC コードによる検索。

govcon_contractor_profile と lobbying_activity のレシピで使用されます。

認証

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

受賞区分

区分内容
契約(FPDS-NG)直接調達。競争入札または随意契約
助成金裁量型または算定式に基づく交付(研究、州への助成金など)
融資連邦政府の信用供与プログラム(SBA、USDA、教育省)
直接支払い社会保障、退役軍人給付など
IDV(無期限納品契約)基本契約。注文はこれに基づいて発行されます

企業レベルの分析では、通常、契約が最も重要です。大学や非営利団体にとっては、助成金が重要です。

よくある注意点

  • 受領者名の正規化。 「Lockheed Martin Corporation」「LOCKHEED MARTIN CORP」「Lockheed Martin」は、いずれもデータに登場します。正確な合計を得るには、法人格を示す接尾辞を除去したうえで、大文字と小文字を区別せずに集計してください。
  • 親会社と子会社。 大企業には多数の子会社があり、それぞれ別個の UEI を持つことがあります。USAspending には親会社と受領者の階層を示すフィールドが含まれているため、企業全体の正確な合計を求めるにはこれらを使用してください。
  • 義務額と支出済み額。 「義務額」は政府が確約した金額で、「支出済み額」は実際に支払われた金額です。複数年契約では、この差が解消されるまでに数年かかることがあります。
  • 「IT サービスを販売している」場合の NAICS コード。 1社の請負業者に数十の NAICS 指定があることもあります。NAICS で絞り込むと、そのコードで分類された受賞情報だけが得られます。複数の NAICS にまたがる分析には、慎重な集計が必要です。
  • データの遅れ。 ほとんどの受賞情報は、義務が発生してから30日以内に掲載されます。ごく直近の四半期は不完全で、後から上方修正されます。
  • 一意な受賞 ID。 受賞情報には変更されない ID(契約の PIID、助成金の FAIN)があります。引用にはこれらを使用してください。受領者別の合計は、集計された値です。

再入札カレンダー — usa_expiring_awards / usa_incumbent_profile

「今後12か月で期限が切れる1,000万ドル超の VA の IT 契約と、その契約を保有する事業者を教えてください」は、政府向け契約事業の事業開発で中心となる質問です。この2つのツールで直接回答できます。キーは不要で、上流側のスロットリングもありません。

usa_expiring_awards({agency: "Department of Veterans Affairs", naics: "5415",
                     min_amount: 10000000, months_ahead: 12})
usa_incumbent_profile({recipient: "Booz Allen"})

usa_expiring_awards は、各受賞情報について、現契約者、履行期間、義務額、機関/下位機関、NAICS/PSC、usaspending.gov へのリンクを返します。 usa_incumbent_profile は、1社の契約ポートフォリオを返します。有効な受賞情報、義務額の合計、契約上限額、6/12/18か月後の契約満了、主要機関、NAICS が含まれます。

これらは usaspending_awards_current を読み込みます。このマテリアライズドビューは、受賞情報1件につき1行(1,510,983件のトランザクションから得られた626,306件の受賞情報)で構成されます。パイプラインの読み込み後は毎回、select usaspending_refresh_awards_current(); で再構築してください。この処理では、すべての応答に付与される mirror_as_of も更新されます。

注意すべき点
  • 粒度。 基本テーブルは、トランザクションごとに1行です。変更があるたびに受賞の PIID が繰り返されるため、usaspending_contracts を直接クエリすると、1つの契約が何度もカウントされ、その金額も同じように何度も合算されます。ビューを使用してください。

  • 異なる2種類の終了日。 period_of_performance_current_end_date は再競争の判断時点です。period_of_performance_potential_end_date は、すべてのオプションが使い切られる時点です。6か月後に終了する受賞で、オプションがさらに3年間残っている場合は、再競争ではなく延長されます。これをリードとして挙げると、実際の案件とまったく見分けがつかない誤検知になります。options_status は options_remain/no_options_remain/unknown を返します。2026-08-28より前に読み込まれたデータはすべて unknown です。取り込み時に潜在的な終了日が破棄されており、次回のパイプライン実行から値が入力され始めるためです。

  • 終了日は最新のトランザクションのものであり、最大値ではありません。 5,299件の受賞(0.88%)で両者が一致しません。後の変更で契約期間が短縮されることがあるためです。api.usaspending.gov と照合したところ、最新のトランザクションの日付は6回中5回上流のデータと一致し、最大値は1回だけ一致しました。max() に「修正」しないでください。

  • 日付が古い場合もあります。 mirror_as_of より後に提出された変更で、ここに期限切れとして掲載された受賞が延長されている可能性があります。この理由で、ある14億ドルの VA 受賞は14か月前の情報として読み取られました。リアルタイムの確認には usaspending_url を使用してください。

  • IDV は除外されています。 IDV は履行期間のない発注用ビークルであるため、期限もありません。443,315件のトランザクションには終了日がありませんが、626,306件の受賞のうち終了日がないものは22,221件だけです。日付には、終了日が設定された最新のトランザクションのものが使われるためです。

  • min_amount は契約上限額ではなく、義務付けられた金額で絞り込みます。 上限額が4,000万ドルでも、実際の作業が4万ドルの利用が少ないビークルは、1,000万ドルの下限を満たしません。

  • mirror_as_of はスナップショットのファイル名ではなく、データから取得されます。 両者が一致しないことがありました。固定されたスナップショット URL は contracts-all-20260506.zip を示していましたが、テーブルには2026-08-04までのアクション日が含まれていました。

クイックスタート

MCP クライアント(Claude Desktop、Cursor、Windsurf など)に追加します:

{
  "mcpServers": {
    "usaspending": {
      "url": "https://gateway.pipeworx.io/usaspending/mcp"
    }
  }
}
このエンドポイントが実際に提供するもの

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

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

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

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

スタンドアロン(ゲートウェイアカウント不要)

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

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

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

npx -y @pipeworx/mcp-usaspending

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

ask_pipeworx の使用

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

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

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

詳細

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。