SAM.gov MCP

sam-gov-mcp

SAM.govの事業体登録、排除・資格停止、契約機会、契約受注、連邦政府の階層構造、FFATAの下請け契約データに対応する、無料のオープンソースMCPサーバーです。

概要、デモ動画、ホスト型のセットアップ：https://1102tools.com/mcp/sam-gov

エディションは2種類あります。ホスト型は、契約機会、公開事業体登録、排除情報に対応する、キー不要の主要な6つのツールを提供します。ローカル版は、無料のSAM.govキーを使用する全20ツールを利用できます。ローカル版とホスト型をご覧ください。

SAM.gov APIに対するライブチェックを含む回帰テストを実施しています。2026年10月リリースも、SAM.govの公式記録を用いた現実的な契約関連の質問で検証済みです。testing.mdをご覧ください。

ローカル版とホスト型

SAM.govには2種類のエディションがあります。キーが不要なのはホスト型のみです。

	ローカル版（全機能版）	ホスト型
インストール	お使いのコンピューターにインストールします。このページのリンクをAIに渡してセットアップを依頼するか、インストールから始めてください	ClaudeまたはChatGPTのディレクトリから追加します
APIキー	無料のSAM.govキーが必要です。90日ごとに有効期限が切れます	不要
ツール	20	6
対応範囲	契約機会に加え、事業体登録、SBA認証、排除情報、表明および認証、インテグリティ記録、契約受注記録、連邦政府の階層構造、下請け契約に対応します	契約機会、受注通知、正当化理由、公開事業体登録と事業者／SBA認証コード、排除情報に対応します
データ	ライブのSAM.gov APIを使用します。利用できる範囲はキーの日次上限によって決まります	SAM.govの公開ファイルを使用します。契約機会と排除情報は毎日、事業体登録は毎月更新され、結果にはソースファイル名と日付が付属します
対応環境	デスクトップまたはノートパソコンで、ClaudeまたはChatGPTのデスクトップアプリやその他のAIアプリから利用できます	ウェブ、デスクトップ、スマートフォンでClaudeまたはChatGPTから利用できます
更新	手動です。ローカル版は自動更新されません。AIに更新を依頼してください	自動です。常に最新リリースが実行されます

ローカル版（デスクトップ）	Claude（ホスト型）	ChatGPT（ホスト型）
ローカル版のセットアップ	インストール	インストール

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

ホステッド版：キー不要の6つのツール

ホステッド版では、契約機会、公開事業体登録、除外情報を検索して読み取れます。SAM.gov が公開ダウンロード用に提供するファイルのコピーを使用するため、API キーもローカルでのセットアップも不要です。契約機会と除外情報は毎日、公開事業体登録は毎月公開されます。サービスは契約機会を2時間ごとに、公開事業体と除外情報のファイルを4時間ごとに確認し、通常の除外情報公開時刻後にも追加で確認します。更新は既存の運用予算の範囲内で行われ、変更のないファイルについては行が書き込まれません。各結果に表示される日付は、実際に読み込まれたファイルの日付です。公開されたからといって、すぐに更新されるとは限りません。更新が完了していない間、影響を受ける公開ツールはデータを更新中であることを報告し、再試行を促します。

ツール	機能
search_opportunities	キーワード（タイトルと説明全文）、NAICS、PSC、セットアサイド、通知種別、機関、州、掲載日または回答期限で通知を検索します。落札通知と正当化通知も通知種別に含まれます。
get_opportunity	通知の詳細情報：説明、連絡先、落札の詳細、sam.gov へのリンク
summarize_opportunities	機関、NAICS、セットアサイド、通知種別ごとの件数を表示します
search_entities	UEI または CAGE で公開登録情報を検索するか、名称、NAICS、州、事業種別／SBA 認証コード、有効な登録状況で検索します
search_exclusions	UEI、CAGE、または名称で公開除外情報を確認します
get_data_status	契約機会、事業体、除外情報について、ソースファイル名と日付、読み込み時刻、行数を表示します

以前の会計年度に掲載された通知も、有効な状態であれば表示されることがあります。完全な過去データのアーカイブではなく、アーカイブ済みの通知や添付ファイルは含まれません（結果には sam.gov の通知へのリンクが表示されます）。より幅広い落札履歴を調べるには、USAspending MCP と併用してください。

事業体と除外情報のすべての回答には、ソースファイル名と日付が含まれます。公開表示をオプトアウトした事業体は、ホステッド版の公開ミラーに含まれません。検索結果が見つからなくても、その事業体が未登録であるとは限りません。登録情報に基づいて判断する前に、SAM.gov で現在の登録状況を確認してください。除外情報の結果は、日付付きの公開ファイルに基づく確認結果です。重要な情報は SAM.gov で確認してください。

登録が有効であっても、SBA 認証が現在有効であるとは限りません。公開されている 8(a) コードは、記録上の認証終了日を過ぎても残っている場合があります。certificationExitDate を確認し、現在の認証状況を SBA に確認してください。

ローカルのフル版：さらに詳しく調べたい場合

