Usaspending Gov Mcp

usaspending-gov-mcp

USAspending.gov API 向けの無料オープンソース MCP サーバーです。契約、助成金、融資、下請け契約、受給者、機関、連邦勘定に対応しています。

概要、デモ動画、ホスト型の設定については、https://1102tools.com/mcp/usaspending をご覧ください。

ローカルでもホスト型でも、API キーは不要です。ローカルまたはホスト型をご覧ください。

USAspending API に対するライブチェックを含む回帰テストを実施しています。2026 年 10 月のリリースでは、55 個すべてのツールを対象に、現実的な契約関連の質問（受賞履歴、会計年度別合計、下請け契約レポート、連邦勘定）での動作も確認しました。testing.mdをご覧ください。

ローカルまたはホスト型

ローカル（デスクトップ）	Claude（ホスト型）	ChatGPT（ホスト型）
ローカルでの設定	インストール	インストール

• ローカルでは、Claude または ChatGPT のデスクトップアプリ内、あるいは別の AI アプリ内で、ご利用のコンピューター上で実行します。ご自身の完全なレート制限が適用され、政府のサービスのみを利用します。自動更新されないため、AI に更新を依頼してください。手動で設定する必要はありません。このページのリンクを AI に渡し、設定を依頼するか、手順を案内してもらってください。
• ホスト型は常に最新の状態で、設定やキーは不要です。どこからでも Claude または ChatGPT で利用できます。

ローカルとホスト型を比較 · 対応するプロンプト

できること

USAspending.gov REST API を、次の機能を備えた 55 個の MCP ツールとして公開します。

検索と集計

• search_awards - 契約、IDV、助成金、融資、直接支払いを検索する基本ツール
• program_numbers フィルター - 助成金、融資、その他の支援を、支援プログラム一覧の番号（CFDA 番号）で絞り込みます。たとえば、メディケイドは 93.778 です。search_awards、get_award_count、spending_over_time、spending_by_category、spending_by_subaward_grouped、spending_by_transaction、spending_by_geography で利用できます。プログラム名から番号を検索するには、autocomplete_cfda を使用します。
• get_award_count - 支出カテゴリー別の件数
• spending_over_time - 時系列集計（会計年度、四半期、月）
• spending_by_category - 機関、ベンダー、NAICS、PSC、州などの上位 N 件の内訳
• spending_by_transaction - 変更レベルの取引検索
• spending_by_geography - 州、郡、または選挙区別の内訳
• new_awards_over_time - 受領者の新規受注の推移

受注の詳細

• get_award_detail - 単一の受注に関する完全な記録
• get_transactions - 受注の変更履歴全件
• get_award_funding - File C の資金データ（財務省勘定、費目分類、プログラム活動）
• get_award_funding_rollup - 1 行で示す資金の概要
• get_award_subaward_count、get_award_federal_account_count、get_award_transaction_count
• get_idv_children - IDV 配下のタスクオーダー／納品オーダー
• awards_last_updated - データの鮮度を確認

下請け受注（FFATA）

• search_subawards - 単一の元請け配下の下請け受注を検索
• spending_by_subaward_grouped - 累計報告下請け受注額を含む、該当する元請け受注

受領者

• search_recipients - キーワードで受領者を検索
• get_recipient_profile - 受領者の完全な記録
• get_recipient_children - 親受領者の子会社
• autocomplete_recipient - 部分一致で受領者名を検索
• list_states - FIPS コード付きの全州

受領者に関するワークフローでは、autocomplete_recipient の名前を使って search_recipients を実行します。返された id ハッシュを、プロファイルと新規受注の 推移に使用します。子会社を取得するには、親（-P）行の uei（または 以前の duns）を get_recipient_children に渡します。このツールは UEI/DUNS を受け付けます。

機関の詳細

• list_toptier_agencies、get_agency_overview、get_agency_awards
• get_agency_budgetary_resources - 会計年度別の予算リソース
• get_agency_sub_agencies - 義務額を含む下位組織
• get_agency_federal_accounts - 資金源（TAS）
• get_agency_object_classes - 支出カテゴリー（OMB）
• get_agency_program_activities - プログラムレベルの内訳
• get_agency_obligations_by_award_category - 契約と助成金の構成比

IDV の詳細

• get_idv_amounts - IDV の全体概要
• get_idv_funding、get_idv_funding_rollup - IDV の File C
• get_idv_activity - IDV 配下の子オーダー

連邦勘定（財務省）

• list_federal_accounts - TAS を検索
• get_federal_account_detail、get_federal_account_object_classes、 get_federal_account_program_activities、get_federal_account_fy_snapshot

オートコンプリート

• autocomplete_psc、autocomplete_naics
• autocomplete_awarding_agency、autocomplete_funding_agency
• autocomplete_cfda（助成金）、autocomplete_glossary、autocomplete_recipient

参照データ

