mcp-sam-gov

---

実際の動作を見る

👤  user        Find active SAM.gov solicitations under NAICS 541512 closing this month
                                                                                          
🤖  Claude     → sam_search_opportunities { ncode: "541512", limit: 5 }                  
✓  47,478 active opportunities indexed                                                  
                                                                                          
   • 5ef3db5d…  VA Bulk Oxygen Tank Rental         closes 2026-05-15  ($1.05M)         
   • a000339c…  Articulating Boom Lifts             closes 2026-05-30  ($310K)          
   • be9c24ef…  CMOP Hazardous Waste Removal        closes 2026-06-12  ($2.7M)          

👤  user        Pull the SOW + contracting officer for the first one
                                                                                          
🤖  Claude     → sam_get_opportunity { noticeId: "5ef3db5d…" }                          
✓  Department of Veterans Affairs · Combined Synopsis/Solicitation                       
   POC:           Contracting Officer  <[email protected]>  +1-XXX-XXX-XXXX             
   Set-aside:     Total Small Business                                                    
   Attachments:   1   ↓ 36C24526Q0460_1.docx (172 KB)                                     
   SOW preview:   "RFQ# 36C24526Q0460 — Bulk Oxygen Tank Rental, Fill, Telemetry…"        

153個のツールのうち148個は、APIキーも登録もサインアップも不要です。 接続して質問するだけです。

---

開発の背景

現状	このMCPを使うと
GovWin：1席あたり年間$30K-$100K	無料、MITライセンス
APIキーを登録 → 24時間待つ → クォータのプランを選ぶ	npm install → 60秒で利用開始
5つ以上の個別ベンダーAPI／スクレイパー	54のデータソースにまたがる153個のツールを、1つの統合インターフェースで提供
LLMがNAICSコードや機関名を幻覚する	幻覚を防ぐオートコンプリートガードを内蔵
脆弱なスクレイピングが毎週壊れる	毎日のライブスモークテスト（上のバッジ）
調達担当者 → ITチケット → 3週間待ち	Claude Desktopでダブルクリックしてインストール

このツールが扱う連邦政府データはパブリックドメインです。検索に5桁の金額のサブスクリプション料金がかかるべき理由はありません。

---

Claude（およびその他の AI エージェント）にできること

分野	依頼できること	情報源
🔍 案件・公募	「NAICS 541512 に該当し、今月締め切りの SAM.gov の公募を探して」――作業明細書（SOW）、連絡先（POC）、添付ファイルを確認	SAM.gov、Grants.gov
💰 支出、受注、競合	「昨会計年度に VA で Booz Allen が受注した案件を表示して。DoD の PSC カテゴリ上位 10 件も」	USAspending、FPDS、GAO
🕵️ 事業体・パートナーの審査	「この企業を審査して：OFAC 制裁、SAM の除外情報、単一監査の指摘事項、銀行の健全性、EPA 法令遵守状況と有害物質排出情報」	OFAC、SAM、FAC、FDIC、EPA ECHO、EPA Envirofacts
🛒 製品安全・リコール	「このサプライヤーの製品について、FDA／NHTSA／CPSC によるリコールや法執行措置はある？」	openFDA、NHTSA、CPSC
⚖️ 訴訟・裁判所	「この請負業者に関連する、連邦請求裁判所での入札異議申し立てや連邦巡回区控訴裁判所の判決はある？」	CourtListener（Free Law Project）
🏢 非営利団体のベンダー	「この非営利団体に業務を委託する前に、IRS 990 の財務情報を取得して」	IRS 990（ProPublica 経由）
🏥 医療提供者・施設	「この医療提供者の Medicare 利用状況と支払額、病院の品質評価を調べて。資格取り消しリストに掲載されている？」	CMS（data.cms.gov）
📈 財務情報開示（SEC）	「この上場企業の売上高の推移と最新の 10-K 提出書類を取得して」	SEC EDGAR
⚖️ 規制・法令	「今四半期に VA のサイバーセキュリティ規則は公表された？ Regulations.gov に意見募集中の案件はある？」	Federal Register、Regulations.gov、eCFR、FAR／DFARS、Congress.gov、GovInfo
💲 価格、労働、財政	「システムアナリストの GSA CALC の賃金幅、この郡の SCA 賃金決定、CPI による価格調整、出張の日当上限、産業別の地域 GDP、DOL の賃金・労働時間に関する法執行履歴を調べて」	GSA CALC、SAM WDs、BLS、US Census CBP、FRED、BEA、US Treasury、GSA per-diem、US DOL
🏛 ロビー活動・影響力	「誰がサイバーセキュリティについて VA にロビー活動をしていて、支出額はいくら？」	US Senate LDA
🏥 医療・研究資金	「このテーマに関する NIH／NSF の助成金、参加者を募集している臨床試験、この医師への業界からの支払いを調べて」	NIH RePORTER、NSF、ClinicalTrials.gov、CMS Open Payments、NPPES
🛡 サイバーセキュリティコンプライアンス	「この CVE は CISA の KEV 必須パッチ適用リストに載っている？」	NVD、CISA KEV
🌐 貿易、地理、防災	「この製品の HTS 関税、この住所の国勢調査区画、この州の FEMA 災害宣言を調べて」	USITC HTS、US Census、FEMA、Socrata、CKAN
🏙 州・地方自治体の調達入札（SLED）	「この市／郡の調達ポータルで現在募集中の案件は？　会計データ、落札契約、ベンダーへの支払い、州運輸局の入札・落札記録も調べて」	OpenGov Procurement（525 以上の政府機関）、Bonfire、ArcGIS（feature + Hub）、Socrata（54 のホスト）、Tableau Server Guest ビュー 1 件（Montana）、Socrata Open Expenditures の会計データ 1 件（South Dakota）
🎓 助成金・データセット	「過去 30 日間に掲載されたサイバーセキュリティ助成金を調べて。連邦政府のオープンデータセットも探して」	Grants.gov、data.gov

54 のデータソースにわたる 153 個のツール――キー不要を優先：無料キーが必要なのは 4 つのソース（Census の business-patterns、FRED、BEA、DOL の data endpoint）のみで、残り 50 は不要です。（以前の 52 ツールのビルドでは、本番の連邦 API に対しておよそ p50 ～0.25 秒／p95 ～0.8 秒を計測しました。レイテンシはソースや上流の負荷によって変わるため、ベンチマークで保証された値ではなく、高速な目安としてお考えください。）

---

インストール方法：ご自身に合った方法をお選びください。

🟢 方法 1 — Claude Desktop にワンクリックでインストール（ターミナル不要）

開発者以外の方に最適です。ファイルをダウンロードしてダブルクリックするだけです。

1. 最新リリースから mcp-sam-gov.mcpb をダウンロードします。
2. ファイルをダブルクリックします。Claude Desktop が「拡張機能をインストール」ダイアログを開きます。
3. インストールをクリックします。
4. 完了です。新しい会話を開始し、「NAICS 541512 に該当する募集中の SAM.gov の案件を探して」と尋ねてください。

以上です。PowerShell も npm も必要ありません。

Claude Desktop ≥ 1.0 が必要です（Node.js ランタイムが付属しています）。

🟡 パス 2 — Claude Code、ワンコマンド

Claude Code（CLI）をすでにお使いの場合：

/plugin install cliwant/mcp-sam-gov

これにより、MCP サーバーに加えて、各153個のツールをいつ、どのように使うかを Claude に教えるワークフローガイド SKILL.md もインストールされます。