フル版には、ホステッド版のすべての機能に加え、契約落札、下請け契約、表明事項と認証、過去の契約解除および法的手続きが含まれます。

フル版はローカル専用です。このページのリンクを AI に渡してセットアップを依頼するか、インストールから始めてください。ご自身で取得した無料の SAM.gov キーが必要で、そのキーには1日あたりの上限が適用されます。認証を参照してください。

機能

7 つの SAM.gov REST API と認証情報の準備状況チェックを、20 個の MCP ツールとして公開します。

エンティティ管理（v3）

• lookup_entity_by_uei - レスポンスのセクションを設定できる、単一 UEI の検索
• lookup_entity_by_cage - CAGE コードによる検索
• search_entities - 柔軟なエンティティ検索（NAICS、PSC、事業形態、州、名称など）
• get_entity_reps_and_certs - FAR/DFARS の表明および認証（明示的にリクエストする必要があります）
• get_entity_integrity_info - FAPIIS の訴訟手続きデータ

除外（v4）

• check_exclusion_by_uei - 単一 UEI の資格停止チェック
• search_exclusions - 名称、分類、プログラム、機関、日付による、より広範な除外検索

契約機会（v2）

• search_opportunities - 実用的なフィルター一式を使った契約機会の検索
• get_opportunity_description - 通知 ID による HTML の説明の取得

契約落札（v1）-- FPDS の代替

• search_contract_awards - 契約落札記録の検索（ベンダー、機関、NAICS、日付、金額、セットアサイドなど）
• lookup_award_by_piid - 単一 PIID のすべての変更を検索
• search_deleted_awards - 監査証跡用の削除済み落札記録の検索

連邦組織階層（v1）

• search_federal_organizations - 部門、機関、下位機関、オフィスを FH で検索（FH 組織 ID、名称、種別、ステータス、機関コード、CGAC で絞り込み）
• get_organization_hierarchy - 連邦組織の下位組織をたどる

調達下請け報告（FFATA 下請け契約）

• search_acquisition_subawards - FFATA 下請け契約報告の検索（元請け／下請けの関係、機関、日付、ステータス）

助成金下請け報告（FFATA 助成金下請け契約）

• search_assistance_subawards - FFATA 助成金下請け契約報告の検索（FAIN、元請け落札キー、機関、日付）

PSC 検索

• lookup_psc_code - PSC コードに対応する完全な記録を取得
• search_psc_free_text - フリーテキストによる PSC 検索

複合ワークフロー

• vendor_responsibility_check - FAR 9.104-1 のチェックを一括実行（1 回のツール呼び出しでエンティティと除外情報を確認）

認証

SAM_API_KEY 環境変数に設定した SAM.gov API キーが必要です。

SAM.gov Help にサインインし、Public API Key の手順に従うと、無料の個人 API キーを取得できます。

アカウント種別	1 日あたりの上限
非連邦、SAM のロールなし	10 回／日
非連邦、SAM のロールあり	1,000 回／日
連邦の個人アカウント	1,000 回／日
連邦のシステムアカウント	10,000 回／日

重要：SAM.gov API キーは 90 日ごとに有効期限が切れます。 SAM.gov Help でキーを確認または再発行し、環境変数を更新してください。このサーバーは、再発行手順を含む、明確で実行可能なエラーを 401／403 時に返します。

インストール

uvx を使用

uvx --refresh-package sam-gov-mcp --from sam-gov-mcp sam-gov-mcp

pip を使用

pip install sam-gov-mcp

ソースから

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

設定

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

