Congress Member Votes

@pipeworx/congress-member-votes

根据美国众议院书记官的唱名表决记录，了解每位众议员如何投票、出席了多少次，以及投票与所属政党一致的频率。

属于 Pipeworx — 一个将 AI Agent 连接到 1875+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未获其认可，也非由其发布。

工具

• member_vote_positions(bioguide_id | name [+ state], bill?, question_contains?, from_roll?, to_roll?, limit?, congress?, session?) — 返回一位众议员在唱名表决中的立场（赞成、反对、出席、未投票或不在名单上），按时间从新到旧排列。回答“X 议员如何对 Y 法案投票”。
• member_attendance_party_line(bioguide_id | name [+ state], from_roll?, to_roll?, congress?, session?) — 返回一位众议员在某个会期或唱名表决范围内的出席情况及与党派一致的投票比例。每项数据都会标明分母和排除项；无法计算的数据会返回 null 并说明原因，绝不会返回 0% 或 100%。
• roll_call_positions(roll_number, party?, state?, position?, congress?, session?) — 返回一次唱名表决中每位众议员的立场，并附上党派统计。

派生数据的含义

• 出席率分母：范围内该众议员在名单上的唱名表决次数。法定人数表决和议长选举不计入（并计入 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 200 占位响应，而不是 404；程序包会将其视为“无此表决”，并将任何其他非记录响应视为故障。

快速开始

添加到 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 服务。目前无法在不包含这些工具的情况下挂载工具包端点；如果额外的架构定义消耗的上下文超出了路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 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