🔵 パス 3 — あらゆる MCP ホスト向けの手動インストール（Codex、Cursor、Continue、Gemini）

Codex CLI／Cursor／Continue／Gemini CLI／MCP に対応するその他の環境の場合：

gh repo clone cliwant/mcp-sam-gov
cd mcp-sam-gov
npm install --omit=dev
npm install -g .

インストール後、バイナリ mcp-sam-gov が PATH に追加されます。ホストの設定に以下を追加してください：

{
  "mcpServers": {
    "sam-gov": {
      "command": "mcp-sam-gov"
    }
  }
}

ホストごとの具体的な設定場所については、以下のホストの設定を参照してください。

グローバルインストールをしない場合は？ 以下の各ホスト設定には、clone と npm install -g を省略する npx 版（npx -y @cliwant/mcp-sam-gov）もあります。必要なのは Node.js だけです。

⚪ パス 4 — 直接パス指定（インストール不要、ファイルを指定するだけ）

インストールを完全に省略します：

gh repo clone cliwant/mcp-sam-gov
cd mcp-sam-gov
npm install --omit=dev   # only runtime deps; dist/ is pre-built

次に、ホストの設定で絶対パスを指定します：

{
  "mcpServers": {
    "sam-gov": {
      "command": "node",
      "args": ["C:\\Users\\you\\mcp-sam-gov\\dist\\server.js"]
    }
  }
}

---

ホストの設定

以下の各ホストには、2種類の設定方法があります。どちらかを使用してください：

• グローバルインストール：「"command": "mcp-sam-gov"」を指定します。Path 3 の npm install -g で mcp-sam-gov バイナリが PATH に追加された場合にのみ動作します。
• グローバルインストールなし（npx）：「"command": "npx", "args": ["-y", "@cliwant/mcp-sam-gov"]」を指定します。必要なのは Node.js だけです。npx は初回起動時に npm からパッケージをダウンロードし、キャッシュします。

パッケージ名： npm パッケージはスコープ付きの @cliwant/mcp-sam-gov です。mcp-sam-gov は、グローバルインストールによって PATH に追加されるバイナリの名前にすぎません。スコープなしの mcp-sam-gov パッケージは npm に存在しないため、npx -y mcp-sam-gov は404エラーになります。npx -y @cliwant/mcp-sam-gov を使用してください。

Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json（Windows）または ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

グローバルインストール：

{
  "mcpServers": {
    "sam-gov": { "command": "mcp-sam-gov" }
  }
}

グローバルインストールなし（npx）：

{
  "mcpServers": {
    "sam-gov": { "command": "npx", "args": ["-y", "@cliwant/mcp-sam-gov"] }
  }
}

Windows で %APPDATA%\Claude\logs\mcp*.log に spawn npx ENOENT と表示され、サーバーの起動に失敗する場合は、npx を cmd /c でラップしてください：

{
  "mcpServers": {
    "sam-gov": { "command": "cmd", "args": ["/c", "npx", "-y", "@cliwant/mcp-sam-gov"] }
  }
}

（または、これらの手順をすべて省略して、パス 1 の .mcpb を使えば自動的に設定されます。）

Claude Desktop を完全に再起動します（Windows ではシステムトレイから終了、macOS では「終了」メニューを選択）。次に 🔨 アイコンを探してください。「sam-gov (153 tools)」が表示されます。

Claude Code

プロジェクトごとの .mcp.json、グローバルインストール：

{ "mcpServers": { "sam-gov": { "command": "mcp-sam-gov" } } }

グローバルインストールなし（npx）：

{ "mcpServers": { "sam-gov": { "command": "npx", "args": ["-y", "@cliwant/mcp-sam-gov"] } } }

または CLI を使用します：

# global install
claude mcp add sam-gov mcp-sam-gov

# no global install (npx)
claude mcp add sam-gov -- npx -y @cliwant/mcp-sam-gov

Codex CLI

~/.codex/config.toml：

グローバルインストール：

[mcp_servers.sam-gov]
command = "mcp-sam-gov"
args = []

グローバルインストールなし（npx）：

[mcp_servers.sam-gov]
command = "npx"
args = ["-y", "@cliwant/mcp-sam-gov"]

Cursor

設定 → MCP → 新しい MCP サーバーを追加。グローバルインストール：

{ "mcpServers": { "sam-gov": { "command": "mcp-sam-gov" } } }

グローバルインストールなし（npx）：

{ "mcpServers": { "sam-gov": { "command": "npx", "args": ["-y", "@cliwant/mcp-sam-gov"] } } }

Continue

~/.continue/config.json、グローバルインストール：

{
  "experimental": {
    "modelContextProtocolServer": {
      "transport": { "type": "stdio", "command": "mcp-sam-gov" }
    }
  }
}

グローバルインストールなし（npx）：

{
  "experimental": {
    "modelContextProtocolServer": {
      "transport": { "type": "stdio", "command": "npx", "args": ["-y", "@cliwant/mcp-sam-gov"] }
    }
  }
}

Gemini CLI

~/.gemini/settings.json、グローバルインストール：

{ "mcpServers": { "sam-gov": { "command": "mcp-sam-gov" } } }

グローバルインストールなし（npx）：

{ "mcpServers": { "sam-gov": { "command": "npx", "args": ["-y", "@cliwant/mcp-sam-gov"] } } }

VS Code

プロジェクトのルートに .vscode/mcp.json を追加します（VS Code では "mcpServers" ではなく "servers" を使用します）：

{
  "servers": {
    "sam-gov": {
      "command": "npx",
      "args": ["-y", "@cliwant/mcp-sam-gov"]
    }
  }
}

または、このページの上部にあるワンクリックバッジを使って、ブラウザーから直接インストールできます。

Kiro

このページの上部にあるワンクリックバッジを使ってサーバーを追加します。Kiro で npx コマンドがあらかじめ入力されたインストールダイアログが開きます。

その他の環境

ホストが stdio 経由の MCP に対応している場合は、mcp-sam-gov（グローバルインストール）または npx -y @cliwant/mcp-sam-gov（グローバルインストールなし）を指定してください。ホスト固有のコードは不要です。

---

どんな質問ができますか？

インストール後は、自然言語で質問できます。エージェントが適切なツールの実行順序を自動的に選びます。

検索

• "NAICS 541512 의 메릴랜드 입찰 중 30일 안에 마감되는 것 찾아줘"
• "NAICS 541512 の有効な SAM.gov 公告のうち、メリーランド州限定で、30日以内に締め切られるものを検索して"
• "「computer systems design」の標準的な NAICS コードは何ですか？"

RFP 分析

• "noticeId 5ef3db5daeb54099a96d487783a38bd0 を取得して、作業範囲（SOW）、契約担当官、添付ファイルを教えて"
• "その公告の RFP 本文全体を表示して"

競合状況

• 「前会計年度にNAICS 541519でVA契約を最も多く受注した上位5社」
• 「DISAにおけるBooz Allenの個別の受注を表示してください」
• 「LeidosのVA契約の下請け業者は誰ですか？」
• 「USAspendingにおけるCMSとは何ですか？（略称を特定してください）」

傾向と集計

• 「過去5会計年度で、VAの541512への支出はどのように推移しましたか？」
• 「541512における連邦政府の契約支出額が多い州の上位10州」
• 「DoDで支出額が多いPSCカテゴリ」
• 「サイバーセキュリティ関連の連邦助成金プログラムを総額順に表示してください」

政府機関のインテリジェンス（案件獲得ブリーフ）

