Congress Member Votes

@pipeworx/congress-member-votes

米国下院書記官の記名投票記録をもとに、各下院議員の投票内容、出席頻度、党の方針に沿って投票する頻度を確認できます。

Pipeworx の一部です。AI エージェントを1,875以上のライブデータソースに接続するMCPゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携、推奨、公開のいずれも行っていません。

ツール

• member_vote_positions(bioguide_id | name [+ state], bill?, question_contains?, from_roll?, to_roll?, limit?, congress?, session?) — 1人の議員が各記名投票で示した立場（賛成、反対、出席、未投票、または投票名簿に記載なし）を新しい順に返します。「議員Xは法案Yにどう投票したか」に答えます。
• member_attendance_party_line(bioguide_id | name [+ state], from_roll?, to_roll?, congress?, session?) — 1人の議員について、会期または記名投票の範囲における出席状況と党方針に沿った投票の割合を返します。各数値には分母と除外対象が明示され、算出できない数値は、理由を示したうえで null となります。0％や100％にはなりません。
• roll_call_positions(roll_number, party?, state?, position?, congress?, session?) — 1回の記名投票について、各議員の立場と党別の集計を返します。

算出される数値の意味

• 出席率の分母：範囲内の記名投票のうち、議員が投票名簿に記載されていたものです。定足数確認の投票と議長選挙は除外され（excluded_rolls に計上）、attended は賛成＋反対＋出席、missed は未投票です。
• 投票名簿に記載がないことは、未投票とは異なります。 投票名簿に一度も記載されていない議員（就任前、または退任後）は分母から除外し、not_on_roll_excluded に別途計上します。
• with_party_majority：議員の賛成・反対票のうち、所属政党の賛成・反対投票者の単純過半数と同じ投票をした割合です。大差の投票も含むため、この数値は高くなります。党内で票が同数の投票は除外し、別途計上します。
• party_unity：同じ指標ですが、民主党議員の過半数が共和党議員の過半数に反対した投票に限定します。
• 議長は投票した場合にのみ投票名簿に記載されるため、議長の未投票数は算出できません。この理由を添えて出席状況は null で返されます（党方針に沿った投票の割合は、投じられた票をもとに算出されます）。
• 党派は、その議員が最後に記名投票した時点での所属政党です。無所属議員には民主党と共和党の過半数が存在しないため、党方針に沿った投票の数値は算出されません。

認証

認証情報は不要です。

対応範囲

下院のみ。第119議会の第1会期および第2会期に対応しています。それ以外の議会および上院については、該当する理由を返します。上院の記名投票記録は読み取れませんでした。2026-10-23、上院書記官のサイトは、このサービスからのすべてのリクエストと別のマシンからのすべてのリクエストを拒否し、HTTP 403 を返しました。

データソース

• 米国下院書記官、記名投票記録。米国連邦政府のデータで、パブリックドメインです。

記名投票は、scripts/bake-congress-member-votes.mjs（更新処理）によって生成される、議員と投票の対応をまとめたコンパクトなテーブルとして保存され、デプロイ時にアップロードされてパックに組み込まれます（pack-baked-indexes.json）。テーブルより新しい投票は呼び出しごとに書記官のサイトからライブで読み取られます（最大40件）。そのため、各応答には対象となる最終投票（rolls_covered）、ライブで追加された件数（live_topup）、データの基準日時（data_as_of）が示されます。ライブでの読み取りに失敗した場合は、その旨を応答し、保存済みの投票のみを対象とします。

書記官のサイトは存在しない投票に対して HTTP 404 ではなく HTTP 200 のスタブを返します。このパックはこれを「該当する投票なし」として扱い、それ以外のレコードではない応答本文はエラーとして扱います。

クイックスタート

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

{
  "mcpServers": {
    "congress-member-votes": {
      "url": "https://gateway.pipeworx.io/congress-member-votes/mcp"
    }
  }
}

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

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

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

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

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

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

MCP クライアントをお持ちでない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/member_vote_positions \
  -H 'Content-Type: application/json' \
  -d '{"bioguide_id":"P000197","bill":"H CON RES 14","congress":119,"session":1}'

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

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

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

{
  "mcpServers": {
    "congress-member-votes": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-congress-member-votes"]
    }
  }
}

または、直接実行して起動を確認します。

npx -y @pipeworx/mcp-congress-member-votes

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

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Congress Member Votes data" })

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

詳細

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

ライセンス

MIT