{
  "mcpServers": {
    "sam-gov": {
      "command": "uvx",
      "args": ["--refresh-package", "sam-gov-mcp", "--from", "sam-gov-mcp", "sam-gov-mcp"],
      "env": {
        "SAM_API_KEY": "SAM-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}

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

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

プロンプトの例

設定が完了したら、以下の例を参考に、サーバーを単体で高度に活用できます。より幅広いリクエスト集は、メンテナンスされているMCP 向けリクエストライブラリをご覧ください。

• 「[UEI] のベンダー責任チェックを実施し、登録状況と除外情報を確認してから、FAPIIS の誠実性記録を別途取得してください。一度のチェックではそれらは含まれません。」
• 「[COMPANY] の登録状況、社会経済カテゴリー、および除外情報を取得してください。1 つの UEI に対して SAM が複数の登録を返した場合は、その旨を伝え、どれかを選ぶ前に一覧を表示してください。」
• 「[COMPANY] の担当者および証明書から FAR 52.212-3 と DFARS 252.204-7016 の回答を取得し（要約モード）、契約担当官が全文を読むべき項目に印を付けてください。」
• 「[COMPANY] の連邦政府受賞履歴は実際にはどこまでさかのぼれますか？契約受賞を 10 年ごとに、FY1970 から確認してください。1980 年より前は記録が少なくなるため、1 桁の年は欠落ではなく、アーカイブ上の記録として扱ってください。」
• 「[STATE] で NAICS [NAICS] に該当する、現在有効な 8(a) 認定企業（自己申告ではなく、SBA 認定）を見つけてください。」
• 「過去 30 日間の NAICS [NAICS] に該当する情報提供依頼通知を検索し、回答期限が早い順に並べてください。」
• 「今四半期に掲載された、IT サービス向けの SDVOSB 限定調達の公募情報を表示してください。」
• 「通知 ID [paste ID] の詳細な説明を取得し、SOW を要約してください。」
• 「[NAME] の除外情報を検索し、分類（企業、個人、船舶）、除外した機関、および各記録が有効かどうかを教えてください。」
• 「FY2026 の [COMPANY] の契約受賞を検索し、見つかった最も大きな PIID のすべての変更を調べてください。」
• 「今会計年度の国防総省の削除済み契約受賞記録を表示してください。」
• 「財務省の Federal Hierarchy ID を見つけ、子組織を 1 階層たどってください。」
• 「プライム PIID [PIID] に関連する FFATA の下請け契約を表示し、再交付額を合計してください。」
• 「助成金 FAIN [FAIN] の下で報告されたすべての再交付を取得してください。」
• 「CGAC 075（HHS）の機関レベルの組織を一覧表示してください。」

設計上の注意点

• 環境変数のみを使った認証。 SAM_API_KEY は呼び出しのたびに環境変数から読み取られます。キーがモデルの会話コンテキストに入ることはありません。
• 90 日間の有効期限への対応。 401／403 エラーは、最新の SAM.gov ヘルプへのリンクを含む、再生成を促す実用的なメッセージに変換されます。
• API の癖を安全策として組み込み。
  • Entity Management のサイズ上限 10 をクライアント側で適用し、明確なエラーを返します
  • Exclusions では limit ではなく size を使います（他の SAM エンドポイントとは異なります）
  • 国コードは ISO alpha-3 の 3 文字コードとして検証されます（2 文字コードはエラーなしで 0 を返します）
  • Accept: application/json ヘッダーは設定されません（設定すると Exclusions は 406 を返します）
  • 複数値パラメーターのクエリ文字列では、角括弧、チルダ、感嘆符を保持します
• 不具合のあるパラメーターへの後処理フィルタリング。 Opportunities API は deptname と subtier のフィルターを黙って無視します。search_opportunities は agency_keyword パラメーターを公開し、fullParentPathName の部分文字列との一致によって結果を後処理で絞り込みます。
• includeSections のデフォルト値。 エンティティ検索のデフォルトは entityRegistration,coreData です。他のセクションと併せて、必ず entityRegistration を含めてください。そうしないと、応答に識別情報が含まれません。includeSections=All でも repsAndCerts と integrityInformation は含まれないため、専用のツール呼び出し（get_entity_reps_and_certs、get_entity_integrity_info）が必要です。
• Contract Awards の応答の正規化。 Contract Awards API は、結果がある場合とない場合で異なる JSON ラッパー形式を返します。すべてのツールでこれを {"awardSummary": [...], "totalRecords": int} という一貫した形式に正規化します。エラー応答は JSON ではなくプレーンテキストです。これを検出し、実用的なエラーとして送出します。
• Contract Awards のページネーション。 Entity Management の page／size ではなく、limit／offset を使います。limit の最大値は 100 です。日付は MM/dd/yyyy 形式で、範囲には角括弧を使う必要があります（[MM/dd/yyyy,MM/dd/yyyy]）。
• 複合ワークフロー。 vendor_responsibility_check は、一般的な FAR 9.104-1 の確認（エンティティ登録と除外情報の検索）を 1 回のツール呼び出しにまとめ、後続の推論に使える構造化されたフラグのリストを返します。
• Federal Hierarchy の癖を安全策として組み込み。
  • キーは小文字の totalrecords と orglist です（SAM.gov の他の部分では camelCase が使われます）。正規化後も両方のキーを保持します
  • デフォルトの応答は ACTIVE のみです。status=ACTIVE を渡しても、フィルターなしの呼び出しと結果は変わりません。廃止された組織を含めるには INACTIVE を渡します
  • 実際の fhorgtype の値は Department/Ind. Agency のような形式ですが、API は省略形（DEPARTMENT、AGENCY）も大文字小文字を区別せずに受け付けます
• Subaward Reporting の癖を安全策として組み込み。
  • 日付には ISO 形式の yyyy-MM-dd を使います（Contract Awards の MM/dd/yyyy とは異なります）。形式を混在させると、ネットワークアクセス前の検証で明確なエラーが発生します
  • ページネーションには page／size や limit／offset ではなく、pageNumber／pageSize を使います
  • 2026 年 4 月のライブ監査で、ドキュメントに記載された 3 つのパラメーター名の大文字小文字が黙って無視されることが判明しました。PIID は無視されます（小文字の piid を使用してください）。referencedIdvPIID は無視されます（referencedIDVPIID を使用してください）。referencedIDVAgencyID は無視されます（referencedIDVAgencyId を使用してください）。サーバーでは、ワイヤーレベルの名前を正しい形式に修正済みです

関連プロジェクト

federal-contracting-mcps：連邦政府契約データ用の 9 つの MCP サーバーをまとめたモノレポです。これらの情報源と MCP prompt library を組み合わせてご利用ください。

ライセンス

MIT