• 「VAの案件獲得ブリーフを作成してください。ミッション、FY26予算の内訳、主要な下位機関を含めてください」
• 「FY25のVAの取引件数はいくつですか？」

再競争レーダー

• 「今後12か月以内に期限が切れる、100万ドル超のVA 541512契約」
• 「契約番号CONT_AWD_...の履行期間を取得してください」

規制・立法

• 「SDVOSBのセットアサイド要件に関するFARの条項を探してください」
• 「このRFPで引用されているFAR／DFARS条項の一覧を、Section L／Mのコンプライアンスマトリックスにまとめてください」
• 「今四半期に新たに公表されたVAのサイバーセキュリティ規則はありますか？」
• 「本日、DoDからFederal Registerの公開前閲覧デスクに文書が届いていますか？」
• 「Regulations.govで「contractor cybersecurity」のドケットを検索し、パブリックコメントを取得してください」
• 「data.govで「wildfire」に関する連邦政府のオープンデータセットを探してください」
• 「Federal Registerに文書番号2026-08333はありますか？引用情報を取得してください」

パートナー・法人の審査

• 「「Acme Defense LLC」をOFACの制裁リストとSAMの除外リストに照らして審査してください」
• 「NPPESでNPI 1234567890を調べてください。この医療提供者は有効ですか？」
• 「この下請け業者はFederal Audit Clearinghouseで不利なSingle Auditの所見を受けていますか？」
• 「認証番号#3510の銀行の健全性はどうですか？リスク比率と四半期財務情報を確認してください」
• 「この上場企業の売上高の推移と最新の10-KをSEC EDGARから取得してください」
• 「この施設にEPAのコンプライアンス違反や執行措置の記録はありますか？」

コンプライアンス・適格性

• 「NAICS 541512におけるSBAの中小企業規模基準は何ですか？」
• 「eCFRで規則の正確な文面を検索してください」
• 「リチウムイオン電池の米国輸入関税率（HTS）はいくらですか？」

価格・労務・財政

• 「上級システムアナリストのGSA CALC上限料金の範囲」
• 「メリーランド州ボルチモア郡のSCA賃金決定を探し、付加給付率を教えてください」
• 「エスカレーション条項に使うため、過去3年間でCPI-Uはどれくらい上昇しましたか？」
• 「現在の米国の公的債務総額はいくらですか？（Debt to the Penny）」

サイバー

• 「CVE-2021-44228（Log4Shell）はCISAのKEV必須パッチリストに含まれていますか？期限はいつですか？」

医療・研究資金

• 「昨年資金提供を受けた、mRNAワクチンに関するNIH RePORTERプロジェクト」
• 「企業がスポンサーとなっている、糖尿病の募集中の臨床試験」
• 「CMS Open Payments Researchデータセットにおける、カリフォルニア州の医師への企業からの支払い」

助成金

• 「過去30日間に掲載されたサイバーセキュリティ助成金」
• 「助成金ID 361238を取得してください」

---

任意 — 高いレート制限とアーカイブ

MCP サーバーはデフォルトでキー不要で動作します。SAM.govのレート制限を引き上げ、完全なアーカイブ（約12か月より前の通知を含む）を利用するには、ホストの環境変数ブロックでSAM_GOV_API_KEYを設定してください。

{
  "mcpServers": {
    "sam-gov": {
      "command": "mcp-sam-gov",
      "env": { "SAM_GOV_API_KEY": "your-key-here" }
    }
  }
}

sam.gov/SAM/pages/public/searchKeyData.jsfで無料のキーを取得してください。エージェントにキーを知らせる必要はありません。キーの使用は透過的です。

DATA_GOV_API_KEY — api.data.gov／api.gsa.govファミリー

一部のデータソースは、共有のapi.data.govゲートウェイ（Congress.gov、GovInfo、Regulations.gov、FAC、GSAの日当、およびdata.gov v4データセットカタログ）を経由します。公開用のDEMO_KEY（共有される低い時間あたりの割り当て）を使い、初期設定のままキー不要で利用できます。これらの制限を大幅に引き上げるには、DATA_GOV_API_KEYを設定してください。

{
  "mcpServers": {
    "sam-gov": {
      "command": "mcp-sam-gov",
      "env": { "DATA_GOV_API_KEY": "your-key-here" }
    }
  }
}

api.data.gov/signupで無料のキーをすぐに取得できます（待ち時間はありません）。同じキーをすべてのapi.data.gov／api.gsa.govデータソースで使用できます。SAMキーと同様、キーはリクエスト送信時にのみ使用され（ログには記録されません）。未設定の場合はDEMO_KEYが使用されます。BLSのデータソースでも、任意の無料のBLS_API_KEYを設定すると、1日あたりの割り当てを引き上げられます。

キーと上限の引き上げ — 全一覧

ほとんどのツールはキーなしで使えます。 4つのデータソースでは無料キーが必須です。Census（census_business_patterns）、FRED（fred_search_series、fred_series_observations）、BEA（bea_regional_data）、DOL のデータエンドポイント（dol_get_dataset）にはキーなしで使えるプランがないため、キーを設定しないとツールはエラーになります。（DOL のカタログ dol_list_datasets はキーなしで使えます。）その他のキーは任意です。レート制限の緩和、または単一のフィルターの有効化にのみ使われます。以下のキーはすべて無料です。

環境変数	必須？	有効になる機能	無料登録
CENSUS_API_KEY	必須	census_business_patterns（キーなしで使えるプランがないため、設定しないとエラーになります）	api.census.gov/data/key_signup.html
FRED_API_KEY	必須	2つの FRED ツール（キーなしで使えるプランがないため、設定しないとエラーになります）	fred.stlouisfed.org/docs/api/api_key.html
BEA_API_KEY	必須	bea_regional_data（BEA Regional。キーなしで使えるプランがないため、設定しないとエラーになります）	apps.bea.gov/API/signup
DOL_API_KEY	データ取得には必須	dol_get_dataset（X-API-KEY を使った DOL の取り締まり記録。dol_list_datasets カタログはキーなしで使えます）	dol.gov/developer
DATA_GOV_API_KEY	任意	すべての api.data.gov データソース（Regulations.gov、Congress.gov、GovInfo、FAC、data.gov カタログ、GSA per-diem）の上限を引き上げます。共有の DEMO_KEY 上限が緩和されます	api.data.gov/signup
SAM_GOV_API_KEY	任意	認証済みの SAM.gov v2 検索と組織名フィルター	open.gsa.gov/api/get-opportunities-public-api
LDA_API_KEY	任意	lda_search_filings（Senate LDA のロビー活動）のレート制限を引き上げます（デフォルトではキーなしで使えます）	lda.senate.gov/api/register
BLS_API_KEY	任意	BLS v2 の利用枠（キーなしの場合は1日約25件のクエリ、キーありの場合は約500件）	data.bls.gov/registrationEngine
NVD_API_KEY	任意	NVD のレート制限を引き上げます（cve_lookup）	nvd.nist.gov/developers/request-an-api-key
OPENFDA_API_KEY	任意	openFDA のレート制限を引き上げます（openfda_enforcement、openfda_device_clearances。どちらもキーなしで使えます）	open.fda.gov/apis/authentication
COURTLISTENER_API_TOKEN	任意	CourtListener のレート制限を引き上げます（courtlistener_search_opinions。キーなしで使えます）	courtlistener.com/help/api/rest
SOCRATA_APP_TOKEN	任意	Socrata のスロットリング制限を引き上げます	evergreen.data.socrata.com/signup

キーを設定する方法は2つあります。どちらかを選んでください。