• get_naics_details、get_psc_filter_tree
• get_award_types_reference - 全受注タイプコード（A＝BPA コールなど）
• get_def_codes_reference - 災害緊急基金コード（COVID、IIJA、IRA）
• get_glossary - 調達／支出に関する用語
• get_submission_periods - 機関別の報告期間
• get_state_profile - 州レベルの支出プロファイル

ワークフローの利便機能

• lookup_piid - 契約か IDV かを自動判別し、該当する受注を返します

インストール

pip 経由

pip install usaspending-gov-mcp

uvx 経由（推奨、venv 不要）

uvx --refresh-package usaspending-gov-mcp --from usaspending-gov-mcp usaspending-mcp

--from はこのサーバーでのみ必要です。PyPI パッケージ名は usaspending-gov-mcp ですが、インストールされるコンソールスクリプト名は usaspending-mcp のため、uvx usaspending-gov-mcp をそのまま実行すると、「パッケージ usaspending-gov-mcp には usaspending-gov-mcp という名前の実行ファイルがありません」というエラーが発生します。

uvx usaspending-mcp も実行しないでください。usaspending-mcp は PyPI 上の無関係なサードパーティ製パッケージであり、このプロジェクトのものではありません。

ソースから

git clone https://github.com/1102tools-dev/federal-contracting-mcps.git
cd federal-contracting-mcps/servers/usaspending-gov-mcp
pip install -e .

設定

以下の設定をサーバー定義として使用し、互換性のある MCP クライアントに合わせて配置を調整してください。このソースを使用した実用的なリクエストについては、プロンプトライブラリを参照してください。

{
  "mcpServers": {
    "usaspending": {
      "command": "uvx",
      "args": ["--refresh-package", "usaspending-gov-mcp", "--from", "usaspending-gov-mcp", "usaspending-mcp"]
    }
  }
}

--refresh-package フラグを指定すると、クライアントがサーバーを起動するたびに uv が PyPI で新しいリリースを確認するため、修正が自動的に反映されます。指定しない場合、uv は最初にキャッシュしたバージョンを使い続けます。起動時にネットワーク処理の時間が少し加わるため、プラットフォームで MCP の起動タイムアウトが短く設定されている場合は、値を引き上げてください。

pip install -e . または通常の pip install でインストールした場合：

{
  "mcpServers": {
    "usaspending": {
      "command": "python",
      "args": ["-m", "usaspending_gov_mcp.server"]
    }
  }
}

クライアントを再起動すると、ツールが表示されます。

ツールプロファイル

単独で使用する場合、デフォルトは USASPENDING_TOOL_PROFILE=full で、55 個すべてのツールが公開されます。パッケージ化された調達エージェントでは USASPENDING_TOOL_PROFILE=acquisition-agent を設定し、受賞案件の検索、支出、機関、受領者、NAICS、PSC、取引、下請けに関する主要な操作を網羅する、安定した 20 個のツールのサブセットを公開します。不明なプロファイルが指定された場合、カタログをひそかに変更するのではなく、明確なエラーを表示して起動を停止します。

プロンプトの例

設定が完了したら、次のように試してみてください。

• 「FY2025 に落札された NAVSEA 契約を金額順に上位 10 件表示してください。」
• 「過去 1 年間に NASA が発注した、随意契約の正当化理由があるソフトウェア開発契約をすべて探してください。」
• 「2020 年以降、Leidos が連邦政府の受賞案件で受け取った金額はいくらですか？会計年度別に集計してください。」
• 「DoD の HUBZone 留保契約の受領者上位 15 件を教えてください。」
• 「PIID N00024-24-C-0085 の変更履歴をすべて取得してください。」
• 「FY2024 の空軍における IT サービスの FFP 契約と T&M 契約の件数を比較してください。」

設計上の注意事項

