Log inSubmit server
Congressgov MCP Server logo

Congressgov MCP Server

Access Congress.gov and Senate legislative data through MCP tools for bills, votes, members, committees, reports, and nominations.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Congressgov MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "congressgov-mcp-server": {
      "command": "bunx",
      "args": [
        "@cyanheads/congressgov-mcp-server@latest"
      ],
      "env": {
        "CONGRESS_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The congressgov-mcp-server MCP server connects AI clients to Congress.gov and the Senate’s official vote feed. It exposes tools for researching bills, enacted laws, members, committees, roll calls, nominations, CRS reports, committee reports, and the Congressional Record. Run it over stdio or Streamable HTTP with a Congress API key, or use the listed hosted endpoint. Reach for it when an agent needs structured U.S. legislative research rather than general web search.

Use cases

  • Research a bill’s sponsors, actions, summaries, and text
  • Compare House or Senate roll-call positions
  • Track a presidential nomination through Senate confirmation
  • Find legislation associated with a member or committee
  • Retrieve CRS and committee reports for policy research

Key features

  • Browse and retrieve Congress.gov bill records
  • Query House and Senate roll-call votes
  • Look up members, committees, and legislative portfolios
  • Track enacted laws and Senate nominations
  • Read CRS, committee, and Congressional Record material
  • Search bill titles and CRS summaries through an opt-in local mirror

Tools11

What Congressgov MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~241 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

6/6 checks healthy over the last 40d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · @cyanheads/congressgov-mcp-server@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads1.5kPackage downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Tools exposed11Callable tools this server registers over MCP.

How Congressgov MCP Server works

What congressgov-mcp-server does

The congressgov-mcp-server MCP server gives an MCP client structured access to U.S. congressional records from Congress.gov and Senate roll-call data from the Senate’s official feed. Its tools cover bill records, enacted public and private laws, members, committees, votes, presidential nominations, CRS material, committee reports, and the daily Congressional Record.

Bill operations can retrieve actions, sponsors, summaries, text, titles, amendments, cosponsors, committees, subjects, related bills, and other bill content. Member operations filter by state, district, Congress, or current-member status, then return profiles and sponsored or cosponsored legislation. Committee operations expose associated bills, reports, and, for Senate committees, nominations.

The package also provides five resources for current-Congress information, bill type codes, and direct member, bill, and committee records. Two prompts provide structured starting points for bill analysis and legislative research.

How it works

The server supports both stdio and Streamable HTTP transports. Tools generally use explicit Congress, chamber, session, bill, committee, member, or nomination identifiers. For example, a bill can be listed by Congress and type, then retrieved by its type and number. A roll-call lookup requires a Congress, session, chamber, and—when retrieving details or member positions—the vote number.

Senate roll calls come from the Senate LIS feed, while House votes use the Congress.gov API. Senate vote numbers reset by session and begin with the 101st Congress in this interface. Nomination records may be split into child numbers when a nomination has multiple parts.

The optional congressgov_search_bills tool searches bill titles and CRS summaries through a local full-text mirror. This capability is opt-in. Large bill and report responses may be paginated or returned in character windows, with offsets indicating how to continue reading.

Setup and configuration

Install the npm package with a command such as npx -y @cyanheads/congressgov-mcp-server and provide the CONGRESS_API_KEY environment variable. The repository also publishes a Docker image and provides a hosted MCP endpoint at https://congressgov.caseyjhand.com/mcp.

Clients named by the project include Claude Desktop, Cursor, and VS Code. The server can also be configured directly in an MCP client that supports stdio or Streamable HTTP. A client may expose resources as well as tools; because some clients are tool-only, bill, member, and committee details are also available through their corresponding lookup tools.

Tools and capabilities

The 11 documented tools are:

  • congressgov_bill_lookup for bill browsing and detailed records
  • congressgov_enacted_laws for public and private laws by Congress
  • congressgov_member_lookup for member profiles and legislative portfolios
  • congressgov_committee_lookup for committees and related legislative material
  • congressgov_roll_votes for House and Senate vote results and member positions
  • congressgov_senate_nominations for nomination activity and confirmation tracking
  • congressgov_bill_summaries for recently updated CRS bill summaries
  • congressgov_crs_reports for CRS report catalogs and report text
  • congressgov_committee_reports for reports accompanying legislation
  • congressgov_daily_record for the daily Congressional Record
  • congressgov_search_bills for opt-in local full-text bill searching

The congressgov-mcp-server MCP server also supports resources for current Congress metadata and direct record lookup, plus prompts for repeatable legislative-analysis workflows.

Limitations and notes

Member lookup does not provide name search; use state, district, Congress, current-member filters, or a Bioguide ID. Committee identifiers use a chamber prefix and a two-digit suffix, although names can resolve when exactly one match exists. Committee bill rows do not include titles, so a follow-up bill lookup may be needed.

Bill summary date filters apply to summary update times, not bill action dates. Recent-summary pages and long text responses have size or character-window limits and may require pagination. Enacted-law lookup uses law type and number, while nomination subresources may require a partitioned child number and nominee ordinal.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Congressgov MCP Server

congressgov-mcp-server is an MCP server that connects AI clients to Congress.gov and the Senate’s official vote feed. Its main tools retrieve bills, enacted laws, members, committees, roll-call votes, nominations, CRS and committee reports, and the Congressional Record, with an optional local full-text search for bill titles and CRS summaries.

Install it with `npx -y @cyanheads/congressgov-mcp-server` and set `CONGRESS_API_KEY`. The project also provides Docker packaging, a hosted Streamable HTTP endpoint, and installation links for Claude Desktop, Cursor, and VS Code.

Yes, Cursor is explicitly supported by the project’s installation link. Configure the server with the package command and `CONGRESS_API_KEY`, or connect to the hosted MCP endpoint.

Yes, `congressgov_roll_votes` retrieves Senate roll calls and individual member positions. Senate requests require a Congress and session, and detail or member-position requests also require a vote number.

Yes, the optional `congressgov_search_bills` tool searches bill titles and CRS summaries through a local full-text mirror. The material identifies this mirror-based search as opt-in.

Related MCP servers

All in Legal All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCongressgov MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/congressgov-mcp-server?style=directory)](https://allmcps.com/mcp/congressgov-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/congressgov-mcp-server"><img src="https://allmcps.com/api/badge/congressgov-mcp-server?style=directory" alt="Congressgov MCP Server on AllMCPs" /></a>