1. ホストの環境変数ブロック — 上記の例にある "env": { … } オブジェクト。
2. サーバーの作業ディレクトリにある .env ファイル — キーを一度だけ設定します。

   CENSUS_API_KEY=your-key-here
   FRED_API_KEY=your-key-here
   # optional — raise limits / unlock filters
   SAM_GOV_API_KEY=your-key-here
   

   サーバーは起動時に .env を自動で読み込みます。実際の環境変数は常に .env より優先されます（標準の優先順位）。また、.env は Git の追跡対象外のため、キーがコミットされることはありません。

サーバーに必要なキーを確認できます。 キーなしで使える api_key_status ツールには、すべてのキー、必須か任意か、無料登録 URL と有効になる機能、各キーが現在設定されているか（ブール値。キーの値は表示されません）が一覧表示されます。登録 URL でアカウントを作成するのが唯一の手動作業です。サーバーがキーの確認（api_key_status）と設定（.env）を自動で行います。キーが実際に機能することを確認するには、そのデータソース専用のツールを呼び出してください。

ツールセットの選択（コンテキストの縮小）

デフォルトでは、153 個すべてのツールが読み込まれ、セッションあたり約 74k トークンを使用します。コンテキストのコストを全額負担するクライアント（Claude Desktop、Cursor、生の API）では、タスクに関連するツールセットだけを読み込むことで、大幅に削減できます。

MCP_SAM_GOV_TOOLSETS 環境変数に、ツールセット名をカンマ区切りで指定してください（大文字と小文字は区別されません）。すべてのツールを再び読み込むには、空欄にするか、all を設定します。

トークン数は概算で、各 tools/list エントリのコンパクトな JSON の文字数を 4 で割って算出しています。 feedback と api_key_status は、どのプロファイルでも常に読み込まれます（有効なツールセットに関係なく、エージェントが問題を報告したり、キーの状態を確認したりするのに役立ちます）。

ツールセット	ツール数	トークン数の概算	内容
core	60	~17k	SAM.gov の検索／添付ファイル／賃金決定／除外／完全性、Grants.gov、USAspending 全般、FPDS、GAO、FAR／eCFR／Federal Register、SBA、OFAC のスクリーニング、GSA の労働料金ベンチマーク、api_key_status、feedback（常に読み込み）
sled	13	~7k	州／地方（SLED）の調達：OpenGov、Bonfire、ArcGIS、Socrata、data.gov／CKAN、Tableau、Open Checkbook、search.gov ドメイン
vetting	17	~10k	パートナーのデューデリジェンス：FAC、FDIC、EPA ECHO／TRI、CourtListener、非営利団体（IRS 990）、上院 LDA ロビー活動
disclosure	8	~5k	SEC EDGAR の財務書類と XBRL フレーム
regulatory	9	~4k	Regulations.gov、Congress.gov、GovInfo
pricing	15	~9k	GSA の日当、BLS、Treasury、BEA、Census の事業所パターン、FRED、DOL、USITC HTS
health	17	~12k	CMS、NPPES、NIH、NSF、ClinicalTrials.gov、openFDA
safety	3	~2k	NHTSA の車両リコール、CPSC の消費者向け製品リコール
geo	8	~5k	Census のジオコード、FEMA の災害、NWS の警報、CBP の国境待ち時間、data.gov カタログ
cyber	3	~2k	NVD CVE、CISA KEV、NIST SP 800-53
all	153	~74k	すべて（デフォルト）

設定例：

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "sam-gov": {
      "command": "npx",
      "args": ["-y", "@cliwant/mcp-sam-gov"],
      "env": { "MCP_SAM_GOV_TOOLSETS": "core,sled" }
    }
  }
}

Claude Code（コマンドライン）：

claude mcp add sam-gov -e MCP_SAM_GOV_TOOLSETS=core,sled -- npx -y @cliwant/mcp-sam-gov

Claude Desktop バンドル（.mcpb ／マニフェストの user_config）：拡張機能の設定ダイアログで Toolsets フィールドを設定します（空欄 = すべて）。

読み込まれていないツールセットに属するツールを呼び出すと、サーバーはツールセット名と、設定すべき正確な環境変数を示す構造化された tool_not_loaded エラーを返します。提案される値は、現在読み込まれているセットと必要なセットの和集合です（例：core を読み込んでいるときに vetting のツールを呼び出すと、MCP_SAM_GOV_TOOLSETS=core,vetting）。これにより、既存のプロファイルが気づかないうちに置き換えられることはありません。空の結果を気づかないうちに返すこともありません。

---

最新の状態を保つ

npm はインストール済みユーザーに新しいバージョンを通知しないため、このサーバーが最小限の通知を行います。起動時に、サーバーは自身の最新バージョンを確認するため、公開 npm レジストリに匿名リクエストを 1 回送信します。新しいバージョンがある場合に限り、stderr に 1 行だけ出力します（例：a newer version is available: 1.7.0 → 1.8.0）。使用状況データは送信されません（テレメトリではなく、バージョン確認です）。プロトコルの stdout には一切触れず、ノンブロッキングで、最新の状態なら何も表示しません。

• 更新： npm i -g @cliwant/mcp-sam-gov@latest — または、設定で npx @cliwant/mcp-sam-gov@latest を使っている場合は、再起動するだけです。
• 無効化： MCP_SAM_GOV_NO_UPDATE_CHECK=1（または NO_UPDATE_NOTIFIER=1）を設定します。
• 変更内容： リリースページ + CHANGELOG。

バグを見つけましたか？機能を追加してほしいですか？ワンステップで報告できます

このサーバーは、実際の利用を通じて改善するように構築されています。ツールを呼び出すのは人間ではなく AI エージェントのため、フィードバックの経路はエージェントを介します。

• 「何かが壊れているかもしれない」という2種類のエラー — schema_drift（連邦 API の形式が変更された場合）と upstream_unavailable（サービス停止） — では、エラーエンベロープに report フィールドが含まれます。これは、エージェントが提示できる、内容が事前入力された GitHub の issue リンクです。
• または、エージェントに「バグを報告して」「この結果は間違っているようです」「X ができるといいのに」と伝えるだけで、エージェントは**feedback ツール**を呼び出し、開いて送信できる、内容が事前入力された issue リンクを返します。

投稿が自動的に行われることはありません。 サーバーにはトークンもアカウントもなく、リンクを作成するだけです。リンクを開いて送信するのは、あなた自身です。内容が事前入力されたリンクに含まれるのは、ツール名、エラーの種類、サーバーのバージョンのみで、クエリの値は含まれません。リポジトリは公開されているため、機密情報があれば先に削除してください。

こちらから直接開くこともできます：新しい issue — バグ／機能／誤った出力のテンプレートです。

ツールカタログ（153 ツール）

ワークフロー別に分類しています。まずはキー不要のツールから — ほとんどのツールにキーは不要です。Census の business-patterns、FRED、BEA、DOL のデータエンドポイントには無料のキーが必要で、ほかにも任意の無料キーを使うと上限が引き上げられるツールがいくつかあります（上記に記載）。説明は簡潔にまとめています。各ツールの inputSchema に、完全な仕様と制約事項が記載されています。

案件・公募 — SAM.gov + Grants.gov（10 ツール）