• 認証は不要です。 USAspending.gov は無料の公開 API です。
• 会計期間の集計。 会計年度は10月から9月までです。第1四半期は10月～12月、1か月目は10月です。new_awards_over_time は、年間の会計年度の結果を得るため、ソースの会計四半期ごとの件数を合算します。会計年度の一部だけを対象とする日付範囲では、年度全体ではなく、指定された期間分の件数が返されます。四半期と月の結果には、ソースの件数がそのまま保持されます。
• FFATA の期間範囲。 spending_by_subaward_grouped は、条件に一致する元請けの累計報告済み下請け総額を順位付けします。日付フィルターは、その総額を指定期間内の下請け契約の措置に限定しません。期間別のレポートでは、返された award_generated_internal_id を search_subawards に渡し、すべてのページを読み込んで、action_date でレコードを絞り込んでください。報告額には累計値が繰り返し含まれる場合があります。合計しても、新たに発生した下請け契約の支出額にはなりません。
• 契約の日付範囲。 デフォルトでは、日付範囲内に有効だったすべての契約（最初の署名から最新の措置まで）が一致するため、一致したからといって、その期間内に措置が行われたとは限りません。実際の活動を確認するには、spending_by_transaction を使用してすべてのページを読み込み、契約識別子を重複排除してください。get_transactions では、1件の契約の措置日を確認できます。明示的に date_type="action_date" を指定すると、最新の措置で範囲を指定します。
• 連邦会計プログラム。 プログラムの一覧には、報告対象の全年度にわたるコードと名称が含まれますが、金額や会計年度フィルターはありません。このツールはソースのページを内部で取得し（最大2,000件）、完全性と、指定されたものの適用されなかった会計年度を報告します。単一年度の会計リソースには、数値の会計 ID と会計年度のスナップショットを使用してください。機関のプログラム合計は、機関全体に適用されます。
• 利用可能な会計年度。 会計一覧のデフォルトは、ソースで最新の利用可能な会計年度です。特に10月の年度切り替え後は、fy を確認してください。ソースにまだ存在しない年度を指定すると、利用可能な年度が回答で説明されます。機関の予算上のリソースには、義務的支出と裁量的支出の内訳はありません。
• 契約タイプのグループは混在できません。 award_type パラメーターには、contracts、idvs、grants、loans、direct_payments、other のいずれかを指定します。カテゴリごとに別々に呼び出してください。
• program_numbers は支援のみを対象とします。 award_type に grants、loans、direct_payments、または other を指定して使用してください。契約と IDV には支援リストがないため、サーバーは結果ゼロではなくメッセージを返します。
• 対処方法がわかるエラーメッセージ。 よくある API エラー（契約タイプの混在を示す422エラー、ソートフィールドがないことを示す400エラー、キーワードが空であることを示す400エラー）は、呼び出し元の LLM 向けのガイダンスに変換されます。
• ソートフィールドの自動処理。 USAspending API では、ソートフィールドをフィールド配列に含める必要があります。このサーバーは自動的に追加します。
• 適切なデフォルト値。 検索件数のデフォルトは25件です（API の上限は100件）。デフォルトのフィールドには、各契約カテゴリで最もよく使われる列が含まれます。
• フラットなフィルターパラメーター。 LLM によるツールの検出を容易にするため、一般的なフィルターの多くは、ネストされたフィルター辞書ではなく、名前付きパラメーター（keywords、awarding_agency、naics_codes など）として提供されます。

データソース

すべてのデータは USAspending.gov から取得しています。同サイトは、FPDS-NG の契約データ、FAADC の支援データ、および各機関が提出した DATA Act のデータを集約しています。データの鮮度は機関によって異なります。国防総省以外の契約データは通常5営業日以内に利用可能になります。国防総省と USACE の調達データは、FPDS で90日間の報告遅延があります。財政支援データは提出から2日以内に利用可能になります。

ライセンス

MIT

リグレッションテスト

このパッケージのディレクトリから PYTHONPATH=src uv run --python 3.12 python -m pytest -q を実行します。公開 API に対するライブチェックを追加するには、USASPENDING_LIVE_TESTS=1 を設定します（キーは不要です）。詳細は testing.md を参照してください。

テストファイル	対象範囲
test_v0_3_features.py	ツールの形式、フィルター、拡張された API サーフェス
test_density_r5.py	境界と意味に関するリグレッションの網羅性
test_live_audit_r6.py	ライブエンドポイントの監査
test_live_audit_r7.py	ライブパラメーターとページネーションの監査
test_content_fixes_1013.py	10 月のコンテンツ修正、オフラインおよびライブ
test_round_8.py	プロパティと検証のチェック
test_entity_family_fixes.py	省庁、受給者、契約の意味
test_validation.py	入力の検証
test_search_family_fixes.py	検索と集計の意味
test_response_cache_hosted.py	ホステッドキャッシュの動作
test_audit_r11.py	間隔を空けた監査アンカー
test_throughput.py	リクエストのスループットとペーシング
test_tool_profiles.py	ツールプロファイルの選択
test_http.py	HTTP 処理
test_content_e2e_1014.py	エンドツーエンド監査ガイダンス全体のリグレッション
test_published_scope_1015.py	公開済みツール選択範囲のガイダンス
test_new_awards_fiscal_year_1016.py	記録された年間会計年度の修正と、変更されていない四半期・月のサンプル
test_subaward_period_scope_1017.py	累積 FFATA 範囲と日付付きレポートの完全な復旧
test_federal_account_program_scope_1018.py	記録された全年度のプログラム範囲、完全なリスト、単年度の財務情報の復旧
test_federal_account_available_fy_1020.py	現在の会計年度におけるソースの利用可能性、対応する復旧、変更されていない 503 の制御
test_naics_current_retired_1021.py	実際の廃止済み行と、要求された上限によって省略された有効な行
test_award_date_overlap_r6.py	契約期間の重複と、日付付き取引の完全な復旧
test_sdk23_expected_guidance.py	表示される通常の復旧ヒント、事前検証前のソースリクエストなし、ソース出力の保持、予期しない障害のマスキング
合計	2,322