us-gov-data-mcp

米国政府データのためのMCPサーバー。連邦政府の契約がいつ期限切れになるか、昨年最も収益が多かった上場企業はどこか、AIアシスタントに尋ねてください。政府自身の記録と照合して検証できる回答が得られます。

米国財務省のUSAspending APIとSECのEDGAR XBRLデータに基づいています。スクレイピング不要、APIキー不要、アカウント不要、個人データも不要です。

なぜこれが存在するのか

これらの情報源はすべてを公開しているのに、ほとんどクエリを実行させてくれません。

usaspending.govは契約終了日で検索できません。 しかし、連邦契約の履行期間が終了すると、通常その業務は再競争にかけなければなりません。そして、その再競争は政府調達において最も確率の高い機会であり、入札公告が公開される数か月前から公開データで確認できます。

sec.govは一度に1社ずつしか提出書類を提供しません。 このサイトでは、収益が1,000億ドルを超える上場企業はどこか、最も多くの現金を保有しているのはどこか、といった質問をする方法がありません。SECのframes APIは、XBRLタグと期間形式をすでに知っていれば、約5,800社すべての提出者を1回の呼び出しで回答できます。

このサーバーは、それらのサイトでは答えられない質問に答えます。

Related MCP server: sec-edgar-mcp

4つのツール

find_expiring_contracts — 再競争

再入札が迫っている連邦契約を、現行受注者と残り日数とともに表示します。expiring_after_daysで入札リードタイムを設定します。来週終了する契約は準備する意味がないからです。

{
  "days_until_expiry": 120,
  "recipient": "PERATON ENTERPRISE SOLUTIONS LLC",
  "amount_usd": 682369225.00,
  "awarding_agency": "General Services Administration",
  "verify_url": "https://www.usaspending.gov/award/..."
}

search_federal_contracts

機関、キーワード、日付、または金額別の受注契約。誰が連邦業務を勝ち取っているか、ある機関が何に支出しているか、競合他社の履歴。

screen_public_companies

報告された任意の財務指標で、米国の全上場企業をランク付けします。

「2023年に収益が2,000億ドルを超えた企業はどこか？」

{ "company": "Walmart Inc.", "value": 648125000000, "unit": "USD",
  "period_end": "2023-12-31", "period_type": "annual",
  "verify_url": "https://www.sec.gov/Archives/edgar/data/104169/..." }

company_financial_history

1社の指標（収益、純利益、資産、キャッシュフロー）の報告履歴。重複排除され、各レコードにはフォームの種類と提出日が付いています。

すべて検証可能

各レコードには、その元となった政府の提出書類へのverify_urlが付いています。開いて比較してください。

これはAIが介在する場合に最も重要です。アシスタントが金額を報告したとき、その連鎖を信頼するのではなく、情報源と照合して確認できるべきです。値が公式記録と一致しない場合は、それはバグです。issueを開いてください。

このサーバーが処理してくれる3つの落とし穴

生のSECデータは3つの特定の方法で誤解を招きます。それぞれ静かに行われます。エラーではなく、もっともらしい間違った数値が得られるのです。

1. 10-Qは四半期と年次累計を同じ終了日で報告します。 提出書類間で純利益を比較すると、3か月の数値と9か月の数値が静かに混ざります。各レコードにはperiod_typeが付いており、それでフィルタリングできます。

2. 同じ事実が異なる値で複数の提出書類に繰り返し現れます。 今年の10-Kは昨年の数値を訂正再表示します。期間ごとに1レコードに重複排除され、最新の提出が優先されます。これはSEC自身の訂正再表示の扱いと同じです。

3. 企業は時間とともにXBRLタグを変更します。 Microsoftは2010年までRevenuesを提出し、その後は別のタグを使用しました。データを返す最初のタグを採用すると、古くて部分的な履歴になります。これはすべてのタグを統合します。

インストール

uvx --from git+https://github.com/groundtruthtools/us-gov-data-mcp us-gov-data-mcp

Claude Desktop — claude_desktop_config.jsonに追加:

{
  "mcpServers": {
    "us-gov-data": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/groundtruthtools/us-gov-data-mcp",
        "us-gov-data-mcp"
      ],
      "env": { "SEC_USER_AGENT": "Your Name your@email.com" }
    }
  }
}

あらゆるMCPクライアントで動作します: Claude Desktop、Claude Code、Cursor、VS Code。

SEC_USER_AGENTは設定する価値があります。 SECの公正アクセスポリシーでは、連絡先アドレスを含むUser-Agentが必要で、それがないリクエストは403になります。ツールがすぐに動作するようにデフォルトが含まれていますが、自分を特定することは礼儀であり、共有IDから離れることができます。

苦労して学んだ1つの癖: その文字列にURLを入れないでください。 SECはURLを含むUser-Agentに対して403を返します。Your Name your@email.comは機能しますが、github.com/...を追加すると機能しません。

まだPyPIにはないため、リポジトリからインストールしてください。PyPIに公開されれば、これは単純なuvx us-gov-data-mcpになります。

正直な制限

• 契約: 受注済みであり、公開中の入札公告ではありません。 公開された入札については、SAM.govを使用してください。

• 契約: 連邦のみ、2008会計年度より前のデータはありません。

• 再競争検索は過去1年間に活動があった契約を対象とします。USAspendingが結果のページング深度に上限を設けているためです。長期間休眠状態の契約は表示されない場合があり、過度に広い検索では、自信を持って空のリストを返すのではなく、その旨が示されます。

• SEC: XBRLのカバレッジは2009年頃から始まり、企業が実際にタグ付けした概念のみを対象とします。小規模な提出者はタグ付けが少ないです。

• 報告はしますが、計算はしません。 比率、成長率、派生指標はありません。それらは提出書類ではなく私たちの算術であり、情報源と照合して検証できません。

• 投資助言ではありません。 これはデータ再フォーマットツールです。

Apifyでも利用可能

同じロジックがホスト型ツールとして実行され、インストールは不要です:

• US Federal Contract Awards & Recompete Finder

• SEC EDGAR Financial Data & Company Screener

データソースとライセンス

契約: USAspending.gov、米国財務省、DATA Actに基づき公開。 財務: SEC EDGAR、米国証券取引委員会。 どちらもパブリックドメイン。コード: MIT。