• sam_search_opportunities — SAM.gov の募集中の契約案件を、キー不要の HAL 検索で検索します
• sam_search_shaping — 公告前の案件を調べます（RFP が作成される前の Sources Sought／Presol／Special Notices）
• sam_get_opportunity — 32 文字の 16 進数 noticeId を指定して詳細を取得します（POC + 添付ファイル + 本文）
• sam_fetch_description — RFP の本文全体をプレーンテキストで取得します
• sam_fetch_attachment_text — PDF + DOCX + テキスト／HTML から添付ファイルのテキストを抽出します（RFP／SOW／Q&A／賃金表）
• sam_attachment_url — 添付ファイルの resourceId に対する公開ダウンロード URL を作成します
• sam_lookup_organization — 連邦機関の ID から正規の fullParentPathName を取得します
• sam_lookup_notice_fields — オプトインの GSA 日次 CSV から、1～100 件の noticeIds の null 値になっている naics／set-aside／PoP／期限を一括で補完します
• grants_search — Grants.gov の連邦助成金案件を検索します（SAM の契約とは異なる資金援助）
• grants_get_opportunity — id を指定して、単一の助成金案件の詳細を取得します

支出、受注、競争 — USAspending + FPDS + GAO（31 ツール）

- `usas_search_awards` — 庁 × NAICS 別のシェア・オブ・ウォレットを集計します - `usas_search_individual_awards` — 明細レベルの連邦政府契約を検索します（generatedInternalId を返します） - `usas_get_award_detail` — 契約の全詳細：履行期間、オプション、優先枠、競争状況 - `usas_search_awards_by_recipient` — 庁 × NAICS の範囲で、受領者が獲得したすべての契約を検索します - `usas_search_subawards` — 元請契約に含まれる下請契約を列挙します（サプライチェーン／チーミング） - `usas_search_recompetes` — 再競争の動向を把握します（期間内に履行期間が終了する契約を、終了が早い順に表示し、黙って除外しません） - `usas_search_expiring_contracts` — **非推奨**。`usas_search_recompetes` の別名（従来の形式） - `usas_analyze_incumbent` — 契約ごとの現行受注者と、公開情報に基づく再競争圧力のヒントを表示します（スコアではなくラベル） - `usas_search_teaming_partners` — 認証 × NAICS × 庁で中小企業のチーミング候補を検索し、除外対象を確認します - `usas_spending_over_time` — 契約支出の時系列（会計年度／四半期／月） - `usas_search_agency_spending` — 契約機関別に支出を分類します - `usas_search_subagency_spending` — 上位機関の支出を下位機関／事務所別に分類します - `usas_search_psc_spending` — 製品・サービスコード（PSC）別の支出 - `usas_search_cfda_spending` — CFDA 助成プログラムコード別の支出 - `usas_search_state_spending` — 州／準州別の支出 - `usas_search_federal_account_spending` — 連邦勘定／財務省勘定記号（TAS）別の支出 - `usas_search_recipients` — 上位／下位の階層を含む受領者リスト - `usas_get_recipient_profile` — 受領者の全詳細（UEI、別名、合計額） - `usas_get_agency_profile` — 上位機関コードによる機関プロフィール（使命、略称、ウェブサイト） - `usas_get_agency_awards_summary` — 会計年度の受注状況（取引件数＋義務額） - `usas_get_agency_budget_function` — 機関 × 会計年度の予算機能別内訳 - `usas_list_toptier_agencies` — すべての上位機関と当会計年度の義務額 - `usas_lookup_agency` — 「VA」／「DHS」を正式な上位機関名と4桁コードに解決します - `usas_autocomplete_naics` — 幻覚を防止する NAICS 検証 - `usas_autocomplete_recipient` — 幻覚を防止する受領者検証 - `usas_naics_hierarchy` — NAICS ツリー（2→4→6）をたどり、コードごとの有効な契約数を表示します - `usas_glossary` — 連邦支出に関する用語151件 - `usas_list_disaster_codes` — 災害緊急基金コード（DEFC）を一覧表示します：COVID-19、IIJA／インフラ、その他の緊急歳出タグ - `usas_disaster_spending` — 指定した DEFC による災害／緊急基金の地域別支出（COVID／IIJA の救済資金をどの州／郡／地区が獲得したか） - `fpds_search_awards` — FPDS-NG の連邦契約受注アクション（権威ある受注アクションのデータフィード） - `gao_protest_lookup` — 公開されている Legal-Products RSS フィードから、最近の GAO 入札抗議決定を検索します（直近の期間のみ）

事業体・パートナーの審査 — OFAC · SAM · FAC · FDIC · EPA（15個のツール）

- `ofac_screen_entity` — キー不要の OFAC 拒否対象者／制裁スクリーニング - `sam_check_exclusions` — 名前および／または UEI/CAGE による、キー不要の SAM 資格停止／除外スクリーニング - `sam_integrity_lookup` — 1 回の呼び出しで整合性をスクリーニング（除外判定＋正確な FAPIIS 参照先） - `fac_search_audits` — Federal Audit Clearinghouse の単一監査の概要 - `fac_get_findings` — エンティティの監査リスクに関する所見を詳しく確認 - `fdic_search_institutions` — FDIC 預金保険対象機関のディレクトリを検索 - `fdic_institution_financials` — 1 機関の四半期財務時系列データ（証明書番号で指定） - `fdic_risk_ratios` — 1 機関の取引先リスク比率 - `fdic_institution_history` — 構造変更イベントログ（合併、認可変更） - `fdic_branch_deposits` — 支店別預金の分布 - `fdic_bank_failures` — 過去の銀行破綻と支援取引 - `fdic_industry_summary` — 業界および州の銀行セクターの年間集計 - `echo_search_facilities` — 州ごとに EPA 規制対象施設を検索し、コンプライアンス／執行状況をスクリーニング - `echo_facility_report` — 1 施設の EPA ECHO 詳細施設レポート（FRS RegistryID で指定） - `epa_tri_facilities` — 州／業種ごとの EPA Envirofacts TRI（有害物質排出目録）施設（環境／ESG 審査）

製品安全とリコール — openFDA · NHTSA · CPSC（6 ツール）

• openfda_enforcement — FDA の医薬品／医療機器／食品のリコールと執行措置（製品安全に関するサプライヤー審査）
• openfda_device_clearances — FDA 510(k) 医療機器の認可（医療機器メーカーの能力確認）
• openfda_drug_approvals — openFDA Drugs@FDA の医薬品承認申請（スポンサー、承認済み製品、申請／承認履歴）
• nhtsa_recalls — メーカー／モデル／年式ごとの NHTSA 車両リコール
• nhtsa_complaints — メーカー／モデル／年式ごとの NHTSA 車両安全性に関する苦情
• cpsc_recalls — CPSC 消費者向け製品のリコール（製品サプライヤー審査）

訴訟と裁判所 — CourtListener（2 ツール）

• courtlistener_search_opinions — 米国連邦裁判所の判決意見（COFC 契約請求／入札異議申し立て、連邦巡回区控訴裁判所）；実際の当事者が関与する訴訟には party パラメーターを使用 — データ提供元：CourtListener / Free Law Project（明示）
• courtlistener_search_dockets — 意見書が作成されることの少ない FCA／False Claims Act／qui tam 事案の RECAP 事件記録（type=r）；suitNature フィールドによる絞り込み — データ提供元：CourtListener / Free Law Project（明示）

非営利団体のベンダー — ProPublica 経由の IRS 990（2 ツール）

• nonprofit_search — 名前／州／NTEE による IRS-990 非営利団体検索 — ProPublica Nonprofit Explorer 経由（明示）
• nonprofit_financials — EIN による IRS-990 非営利団体の財務情報 — ProPublica Nonprofit Explorer 経由（明示）

財務開示 — SEC EDGAR（8 ツール）

