govcontractscout-mcp

GovContractScout MCP サーバー

GovContractScout の米国州・地方・連邦政府契約 API を AI エージェントに提供する Model Context Protocol（MCP）サーバーです。稼働中の契約を検索し、詳細を取得し、NAICS コードを調べ、州の一覧を表示し、契約との適合度をスコアリングできます。生の HTTP を扱う必要はありません。

AI agent (Claude, Cursor, etc.)  ⇄  MCP  ⇄  GovContractScout /v1 API  ⇄  50-state procurement data

ツール

ツール	説明
search_contracts	州、NAICS、キーワードで政府の有効な契約を検索します（タイトル、機関、期限、適合シグナルを返します）
get_contract	ID を指定して契約の完全なレコードを取得します（元の公示リンクと書類を含みます）
search_naics	キーワードで NAICS コードを検索します
get_states	インデックス対象の州と稼働中の契約数を一覧表示します
score_contract	事業プロフィールとの契約の適合度をスコアリングします（/v1/match を使用）
win_likelihood	過去の落札企業の類型をもとに落札確率を推定します。派生データ、有料です
archetypes	落札企業の類型（どのような企業が何を落札するか）を一覧表示します。派生データ、有料です

すべてのツールは、公開 REST エンドポイントと同じ /v1 API を使用します。データ、認証、レート制限は共通です。州の調達ポータルから取得したリアルタイムデータを毎日更新しています。

ホスト型エンドポイント（インストール不要）

https://scout.govbidportals.com/mcp にリモートサーバーもあります。Streamable HTTP、プロトコルは 2025-06-18 で、インストールは不要です。上記のすべてに加えて get_profile を提供します（全 8 ツール）。

認証方法は 2 つあります。

1. OAuth 2.1 — 対応クライアントは独自に接続します。401 チャレンジで https://scout.govbidportals.com/.well-known/oauth-protected-resource が示されるので、その後サインインしてアカウントをリンクします。
2. API キーヘッダー — 固定ヘッダーのみを送信するクライアントは、REST API で使用するものと同じ gcs_live_... キーを指定できます。

curl -X POST https://scout.govbidportals.com/mcp \
  -H "Authorization: Bearer gcs_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-agent","version":"1"}}}'

どちらの認証情報も、ローカルで使用するキーと同じプラン、クォータ、レート制限が適用されます。

要件

• Node.js 18+
• GovContractScout API キー（gcs_live_...）— 無料プランでも利用できます（月 100 回の呼び出し）。本番環境向けには有料プランがあります。有料プランはアカウント不要です。 scout.govbidportals.com/docs/api#pricing で購入すると、決済時にキーがメールで送信されます。無料プランにはアカウントが必要です。scout.govbidportals.com/api-keys からすぐに利用できます。カードは不要です。

クイックスタート

Claude Code

claude mcp add govcontractscout \
  --env GCS_API_KEY=gcs_live_YOUR_KEY \
  -- npx -y govcontractscout-mcp

任意の MCP クライアント（mcp.json / mcp.settings）

{
  "mcpServers": {
    "govcontractscout": {
      "command": "npx",
      "args": ["-y", "govcontractscout-mcp"],
      "env": {
        "GCS_API_KEY": "gcs_live_YOUR_KEY"
      }
    }
  }
}

手動（ソースから）

npm install && npm run build
GCS_API_KEY=gcs_live_YOUR_KEY node dist/index.js

設定

変数	必須	デフォルト	説明
GCS_API_KEY	✅	—	ダッシュボードで取得した API キー
GOVCONTRACTSCOUT_API_BASE	❌	https://scout.govbidportals.com	API ベース URL の上書き（セルフホストする場合）

例

エージェントに次のように依頼します。

「カリフォルニア州で今月が期限の IT サービス契約を検索し、上位の契約について、T&M の経験がある 10 人規模のコンサルティング会社との適合度をスコアリングしてください。」

エージェントは search_contracts（state=CA、naics=IT services）を呼び出し、その後 score_contract を呼び出します。エージェントが HTTP の知識を持つ必要はありません。

設計上の注意点

• スコアリングの冪等性 — score_contract は決定論的な Idempotency-Key を送信するため、再試行してもクォータが二重に消費されることはありません。
• API と同じ優位性 — 一覧／検索結果では、意図的にソース URL と生の source_portal フィールドを除外しています（これが集約による優位性です）。get_contract の詳細には、API とまったく同じように元の公募リンクが含まれます。MCP が公開する情報は、API が公開する情報と同じです。
• データ範囲の誠実な開示 — 契約には data_quality フィールド（レベルと、どのフィールドにデータが入力されているか）が含まれます。州によってデータの充実度は異なりますが、API から取得できる内容を正確に確認できます。

API／料金

• 無料：月 100 回の呼び出し。アカウントが必要です
• 有料：アカウントは不要です — scout.govbidportals.com/docs/api#pricing で購入できます。キーは購入手続き時にメールで送信されます
• Starter $99/月 · Growth $199/月 · 年払いは 17% 割引
• win_likelihood と archetypes は 有料プラン（Starter 以上）向けです — 派生データレイヤー
• API ドキュメント全文：scout.govbidportals.com/docs/api

開発

npm run dev    # tsx watch
npm run build  # tsc -> dist/
npm start      # run built server

このサーバーは、公開 REST API（/v1/contracts、/v1/contracts/:id、/v1/naics、/v1/states、/v1/match）を薄くラップしています。スキーマについてはAPI ドキュメントを参照してください。

ライセンス

MIT