Us Race Matchups

@pipeworx/us-race-matchups

米国下院の選挙区または上院議席の候補者は誰でしょうか。現職者、FECに登録されたすべての候補者と政党、各候補者の資金状況、予備選挙で勝利した候補者、そして予備選挙と本選挙の日程を確認できます。2026年中間選挙（本選挙は2026年11月3日）向けに構築されていますが、偶数年の選挙サイクルであれば利用できます。

Pipeworx の一部です。AI エージェントを1858以上の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流の提供元とは提携、承認、公開の関係にありません。

ツール

• race_matchup(state, office, district?, cycle?, special?) — 1つの選挙を返します。現職者、候補者（政党、現職者かどうか、総収入、支出、手元資金、各候補者の資金の対象期間終了日、won_primary）、投票数と得票率を含む予備選挙結果の表、予備選挙、決選投票、本選挙の日程を返します。候補者がいない選挙区を指定すると、候補者がいる選挙区を示すエラーが返されます。そのサイクルに上院選挙がない州では、その旨が返されます。予備選挙の結果表がない選挙では、空のリストではなく primary_results_note にその旨が記載されます。
• list_races(state, office?, cycle?) — 州内のすべての選挙について、登録候補者数と現職者を返します。選挙区番号を調べるときに使用します。

認証

プラットフォームキー（ゲートウェイがFECパック用にすでに保持している共有data.govキー）を使用します。呼び出し元から渡すものはありません。

データソース

• FEC、候補者および委員会の提出書類 — 候補者、政党、現職者かどうか、収入、支出、手元資金。連邦政府の公開記録です。
• FEC、選挙日程 — 予備選挙、決選投票、本選挙の日程。
• Wikipedia、2026年の選挙ページ — 予備選挙の投票数と、次の段階に進んだ候補者。これはボランティアが編集した情報源であり、公式のものではありません。各レスポンスにはその旨と、ページが引用する州の選挙管理機関（例：「アイオワ州務長官」）が記載されます。予備選挙の数値は参考情報として扱い、重要な判断には州の選挙管理機関の情報を確認してください。

次の利用者が同じ調査を繰り返さずに済むよう、注意点を記載します。

• FECの資金情報には、財務概要が提出されていない登録者は含まれません。該当する候補者は financials_on_file: false と資金情報のnull値で示されます（ゼロではなくnullです）。
• won_primary はIDの照合によるものではなく、推定値です。予備選挙の表にはFEC IDがないため、登録者は姓と政党で照合し、候補者が複数該当する場合は名で絞り込みます。won_primary_match に照合方法（inferred_by_surname_and_party、no_match、ambiguous）が示されます。2人の登録者を区別できない場合、won_primary は null になります。照合フィールドがなく null の場合、予備選挙の表が見つかっていません。
• incumbent は、FECが現職者として示す在職者であり、必ずしも投票用紙に載る候補者とは限りません。seeking_reelection と incumbent_note を確認してください。FECがすべての登録者を「現職者なし」と分類している場合、現職者は候補者ではありません。
• 1人の人物が複数のFEC候補者IDを持つことがあります。race_matchup はこれらを1人の候補者にまとめます（メインの行は最新の提出書類がある登録情報で、残りは other_fec_registrations に記載されます。資金情報は合算されません）。list_races が数えるのはIDではなく人物です。
• FECが示す候補者の対象期間終了日が未来の場合、nullとして表示され、data_as_of から除外されます。
• カリフォルニア州など、大きな州のWikipedia情報は選挙区の範囲ごとに複数のサブページに分かれています。このパックはリンク先をたどります。
• オハイオ州とフロリダ州では、2026年に通常の上院選挙と特別選挙の両方があります。FECはこれらを州単位でまとめています。special: true を指定すると、特別選挙の予備選挙ページが読み込まれます。
• 自宅住所などの個人の連絡先情報は提供しません。

クイックスタート

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

{
  "mcpServers": {
    "us-race-matchups": {
      "url": "https://gateway.pipeworx.io/us-race-matchups/mcp"
    }
  }
}

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

https://gateway.pipeworx.io/us-race-matchups/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールに加え、共通ツールが約 30 個表示されます。接続の initialize レスポンスに正確なスコープが記載されており、その日の状況を確認する際はこれが確実な情報源です。

これは意図的な仕様であり、偶然の多重化ではありません。メタツールを使えば、このパックが扱わない質問にも対応できます。ask_pipeworx がカタログ全体から適切なツールを呼び出すため、2 つ目の MCP サーバーを追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

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

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

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

MCP クライアントを使わない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/race_matchup \
  -H 'Content-Type: application/json' \
  -d '{"state":"IA","office":"house","district":1}'

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

npm から実行する

@pipeworx/mcp-us-race-matchups は、Pipeworx ゲートウェイへのローカル stdio ブリッジです。MCP クライアントが npx で起動し、すべての呼び出しを上記と同じ https://gateway.pipeworx.io/us-race-matchups/mcp エンドポイントに転送します。ネットワーク接続が必要です。オフラインモードはありません。

{
  "mcpServers": {
    "us-race-matchups": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-us-race-matchups"]
    }
  }
}

キーがない場合は匿名で呼び出し、1 日あたり 50 回まで利用できます。無料アカウントを作成すると、1 日あたり 200 回まで利用できます。https://pipeworx.io/signup でキーを取得し、サーバーのエントリーに "env": { "PIPEWORX_API_KEY": "<your key>" } を追加してください。 キーはホスト型の接続と同じ方法で Bearer トークンとして送信されるため、呼び出しはそこでの利用と同じように計測され、課金されます。

デフォルトでは、このパックのツールのみが一覧表示されます。PIPEWORX_META_TOOLS=1 を設定すると、ask_pipeworx など、ゲートウェイ全体で使えるツールも一覧表示されます。

HTTPS プロキシ経由で接続する場合：Node 組み込みの fetch は、デフォルトでは HTTPS_PROXY を読み取りません。新しいバージョンの Node では、NODE_USE_ENV_PROXY=1 を設定するとプロキシが適用されます。お使いの Node のバージョンのドキュメントを確認してください。

ask_pipeworx と併用する

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントでもフルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Us Race Matchups data" })

ゲートウェイが適切なツールを選び、引数を自動で設定します。

詳細

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

ライセンス

MIT