• edgar_lookup_cik — 企業のティッカーまたは名前を 10 桁の SEC CIK に変換
• edgar_company_filings — 企業の SEC 提出書類
• edgar_company_facts — 提出者の厳選された XBRL 財務データ
• edgar_company_concept — 1 提出者 × 1 XBRL 概念 × 報告済み時系列データ全体
• edgar_xbrl_frames — 提出者横断の XBRL 横断面データ（ある期間における全提出者の 1 概念）
• edgar_full_text_search — 2001 年から現在までの EDGAR 提出書類全文検索
• edgar_filing_index — 四半期ごとの提出者横断一括提出書類インデックス
• edgar_daily_filing_index — 提出者横断の日次提出書類インデックス

規制と立法 — Federal Register · Regulations.gov · eCFR · FAR · Congress · GovInfo（19 ツール）

- `fed_register_search_documents` — クエリ／機関／種別／日付で連邦官報の文書を検索 - `fed_register_get_document` — 番号を指定して文書の詳細を取得（引用情報、本文 URL、CFR 参照） - `fed_register_public_inspection` — 連邦官報の公開閲覧窓口（公示前） - `fed_register_list_agencies` — 連邦官報の機関スラッグ一覧 - `regulations_search_dockets` — Regulations.gov の規則制定案件を検索 - `regulations_search_documents` — Regulations.gov の規則制定文書を検索（規則、規則案、告示） - `regulations_search_comments` — 規則制定に関するパブリックコメントを検索 - `regulations_get_docket` — Regulations.gov の案件を ID で取得 - `ecfr_search` — CFR 全体を対象に全文検索（FAR の場合は titleNumber=48）。順位付きの抜粋と ecfrUrl を返します - `ecfr_get_section` — 引用情報を指定して CFR の条項の全文を取得（任意のタイトル。FAR／DFARS では `far_clause_lookup` を推奨） - `ecfr_list_titles` — CFR 全50タイトルと最終改正日 - `far_clause_lookup` — FAR／DFARS 条項の正式な本文と適用規定（正確な条項番号を指定） - `far_search` — FAR／DFARS に限定した検索（GSAM を除外し、現在有効なバージョンに集約） - `far_compliance_matrix` — 引用された条項一覧から、提案書向けの Section L/M コンプライアンスマトリックスを作成（適格性の判定条件を明示） - `congress_search_bills` — Congress.gov の法案／立法を検索 - `congress_get_bill` — 議会／種別／番号を指定して法案を取得 - `govinfo_search_packages` — コレクション内の GovInfo（GPO が正式に提供する情報）パッケージを検索 - `govinfo_get_package` — GovInfo パッケージの概要とダウンロードリンクを取得（txt/xml/pdf/mods） - `govinfo_list_collections` — GovInfo コレクションのカタログ

価格設定、労働力、財政 — GSA CALC · SAM WDs · BLS · Census CBP · FRED · BEA · US Treasury · GSA per-diem（15 ツール）

• gsa_benchmark_labor_rates — GSA CALC による、職種別の落札上限レートの市場帯（単一価格ではなく分布）
• sam_search_wage_determinations — 地域別の SCA／Davis-Bacon 賃金決定を検索
• sam_get_wage_rates — 賃金決定（WD）から解析した標準賃金と福利厚生／H&W の料率表、および EO の最低賃金下限
• bls_timeseries — BLS 時系列データ（CPI-U／ECI による価格調整、PPI、雇用）— 価格設定／価格調整レイヤー
• bls_oews_wages — 地域×職種別の基準職業賃金と雇用（BLS OEWS）
• bls_qcew — 郡×NAICS 別の市場規模／賃金／立地係数（競合密度）
• treasury_debt_to_penny — 米国の公的債務残高の日次合計（財務省 Fiscal Data）
• treasury_avg_interest_rates — 証券種別ごとの財務省の平均支払金利
• treasury_monthly_statement — 月次財務省報告書：月別の歳入、歳出、財政赤字／黒字
• treasury_query_dataset — 確認済みの財務省 Fiscal Data 7 データセットを対象とする拡張クエリ
• bea_regional_data — 産業×地域別の GDP／個人所得（BEA Regional。無料の BEA_API_KEY が必要）
• census_business_patterns — NAICS×地域別の事業所数／雇用／年間給与（Census CBP。無料の CENSUS_API_KEY が必要）
• fred_search_series — FRED マクロ経済時系列カタログを検索（GDP／CPI／金利／失業率。無料の FRED_API_KEY が必要）
• fred_series_observations — FRED 時系列の観測値（欠損値は null。無料の FRED_API_KEY が必要）
• gsa_perdiem_rates — 連邦政府の出張日当：市と州、または ZIP コード別の月次宿泊費と M&IE 食費の上限（DEMO_KEY でキー不要）

医療と研究助成 — NIH · NSF · ClinicalTrials · CMS · NPPES（9 ツール）

- `nih_reporter_search_projects` — NIH RePORTER の採択済み研究助成プロジェクト - `nsf_search_awards` — NSF の採択済み研究助成 - `nsf_get_award` — 数値の award id で指定した 1 件の NSF 助成 - `clinicaltrials_search_studies` — スポンサー／資金提供者の情報を補足した、連邦政府に登録済みの臨床研究 - `clinicaltrials_get_study` — NCT id で指定した 1 件の臨床研究（簡単な概要を含む） - `clinicaltrials_facet_counts` — 登録簿全体における値ごとの正確な研究件数の分布 - `cms_search_datasets` — CMS Open Payments（Sunshine Act）のデータセットを検索 - `cms_query_dataset` — CMS Open Payments のデータストア配布データを検索（業界から医師への支払い） - `nppes_lookup_provider` — CMS/HHS NPPES NPI Registry でプロバイダーを検索

医療提供者と施設 — CMS（5 ツール）

• cms_medicare_provider_services — Medicare の医療提供者の利用状況と支払い（医療市場の規模推定）
• cms_hospital_compare — CMS Hospital Compare の品質評価
• cms_facility_directory — CMS の介護施設／在宅医療／ホスピス／透析施設のディレクトリ
• cms_dmepos_suppliers — CMS DMEPOS（耐久医療機器）サプライヤーのディレクトリと Medicare 支出
• cms_revoked_providers — CMS Medicare の取消／除外リスト（プロバイダーのコンプライアンス審査）

サイバーコンプライアンス — NVD + CISA KEV + NIST 800-53（3 ツール）

• cve_lookup — NIST NVD の CVE レコードを検索
• cisa_kev_lookup — CISA Known Exploited Vulnerabilities カタログを絞り込み（拘束力のある BOD 22-01 の修正期限）
• nist_800_53_controls — NIST SP 800-53 Rev 5 のセキュリティおよびプライバシー管理策を検索（controlId／family／keyword で FedRAMP/CMMC/RMF の要件テキストを検索）

貿易、関税、物流 — USITC · CBP（2 ツール）

• hts_lookup — USITC Harmonized Tariff Schedule に基づく米国輸入関税の分類と税率
• cbp_border_wait_times — CBP の陸上国境における商用車のリアルタイム待ち時間（カナダおよびメキシコの港湾。貨物／物流向け）

地理、災害、州・地方自治体のオープンデータ — Census · FEMA · NWS · Socrata · CKAN（10 ツール）

