Dod Contract Announcements

@pipeworx/dod-contract-announcements

DoD 契約発表 MCP — 米国の 750 万ドル以上の防衛契約について、契約が締結された営業日に Department of War（旧 Department of Defense）が発表する情報です。

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

ツール

• dod_awards_recent(days=7, service?, min_amount?, limit=25) — 最新の発表を新しい順に取得します。
• dod_awards_search(query?, contractor?, since?, limit=25) — 請負業者名または説明文のキーワードで検索します。query／contractor の少なくとも一方が必要です。
• dod_awards_top(days=30, by='contractor'|'service', limit=20) — 期間内の契約総額で請負業者または軍種をランキングします。ランキング対象の合計額から shared_award の行を除外し、別途報告します。
• dod_awards_coverage() — 行数、最も古い／新しい発表日、軍種別の内訳を取得します。

認証

不要です。キーは必要ありません。

データソース

• 上流ソース：https://www.war.gov/News/Contracts/（省の改称に伴い、defense.gov は現在 war.gov にリダイレクトされます）。
• war.gov の契約フィードで公開されるのは直近 500 営業日までのため、対象範囲はそれより前には遡れません。

先行記録と遅行記録

これは防衛契約の先行記録です。契約締結日に発表され、同じ契約が FPDS／USAspending に掲載される数週間前に確認できます。「今日／今週、何が契約されたか」を調べるには、このパックを使用してください。受領者の階層、NAICS、履行場所、義務額と支出額などを含む、遅行する完全に構造化された相互参照済みの履歴記録には、usaspending パックを使用してください。

データに関する注意事項

• shared_award: true は、その行が複数契約者に関する段落に由来することを示します。amount は記載された全契約者にまたがるプログラムの合計額であり、特定の契約者の取り分ではありません。dod_awards_top は既定でこれらをランキングの合計額から除外し、別途報告します。
• amount_is_ceiling: true は、ソースで金額が「最大」「上限額」または「見積額」と記載されていることを示します。確約された義務額ではありません。
• およそ 1% の行では、contract_number が null です。
• completion_date は、正規化された日付ではなく、ソースの自由記述（例：「Aug. 27, 2032」）です。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "dod-contract-announcements": {
      "url": "https://gateway.pipeworx.io/dod-contract-announcements/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/dod-contract-announcements/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall、その他のゲートウェイ全体で共通するツール）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールと合わせて、共有ツールがおよそ 30 個表示されます。接続の initialize 応答には正確な対象範囲が記載され、その日の状況を確認するための正式な情報源となります。

これは意図的な設計であり、偶然に多重化しているわけではありません。メタツールを使えば、パックの対象外の質問にも、カタログ全体にルーティングする ask_pipeworx を通じて対応でき、MCP サーバーを追加する必要がありません。現時点では、これらを含めずにパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキストコストがルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

また、フル Pipeworx ゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと、同じ 1878 以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

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

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

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

スタンドアロン（ゲートウェイアカウント不要）

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

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

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

npx -y @pipeworx/mcp-dod-contract-announcements

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

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。上記のパックエンドポイントだけでなく、ゲートウェイ全体でも利用できます。

ask_pipeworx({ question: "your question about Dod Contract Announcements data" })

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

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT