@pipeworx/congress

Connect: https://gateway.pipeworx.io/congress/mcp · Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 5

US federal bills (House and Senate), members of Congress and roll-call votes, served from GovTrack’s public API (www.govtrack.us/api/v2), which mirrors the Library of Congress record from the 93rd Congress (1973) onward. Bill status, who voted what, who sponsors what. Free, no API key.

Why this matters for AI agents

For policy research, agents need to know what bills exist, who’s sponsoring them, where they are in the legislative process, and how votes broke. Congress.gov is the canonical record. Pair with Federal Register (rules implementing legislation) and USAspending (where the money goes after authorization).

Common flows:

• Bill search. “What bills are pending on AI regulation?” → search by keyword, filter by Congress and chamber.
• Bill detail. “Status of HR 9876?” → get full bill record with sponsor, cosponsors, committee referrals, recent action.
• Member lookup. “Who represents Colorado’s 1st district?” → member by state/district or by name.
• Vote tracking. Recorded votes by bill, member, or session.

Auth

None. GovTrack’s API is public and keyless; this pack sends no credential.

Search ranking (search_bills)

GovTrack’s q parameter is a loose keyword match with no relevance ordering — for “Lower Energy Costs Act” it reports ~4,300 matches and puts a 2014 salmon bill first, while H.R. 1 (118th), the bill literally so named, sits 86th inside its own Congress’s matches and beyond the 1,000-row offset GovTrack allows. order_by=relevance is rejected. So search_bills gathers candidates itself and ranks them locally:

• Candidates. One unfiltered page (100 rows) plus one page for each of the three most recent Congresses. If nothing yet contains the query phrase, it pages deeper into those Congresses (up to 300 rows each), then takes one page from each of the six Congresses before them. Pass congress to search a single Congress exhaustively (up to ~1,100 rows) — do this for a bill older than about six years.
• Ranking. Every title a bill has ever carried (display, short, short-partial, official) is scored: exact title, then a title containing the phrase (shorter wins), then all query words present (prefix-tolerant, so “lower” matches “Lowering”), then partial overlap. Ties go to the newer Congress. Each returned bill carries match (exact / phrase / all_words / partial / none) and matched_title.
• total is GovTrack’s loose-match count, not the number of bills about the subject; total_note says so in the payload, and ranking states that upstream order was not used.

Congress numbering

Congresses are numbered sequentially: 119th Congress = 2025-2027 (started Jan 2025), 118th = 2023-2025, etc. Bills carry their Congress number — HR1 of the 119th is a different bill than HR1 of the 118th.

Bill type prefixes

For “regular legislation” purposes, HR and S are the meaningful types. Resolutions don’t have force of law (HRES, SRES) or are limited (HJRES, SJRES — the latter can amend the Constitution if ratified).

Common pitfalls

• Bill status nuance. “Introduced” is the start. “Reported” by committee is meaningful progress. “Engrossed” / “passed chamber” matters. “Enrolled” / “presented to president” is near-final. Most bills die quietly in committee; “introduced” alone is weak signal.
• Companion bills. Identical legislation often introduced in both chambers as paired bills (HR 1234 + S 567). Both must pass. The Congress.gov API has cross-references; use them.
• Roll-call votes only. Many congressional decisions happen by voice vote or unanimous consent. Those don’t appear in roll-call records. “No vote against” doesn’t mean unanimous support.
• Committee referrals. A bill can be referred to multiple committees (sequential, joint, or split). It must clear all to advance. The committee structure matters more than the introduction.
• Member-vote alignment. Don’t equate “voted yes” with “supports.” Procedural votes (motion to recommit, cloture) often have substantive meaning that surface text doesn’t capture.
• Cosponsorship is cheap. Members cosponsor freely. A 100-cosponsor bill is meaningful; a 5-cosponsor bill in a 435-member House isn’t necessarily.

Tools

• search_bills — ANSWERS “what bills about X has Congress introduced” / “recent congressional bills on X” / “federal legislation about X” / “find the Act” — searches US FEDERAL congressional bills (US House &
• get_bill — Look up one congressional bill from GovTrack by its real-world identifier — congress number, bill type and bill number, e.g. the 118th Congress H.R. 1. Returns title, sponsor, current status with its
• get_members — Get current members of Congress with their name, party, state, district (for representatives), and contact information.
• get_votes — Get recent congressional votes on bills, newest first. Returns question, result, chamber, vote counts (yes/no/abstain), date, and related bill.
• get_recent_bills — List the most recent congressional bills — newest first by introduction date or by latest action. This tool takes NO subject or keyword: it returns whatever Congress touched most recently, so it can o