• census_geocode_address — 1 行の米国住所を対応する住所と Census の地理区分（tract、CD、place）に解決
• census_geographies_by_coordinates — 経度／緯度の地点を Census の地理区分に解決
• fema_disaster_declarations — 州、種類、事案、年で FEMA の災害／緊急事態宣言を検索
• fema_search_public_assistance — FEMA の Public Assistance による資金提供プロジェクト
• fema_search_hazard_mitigation — FEMA Hazard Mitigation Assistance のプロジェクト（州／地方自治体／部族のサブ受給者向け HMGP/FMA/PDM/BRIC 緩和助成。災害レジリエンス関連で、Public Assistance による復旧支援とは別）
• nws_active_alerts — 現在有効な NWS の気象警報（災害／気候への備え向けの注意報／警報／勧告。FEMA ツールと併用できます）
• socrata_discover_datasets — キーワードで Socrata データセットの 4x4 ID を検索
• socrata_query — 許可リストにある Socrata/SODA オープンデータポータルから行を検索（州／郡／市および連邦政府の厳選されたホスト 54 件 — SLED レベル全体の小切手台帳、契約、ベンダーへの支払い、公開中の入札）
• ckan_discover_datasets — キーワードで CKAN データストアのリソース ID を検索
• ckan_query — 許可リストにある CKAN データストアのリソースから行を検索（州／市の支出／小切手台帳）

州・地方自治体の調達入札（SLED） — OpenGov · Bonfire · ArcGIS · Tableau · Open Checkbook（8 ツール）

- `opengov_list_governments` — **OpenGov Procurement**を利用する525以上の米国の州・地方自治体のディレクトリ（州／クエリで絞り込み） - `opengov_search_solicitations` — 自治体の**公開中の公募案件**（タイトル、ステータス［open = 受付中］、締切日、ポータルリンク）— キー不要の匿名エンドポイント - `bonfire_list_organizations` — **Bonfire (Euna)**を利用する米国の組織を、公開情報で確認した187組織分収録する厳選ディレクトリ - `bonfire_search_opportunities` — キー不要のRSSを通じて組織の現在募集中の案件を取得します（referenceNumber、name、closeDate、link）。RSSには募集中の案件すべてが含まれます（正確な総数）。 - `arcgis_hub_discover_datasets` — キーワードでArcGIS Hubのデータセットを検索します（SLEDのGIS／インフラ／許認可／調達レイヤーのうち、SocrataとCKANではカバーされないもの。公開元を表示して審査できる、発見を支援するツールです）。 - `arcgis_feature_query` — 厳選された**米国政府のArcGIS RESTフィーチャレイヤー29件**から行を検索します：DC OCP PASSの公開中の公募案件、地方自治体の小切手帳／契約、**郡のCIPパイプライン（ミネソタ州ヘネピン郡、ノースカロライナ州シャーロット＝メクレンバーグ郡 — 公募案件一覧ではなく、資本プロジェクトのパイプライン）**、**州DOTの入札／落札情報（TX／AK／IA／OK）**、**ノースダコタ州DOTの連邦フレックス資金による4つの助成レイヤー**（郡、タウンシップ、市などの地方公共機関へのNDDOT資金提供の記録であり、ベンダー契約や落札入札ではありません。ノースダコタ州全体の小切手帳と調達ポータルにキーなしでアクセスできないため、代替指標として提供しています） - `tableau_view_csv` — 厳選された米国政府の**Tableau Server Guest**ビューからCSVエクスポート全体をキー不要で取得し、ページ単位で閲覧します。現在のビューは1つ：**モンタナ州DOA落札契約**（約4,554件の落札記録。更新頻度は公開元が設定しており、最新でない場合があります）。 - `open_checkbook_search` — 厳選された**Socrata Open Expenditures**小切手帳ポータルで、行単位のベンダー支払を検索します（キー不要。年度／ベンダー／部門／費目カテゴリの完全一致フィルター）。現在のポータルは2つ：**サウスダコタ州**（約740,980件の支払、直近約3会計年度分のみ）と**アラスカ州**（41,751件の支払、**FY2026のみ**。それ以外の年度はすべてcount:0を返しますが、これは「未公開」を意味し、支出ゼロを意味するものではありません）。更新頻度は公開元が設定しており、最新でない場合があるため、最新の日付を確認するにはpayment_dateの降順で並べ替えてください。

州のオープンデータマップ — MCPリソース（samgov://data-map/state-local。resources/readを介して任意のMCPクライアントで読み取り可能）およびskills/sam-gov/SKILL.mdでも利用できます。検証済みのキー不要データセットのうち最大のもの：テキサス州DIRの共同購入明細1,070万行＋TxDOTの公開中の入札募集412件（socrata_query data.texas.gov）、マサチューセッツ州CTHRUのベンダー支払約4,900万件、バージニア州eVAの発注書明細169万行（ckan_query data.virginia.gov）、ニュージャージー州YourMoneyの66万件、ワシントン州の契約＋マスター契約販売の合計32万5,000件。これらは州のオープンデータのミラーであり、州の公開中の入札ポータルではありません（TX TxDOTの入札募集が、最初の公開中公募案件フィードです）。CA、OH、NC、MI、およびTxDOT以外のTXポータルはログイン／WAFで保護されています。FLとGAには州のオープンデータポータルがなく（NXDOMAIN）、PAのポータルには調達データセットがありません。

データセットとレジストリの検索 — data.gov · get.gov（2ツール）

• datagov_search_datasets — data.gov v4カタログを検索し、あらゆる公開機関の連邦オープンデータセットを検索します
• search_gov_domains — CISA get.govの公的な.govドメインレジストリ（.govドメインの所有組織を特定し、連邦機関を列挙するとともに、SLEDの組織をマッピングします）

中小企業 — SBA（1ツール）

• sba_size_standard — 6桁のNAICSに対するSBAの中小企業規模基準（優先調達の適格性判定）

労働法令遵守 — US DOL（2ツール）

• dol_list_datasets — DOLの執行／法令遵守データセットを閲覧します（WHD、OFCCPなど）— キー不要のカタログ
• dol_get_dataset — DOLの執行記録を取得します（WHDの賃金・労働時間／OFCCP。無料のDOL_API_KEYが必要です）

ロビー活動と影響力 — US Senate LDA（1ツール）

- `lda_search_filings` — 上院のロビー活動報告：どのロビイストがどの機関に、どの課題について、いくらで働きかけているか（API キー不要）

サーバーユーティリティ — キーの確認 · フィードバック（2 ツール）

• api_key_status — サーバーが使用できる API キー、必須か任意か、登録 URL、およびそれぞれが現在設定されているかを一覧表示します（値は表示されません）
• feedback — バグ報告や機能リクエスト用の、内容があらかじめ入力された GitHub イシューへのリンクを返します。リンクを開いて自分で送信してください（このツールが何かを投稿することはありません）

---

信頼性とオフラインスナップショット

このサーバーは、自信ありげにでっち上げるより、正直に失敗するというルールを軸に構築されています。以下はすべて、公開データの可用性に関するものであり、アクセス制御を回避するものではありません。

まずは API キー不要の利用を優先し、ソースが停止している場合はエラーを返します。 54 のソースのうち 50（153 のツールのうち 148）は API キーなしで動作します。Census の business-patterns、FRED、BEA、DOL のデータエンドポイントには無料の API キーが必要です。ソースがレート制限、ブロック、または停止している場合、ツールは型付きエラー（rate_limited／upstream_unavailable／schema_drift／…）を返します。行を捏造したり、停止中のサービスについて「結果は 0 件」や「見つかりません」と報告したりすることはありません。実際に結果が空の場合と障害は、常に区別できます。

