# Congress (npm · @pipeworx/mcp-congress)

Congress MCP — US Congress bill/law/member data via the official congress.gov API (Library of…

- Trust score: 90/100 (high trust)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-22

## Components

- remote · `gateway.pipeworx.io`: 87/100, [markdown](https://verifymcp.io/servers/pipeworx-io-congress/congress-mcp.md), [page](https://verifymcp.io/servers/pipeworx-io-congress/congress-mcp)
- npm · `@pipeworx/mcp-congress`: 90/100 (this document), [markdown](https://verifymcp.io/servers/pipeworx-io-congress/pipeworx-mcp-congress.md), [page](https://verifymcp.io/servers/pipeworx-io-congress/pipeworx-mcp-congress)

## Channel facts

- Registry: `npm`
- Package: `@pipeworx/mcp-congress`
- Version: `0.2.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-22.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - No production dependencies, so there is no dependency health to assess.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to pipeworx-io/mcp-congress).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 22 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 63/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2797 tokens (~279/item across 10 items; 10 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 80/100
  - Stability observed for 24 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 10 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 11 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the Congress MCP server?

Congress runs locally as an npm package, launched with npx -y @pipeworx/mcp-congress. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add pipeworx-io-congress -- npx -y @pipeworx/mcp-congress
```

### Cursor

```json
{
  "mcpServers": {
    "pipeworx-io-congress": {
      "command": "npx",
      "args": [
        "-y",
        "@pipeworx/mcp-congress"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "pipeworx-io-congress": {
      "command": "npx",
      "args": [
        "-y",
        "@pipeworx/mcp-congress"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add pipeworx-io-congress -- npx -y @pipeworx/mcp-congress
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pipeworx-io-congress": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@pipeworx/mcp-congress"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add pipeworx-io-congress --command npx --arg -y --arg @pipeworx/mcp-congress
```

### Hermes

```yaml
mcp_servers:
  pipeworx-io-congress:
    command: "npx"
    args: ["-y", "@pipeworx/mcp-congress"]
```

### Netclaw

```json
{
  "McpServers": {
    "pipeworx-io-congress": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@pipeworx/mcp-congress"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add pipeworx-io-congress -t stdio -c npx -a -y @pipeworx/mcp-congress
```

### Other

```json
{
  "mcpServers": {
    "pipeworx-io-congress": {
      "command": "npx",
      "args": [
        "-y",
        "@pipeworx/mcp-congress"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 90, +1)

No change was recorded against any check on this day. Stability & Change Management went from 73 to 77. That category is still filling its 30-day observation window: 22 days of observed history at the previous scan, 23 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-19 (score 89, +1)

No change was recorded against any check on this day. Stability & Change Management went from 67 to 70. That category is still filling its 30-day observation window: 20 days of observed history at the previous scan, 21 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-17 (score 88, +1)

No change was recorded against any check on this day. Stability & Change Management went from 60 to 63. That category is still filling its 30-day observation window: 18 days of observed history at the previous scan, 19 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-15 (score 87, +1)

No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-13 (score 86, +1)

No change was recorded against any check on this day. Stability & Change Management went from 47 to 50. That category is still filling its 30-day observation window: 14 days of observed history at the previous scan, 15 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-11 (score 85, +1)

No change was recorded against any check on this day. Stability & Change Management went from 40 to 43. That category is still filling its 30-day observation window: 12 days of observed history at the previous scan, 13 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-09 (score 84, +6)

- [security improvement] Source repository: unverified → pass

### 2026-11-08 (score 78, −5)

- [security regression] Provenance: pass → unverified

## MCP tools (10)

### `search_bills` (~393 tokens)

ANSWERS "what bills about X has Congress introduced" / "recent congressional bills on X" / "federal legislation about X" / "find the <Named> Act" — searches US FEDERAL congressional bills (US House & Senate, national laws) BY BILL NAME, SUBJECT OR KEYWORD, including recently introduced ones. Full-text search is via GovInfo (the GPO's index of the same bill documents congress.gov itself searches — congress.gov's own /bill endpoint has no keyword query at all), then RE-RANKED locally by how well each bill's title matches the query — exact title first, then a title containing the phrase, then all query words, then partial overlap — so the first result is the best title match and each bill carries its match tier. Pass `congress` to restrict to one Congress (filtered locally against the search results — may miss a match if it falls outside GovInfo's own top results for that query). Prefer this over a date-sorted recent-bills listing whenever the question names a topic or a bill. Returns bill type, number, title, status, sponsor, and introduction date (via congress.gov). Use get_bill with congress + bill_type + number for full details. Requires an API key (see get_bill). NOTE: this is the US Congress (federal) ONLY — for STATE legislature bills (e.g. California, Texas, New York, or any US state legislation) use legiscan or openstates instead, not this tool.

Input parameters:

- `congress` (number): Optional Congress number (e.g. 111) to restrict results to, filtered locally against the search results.
- `limit` (number): Number of results to return (default: 10, max: 100)
- `query` (string, required): Bill name, keywords or subject to match against bill titles, e.g. "Lower Energy Costs Act" or "crypto"

### `get_bill` (~234 tokens)

Look up one congressional bill from congress.gov (the Library of Congress's official API) 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 (congress.gov's free-text `latestAction`) with its date, introduced date, whether/which law it became, and the congress.gov link. Does NOT return bill text, cosponsors, committee assignments or vote history. Requires an API key: a free api.data.gov key works — supplied automatically when called through the Pipeworx gateway.

Input parameters:

- `bill_type` (string, required): Bill type: hr, s, hres, sres, hjres, sjres, hconres or sconres (congress.gov's own short codes). The long GovTrack-era forms (house_bill, senate_bill, ...) and 'h.r.' are also accepted.
- `congress` (number, required): Congress number, e.g. 118
- `number` (number, required): Bill number within that congress, e.g. 1 for H.R. 1

### `get_public_laws` (~186 tokens)

ANSWERS "how many public laws has the 119th Congress passed" / "most recent public law" / "list of laws enacted this Congress" — returns public (or private) laws enacted in one Congress, from congress.gov's official /law endpoint. GovTrack never had an equivalent endpoint at all. Returns the total count, the most recent law (number, originating bill, title, enactment date), and the list of laws (newest first). Requires an API key (see get_bill).

Input parameters:

- `congress` (number, required): Congress number, e.g. 119 for the 119th Congress (2025–2026).
- `law_type` (string): "pub" (default, public laws) or "priv" (private laws).
- `limit` (number): Number of laws to return (default: 20, max: 100).

### `get_members` (~68 tokens)

Get current members of Congress with their name, party, state, district (for representatives), chamber and first term-start year, from congress.gov. Requires an API key (see get_bill).

Input parameters:

- `limit` (number): Number of results to return (default: 50, max: 600)

### `get_votes` (~518 tokens)

ANSWERS "how did the Senate vote on X" / "recent House roll calls" / "cloture vote tally" — recent roll-call votes for ONE chamber, newest first within that chamber + session. House votes come from the Clerk of the House's own records (via congress.gov's official API), addressed directly by roll-call number (House roll numbers are sequential 1..N within a session) — so this is capped at 25 per call for House, since each House vote costs its own upstream request; a higher `limit` is silently clamped with a note, not an error. Senate votes come from the Congressional Record (U.S. Government Publishing Office), which prints every Senate roll call with its member lists; senate.gov itself refuses automated requests and is not read. Each Senate vote carries its number, the Record issue date, the question and outcome sentence as the Record words them (null when the Record text has none this tool can match, never inferred from the tally), and its yea/nay tally; a roll the Record text could not be parsed with confidence is listed under `unparsed`, and a gap in the returned vote numbers is named in `note`. For HOW EACH SENATOR VOTED, attendance and party-line share use congress_member_votes (chamber "senate"). Pass chamber: "house" or "senate" — the two chambers number their votes independently, so there is no combined listing. Returns question, result, yes/no tallies and date for each vote; every response names its own chamber, congress, session and source. Pass congress + session to look at a specific past session (session can only be left out for the CURRENT Congress); omit both for the current session. A chamber/congress/session nothing has been published for returns a named reason, never a silent empty list. A House roll number that congress.gov has no record of (e.g. vacated and never reused) is skipped and named in `note`, not silently missing.

Input parameters:

- `chamber` (string, required): Required: "house" or "senate".
- `congress` (number): Congress number, e.g. 119. Omit for the current Congress.
- `limit` (number): Number of votes to return (default 20, max 100).
- `session` (number): 1 or 2 — each Congress has exactly two sessions, one per calendar year. Can be omitted only when congress is also omitted, or is the current Congress (it is then inferred from today's date).

### `get_recent_bills` (~287 tokens)

List the most recent congressional bills — newest first by introduction date or by latest update — from congress.gov. This tool takes NO subject or keyword: it returns whatever Congress touched most recently, so it can only answer OPEN-ENDED recency questions — "what bills were introduced this week", "latest bills in Congress", "what is Congress working on now", "recent activity on bills". PREFER OVER congress_search_bills for exactly those (it ranks by keyword relevance and surfaces older bills). If the question NAMES a bill, act, or subject — "status of the NDAA", "the defense authorization bill", "bills about crypto" — use congress_search_bills instead, even when it asks for the CURRENT status: a named subject cannot be found in an unfiltered recency list, which is mostly routine post-office namings. Returns bill type, number, title, status, sponsor, and dates. Requires an API key (see get_bill).

Input parameters:

- `by` (string): Recency basis: "introduced" (default, newest introductions) or "activity" (most recent update / latest action).
- `congress` (number): Congress number to filter by (e.g., 119 for 2025–2026). Omit for all.
- `limit` (number): Number of bills to return (default: 20, max: 100)

### `committee_leadership` (~194 tokens)

ANSWERS "who chairs X committee" / "who are the ranking members of every House committee" / "list of committee chairs in Congress" — returns EVERY standing committee in one chamber (or all three chambers) of the 119th Congress with its chair and ranking member (name, party, bioguide id). Pass chamber to scope to "house", "senate" or "joint"; omit it for all three. For one committee's FULL roster (every member, not just the chair/ranking pair) use committee_members instead. SOURCE: github.com/unitedstates/congress-legislators (public domain), baked periodically — NOT GovTrack, which has no committee-leadership endpoint at all. data_as_of in the response is the source data's own last-update date.

Input parameters:

- `chamber` (string): "house", "senate" or "joint". Omit to return every chamber.

### `committee_members` (~495 tokens)

ANSWERS "who is on the House Appropriations committee" / "roster of the Senate Judiciary committee" / "Democratic members of Ways and Means" / "chair of the Armed Services Subcommittee on Cybersecurity" — returns one committee OR SUBCOMMITTEE's full membership with each member's party, rank and title (Chair / Ranking Member / plain member), plus its own chair and ranking member. Identify it by committee_id (the exact id from committee_leadership, e.g. "HSWM" for House Ways and Means, or a subcommittee id like "SSAS21") OR by name — name matching searches SUBCOMMITTEE names too (bare, e.g. "Cybersecurity", or combined with the parent committee, e.g. "Senate Armed Services Subcommittee on Cybersecurity"), ranked exact-name-first; a looser match is disclosed as `alternatives` rather than silently dropped. A name matching only the parent committee (no subcommittee) is returned as the committee with `parent_only_match: true` and a note — never as if it were the more specific thing you asked for. A name with no chamber that matches equally well in BOTH the House and Senate (e.g. bare "Appropriations") returns both as `matches` rather than guessing; pass chamber to pick one directly. A subcommittee response names its parent separately (`parent_committee_id`/`parent_committee_name`) — its `chair`/`ranking_member` are its OWN, never the parent's. For the chair/ranking member of EVERY (top-level) committee at once, use committee_leadership instead — it is cheaper when you do not need the full roster, but does not search subcommittees. SOURCE: github.com/unitedstates/congress-legislators (public domain), baked periodically, current (119th) Congress only.

Input parameters:

- `chamber` (string): Optional: "house", "senate" or "joint" — disambiguates a name that matches more than one chamber.
- `committee_id` (string): Exact committee or subcommittee id, e.g. "HSWM" (House Ways and Means) or "SSJU" (Senate Judiciary). Takes priority over name.
- `name` (string): Committee name or partial name to search for, e.g. "Appropriations", "Judiciary", "Foreign Affairs".

### `member_committees` (~166 tokens)

ANSWERS "what committees is X on" / "committee assignments for Senator X" — returns every committee and subcommittee assignment (committee name, chamber, rank, title) for one member of the 119th Congress, identified by their bioguide id (the standard Congress.gov/GovInfo member identifier, e.g. "N000015" for Richard Neal — committee_leadership and committee_members both return bioguide ids for the members they list, so look a member up there first if you only have a name). SOURCE: github.com/unitedstates/congress-legislators (public domain), baked periodically, current Congress only.

Input parameters:

- `bioguide_id` (string, required): The member's bioguide id, e.g. "N000015".

### `member_legislative_stats` (~205 tokens)

ANSWERS "how many bills has Rep. X sponsored", "how bipartisan is Senator Y", "what share of X's bills have other-party cosponsors" — legislative activity statistics for ONE member of Congress in one Congress, computed from congress.gov records: bills sponsored, bills cosponsored, sponsored bills that became law, and how many of the member's sponsored bills drew at least one cosponsor from the other major party (checked on the newest bills_analysed of them). These are our own computed counts, not an official score, and not GovTrack's ranked report-card metrics (no percentile/rank is computed). Requires an API key (see get_bill).

Input parameters:

- `bioguide_id` (string, required): The member's bioguide id, e.g. "R000603" (get_members returns them).
- `congress` (number): Congress number, e.g. 118 for 2023-2024 (default: the current Congress).

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/pipeworx-io-congress/pipeworx-mcp-congress#diagnostics

## Score history

- 2026-11-22: 90
- 2026-11-21: 90
- 2026-11-20: 89
- 2026-11-19: 89
- 2026-11-18: 88
- 2026-11-17: 88
- 2026-11-16: 87
- 2026-11-15: 87
- 2026-11-14: 86
- 2026-11-13: 86
- 2026-11-12: 85
- 2026-11-11: 85
- 2026-11-10: 84
- 2026-11-09: 84
- 2026-11-08: 78
- 2026-11-07: 83
- 2026-11-06: 83
- 2026-11-05: 82
- 2026-11-04: 82
- 2026-11-03: 81
- 2026-11-02: 81
- 2026-11-01: 80
- 2026-10-31: 65
- 2026-10-30: 79
- 2026-10-29: 79

## Common questions

### What is the Congress MCP server?

Congress is an MCP server listed in the public MCP registry as io.github.pipeworx-io/congress. Congress MCP, US Congress bill/law/member data via the official congress.gov API (Library of… This page covers its npm package (@pipeworx/mcp-congress).

### Is the Congress MCP server safe to use?

Congress scores 90 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 22 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Congress MCP server expose?

Congress exposes 10 tools: search_bills, get_bill, get_public_laws, get_members, get_votes, and 5 more. Their descriptions and schemas cost roughly 2,746 tokens of context every time the server is loaded.

### Is the Congress MCP server still maintained?

Congress is still listed as active in the MCP registry. We last reached this channel on 22 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Congress MCP server under?

Congress declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

### What did VerifyMCP test on the Congress MCP server?

VerifyMCP ran 16 checks on Congress, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- npm package: https://www.npmjs.com/package/@pipeworx/mcp-congress
- Socket report: https://socket.dev/npm/package/@pipeworx/mcp-congress
- Repository: https://github.com/pipeworx-io/mcp-congress
- Website: https://pipeworx.io/packs/congress
- Changelog RSS feed: https://verifymcp.io/servers/pipeworx-io-congress/pipeworx-mcp-congress.xml
- Changelog JSON feed: https://verifymcp.io/servers/pipeworx-io-congress/pipeworx-mcp-congress/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/pipeworx-io-congress/pipeworx-mcp-congress.json
- HTML version of this page: https://verifymcp.io/servers/pipeworx-io-congress/pipeworx-mcp-congress