オフラインスナップショット（デフォルトで有効）。 参照データのなかには、変化が緩やかなものがあります。たとえば、toptier-agency の一覧、NAICS の最上位ツリー、USAspending の用語集、SBA のサイズ基準、最新の Treasury「Debt to the Penny」などです。デフォルトでは、利用環境からライブの連邦政府ソースに一時的にアクセスできない場合、サーバーは raw.githubusercontent.com/cliwant/mcp-sam-gov/snapshots でホストされている、週次更新の公開スナップショットにフォールバックします。取得はライブ接続の致命的な失敗時（障害／IP レピュテーションによるブロック）に限られ、通常の動作中には行われません。公開データのみを扱い、テレメトリもありません。提供されたスナップショットがライブデータとして表示されることはありません。レスポンスには _meta.dataPath: "snapshot" と asOf タイムスタンプが含まれ、complete は強制的にオフになるため、AI エージェント（および利用者）は常にデータの古さを確認できます。レート制限（429）は常に尊重され、ミラーに迂回されることはありません。

• 無効にする（ライブデータのみ）： SAMGOV_SNAPSHOT_BASE_URL=off を設定します。スナップショット経由の経路は追加されず、動作はライブデータのみのクライアントとバイト単位で同一になります。

• 独自のミラーを指定する： SAMGOV_SNAPSHOT_BASE_URL にベース URL を設定すると、デフォルトの公開ミラーの代わりに、自分でスナップショットをホストできます。

  { "mcpServers": { "sam-gov": { "command": "mcp-sam-gov",
      "env": { "SAMGOV_SNAPSHOT_BASE_URL": "off" } } } }
  

• スナップショットをビルドする： アクセスがブロックされていないクリーンな接続環境（ノート PC／自宅／クリーンな CI ランナー）から node scripts/build-snapshots.mjs を実行します。ソースごとの到達可能性を自己診断し、到達可能性の一覧を出力して、manifest.json を書き込みます。一部のソースにしかアクセスできない場合は、到達できるソースのみを更新し、残りは直近で正常だったファイルをそのまま保持します（古いデータであっても正直に示し、空にはしません）。終了コードが 0 以外になるのは、到達可能なソースが1 つもない場合（接続が完全にブロックされている状態）だけです。この場合は、よりクリーンな環境から再実行する合図です。

• 誠実さを保つための境界。 対象は公開データの可用性のみです。スナップショットのビルダーが取り込むのは、公開され、再配布可能な（パブリックドメイン／CC0）データのみです。また、リーダーは accessLevel: "public" とマークされていないデータを提供しません。レート制限を尊重し（429 を迂回することはありません）、プロキシ、IP ローテーション、認証／ペイウォール／CAPTCHA の回避を一切使用せず、ホスト外へのリダイレクトも拒否します。ソースがブロックされている場合の正当な対処は、よりクリーンな接続環境からビルドすることであり、ブロックを回避することではありません。

---

トラブルシューティング

症状	解決方法
Claude Desktop の 🔨 メニューに sam-gov が表示されない	Claude Desktop を完全に終了し（Windows ではシステムトレイ、macOS では終了メニューを使用）、再起動してください。%APPDATA%\Claude\logs\mcp*.log を確認してください
command not found: mcp-sam-gov	npm install -g . が正常に完了したことを確認してください。npm のグローバル bin が PATH に含まれているか確認してください（npm config get prefix）
spawn npx ENOENT（Windows、npx の設定）	ホストがシェルを使わずに npx を起動したため、Windows が npx.cmd を見つけられません。"command": "cmd", "args": ["/c", "npx", "-y", "@cliwant/mcp-sam-gov"] を使用してください。
npm install -g github:... の後に MODULE_NOT_FOUND ...dist/server.js が発生する	Windows で git-dep のシンボリックリンクに関する npm の不具合です。代わりにクローンして npm install -g . を実行する手順（パス 3）を使用してください。
インストール中に EPERM: operation not permitted, rmdir が発生する	以前のインストール失敗によって、削除されずに残ったファイルがあります。rmdir /s /q "%APPDATA%\npm\node_modules\@cliwant" を実行し（以前のバージョンをインストールした場合は @govicon）、その後もう一度お試しください。
npm install が "private repo" / 404 で失敗する	リポジトリは現在公開されているため、通常は発生しません。発生した場合は、git clone https://github.com/cliwant/mcp-sam-gov.git を直接お試しください。
ツールの結果が空になる	SAM.gov は、過度に頻繁に呼び出すクライアントをレート制限します。1 分待ってください。または、より高いレート制限が適用される認証済みの方法を使うため、SAM_GOV_API_KEY を設定してください。
"Tool error: USAspending POST returned 400"	通常、フィールドの型が間違っていることを意味します（例：会計年度が文字列になっている）。ホストのツールブラウザーでツールの入力スキーマを確認してください。

---

TypeScript / JavaScript ライブラリとして使用する（MCP なし）

MCP サーバーに加えて、このパッケージは基盤となる連邦政府データ用クライアントも、インポート可能なモジュールとしてエクスポートしています。独自の SaaS、AI エージェント、CLI を構築する際に、MCP サーバーを起動せずにプログラムからアクセスしたい場合に便利です。

npm install @cliwant/mcp-sam-gov

// SAM.gov client
import { SamGovClient } from "@cliwant/mcp-sam-gov/sam-gov";

const sam = new SamGovClient(); // keyless
const result = await sam.searchOpportunities({ ncode: "541512", limit: 5 });
const opp = await sam.getOpportunity("5ef3db5daeb54099a96d487783a38bd0");

// USAspending wrappers
import * as usas from "@cliwant/mcp-sam-gov/usaspending";

const recompete = await usas.searchExpiringContracts({
  agency: "Department of Veterans Affairs",
  naics: "541512",
  monthsUntilExpiry: 12,
});
const recipient = await usas.getRecipientProfile("ed02855e-60d7-2540-...-P");

// Federal Register / eCFR / Grants.gov
import * as fedreg from "@cliwant/mcp-sam-gov/federal-register";
import * as ecfr from "@cliwant/mcp-sam-gov/ecfr";
import * as grants from "@cliwant/mcp-sam-gov/grants";

const farResults = await ecfr.search({ query: "SDVOSB", titleNumber: 48 });

ここは Cliwant の連邦政府データ用ライブラリの正式なリポジトリです。別個のライブラリパッケージはありません。以前の 2 つのリポジトリ（govicon-sam-gov と govicon-mcp-sam-gov）はアーカイブされ、ここに統合されました。クライアントコードはすべて src/sam-gov/、src/usaspending.ts、src/federal-register.ts、src/ecfr.ts、src/grants.ts にあります。

プライバシーポリシー

このサーバーはローカルで実行され、何も収集しません。テレメトリー、分析データ、アカウントはありません。プロンプトと結果はお使いのマシン上のメモリで処理され、Cliwant に送信されることはありません。各ツールは、該当する政府の公式 API を HTTPS 経由で直接呼び出します。任意の API キーはローカル環境に保存され、その送信先にのみ送られます。詳細はプライバシーポリシーをご覧ください（連絡先：[email protected]）。

ライセンス

MIT — LICENSEをご覧ください。

免責事項

これは独立したオープンソースプロジェクトです。General Services Administration、SAM.gov、USAspending.gov、Office of the Federal Register、National Archives、Grants.gov、または連邦、州、地方政府の機関との提携、承認、支援を受けているものではありません。一般に公開されている政府のオープンデータエンドポイントのみを使用しています。連邦政府の調達、支出、規制に関するデータはパブリックドメインです。