congressgov-mcp-server

SSE

by cyanheads

2.9k downloads Not rated yet

GitHub Website SSE

About

U.S. congressional data Browse Congressgov MCP Server for Claude, Cursor, VS Code, and other AI agents.

Details

Transport: SSE

Explore

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name congressgov-mcp-server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

`congressgov_bill_lookup`

Browse and retrieve U.S. legislative bill data from Congress.gov. Discover bills by filtering on congress, bill type, and date range — there is no keyword search. Use 'list' to browse (requires congress, defaults to most-recently-updated first), 'get' for full bill detail (sponsor, policy area, CBO estimates, law info), or drill into a specific bill with 'actions', 'amendments', 'cosponsors', 'committees', 'subjects', 'summaries', 'text', 'titles', or 'related' (each requires congress + billT…

`congressgov_enacted_laws`

Browse enacted public and private laws from Congress.gov by congress and law type ('pub' for public laws, 'priv' for private). 'list' filters by enactment status and law type — the discovery path 'bill_lookup' does not offer. 'get' returns the origin bill record (sponsor, actions, summaries, text), with the public/private law citation on the bill's 'laws' array (e.g. {"number":"118-2","type":"Public Law"}).

`congressgov_member_lookup`

Discover congressional members and their legislative activity. No name search. For 'list', filter by stateCode (optionally with district), by congress, or by both together (e.g., 118th Congress + CA, or CA district 12 in the 118th). Add currentMember=true to restrict to currently serving members. Once you have a bioguideId, use 'get' for full profile or 'sponsored'/'cosponsored' for their legislative portfolio.

`congressgov_committee_lookup`

Browse congressional committees and their legislation, reports, and nominations. Committee codes follow the pattern chamber-prefix (h/s/j) + abbreviation + 2-digit number — use 'list' (with optional 'filter' for name→code resolution) to discover codes, then 'get' or drill into 'bills', 'reports', or 'nominations' ('nominations' is Senate-only). 'get' and sub-resources only need committeeCode (chamber is inferred from the prefix); pass chamber explicitly to override. The 'bills' sub-resource d…

`congressgov_roll_votes`

Retrieve U.S. congressional roll call votes and individual member voting positions for either chamber. Set 'chamber' to 'house' (default, from the Congress.gov API) or 'senate' (from the Senate's official LIS feed). Use 'list' to find votes by congress and session (newest first by default), 'get' for vote details (question, result, tallies, party breakdown, associated bill/nomination/amendment), or 'members' for how each member voted.

`congressgov_senate_nominations`

Browse presidential nominations to federal positions and track the Senate confirmation process. Use 'list' to browse, 'get' for nomination detail, 'actions'/'committees'/'hearings' for confirmation pipeline data, or 'nominees' to retrieve individual appointees in a multi-nominee batch. Nominations use 'PN' (Presidential Nomination) numbering. Most nominations carry confirmation activity on the parent (e.g., PN1000); multi-part parents (e.g., PN851) carry no activity of their own — their actio…

`congressgov_bill_summaries`

Browse recent CRS (Congressional Research Service) bill summaries — plain-language summaries of bills at each legislative stage, useful for answering "what's happening in Congress?". The fromDateTime/toDateTime filters apply to the summary's update time, not the bill's action date, so results include recently rewritten summaries of older bills. Defaults to summaries updated in the last 7 days. Each item shows both the bill's action date and the summary update date. For summaries of one specif…

`congressgov_crs_reports`

Browse and retrieve CRS (Congressional Research Service) reports — nonpartisan policy analyses by subject-matter experts at the Library of Congress, covering policy areas, legislative proposals, and legal questions. Report IDs use letter-number codes (e.g., R40097, RL33612, IF12345). Use 'list' to browse available reports or 'get' for full detail (authors, topics, summary, download formats).

`congressgov_committee_reports`

Browse and retrieve committee reports from Congress.gov — reports accompany legislation reported out of committee and explain the bill's purpose, committee amendments, dissenting views, and the committee vote. Report types are 'hrpt' (House), 'srpt' (Senate), and 'erpt' (Executive).

`congressgov_daily_record`

Browse the daily Congressional Record — floor speeches, debates, and legislative text published each day Congress is in session. Navigation is hierarchical: volumes (via 'list') → issues (via 'issues') → articles (via 'articles'). Use 'list' to find recent volumes, 'issues' to see what's in a volume, and 'articles' to access individual speeches and debate sections.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "congressgov-mcp-server": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@cyanheads/congressgov-mcp-server",
                    "run",
                    "start:stdio"
                ],
                "env": {
                    "CONGRESS_API_KEY": "",
                    "MCP_LOG_LEVEL": ""
                }
            }
        }
    }
}

McpServers

{
    "server": {
        "command": "npx",
        "args": [
            "-y",
            "@cyanheads/congressgov-mcp-server",
            "run",
            "start:stdio"
        ],
        "env": {
            "CONGRESS_API_KEY": "",
            "MCP_LOG_LEVEL": ""
        }
    }
}

Transport

"stdio"

Package

"@cyanheads/congressgov-mcp-server"

Registry

"npm"

Access U.S. congressional data - bills, votes, members, committees - through MCP. STDIO & Streamable HTTP.

Public Hosted Server:https://congressgov.caseyjhand.com/mcp

Eleven read-only tools for querying U.S. legislative data:

Browse and retrieve U.S. legislative bill data from Congress.gov.

- Filter by congress number, bill type, and update-date range
- Retrieve detailed sub-resources: actions, amendments, committees, cosponsors, related bills, subjects, summaries, text versions, and titles
- contentreads a text version's actual document text, a bounded character window at a time — pick the version withtextVersionIndex, the window withcharacterOffset/characterLimit, and follownextOffsetto walk a full bill
- listdefaults toorder='recent'(newest update-date first); passorder='oldest'for ascending
- Pagination support for browsing large result sets

Discover congressional members and their legislative activity.

- Browse by state, district, congress number, and chamber
- Retrieve a member's sponsored and cosponsored legislation
- Look up specific members by bioguide ID

Browse congressional committees and their legislation, reports, and nominations.

- Filter by chamber (House, Senate, Joint)
- Retrieve committee bills, reports, and nominations
- Detail and sub-resource lookups need onlycommitteeCode—chamberis auto-detected from the code
- Committee bills default toorder='recent'(newest-first); passorder='oldest'for ascending update-date order

Retrieve House and Senate roll call votes and individual member voting positions.

- Setchambertohouse(default, from the Congress.gov API) orsenate(from the Senate's official LIS feed — the API exposes no Senate votes)
- listbrowses votes by congress and session, newest first; passorder='oldest'for ascending
- getreturns the question, result, tallies, party breakdown, and associated bill/nomination/amendment
- membersreturns each member's recorded position

- Filter by congress and bill type
- Browse chronologically to see what's moving through Congress

Browse and retrieve CRS reports — nonpartisan policy analyses written by subject-matter experts at the Library of Congress.

- Browse the full report catalog
- Retrieve individual reports by product number

Browse the daily Congressional Record — floor speeches, debates, and legislative text published each day Congress is in session.

- Browse volumes by congress number
- Retrieve specific issue articles
- contentreads one article's actual text, selected byarticleIndexand bounded bycharacterOffset/characterLimit

Keyword-search bill titles and CRS summaries against a local full-text mirror — the discovery path the Congress.gov API itself lacks.

- Opt-in:off by default, and not offered to clients untilCONGRESS_MIRROR_ENABLED=true. With the flag set but the index not yet built (bun run mirror:init), the tool is callable and answers with an empty result and a build-the-index notice
- Narrow withcongress,billType, andoriginChamberfilters
- Returns BM25-ranked matches with each bill's derived id, ready for a follow-upcongressgov_bill_lookupcall

- Declarative tool definitions — single file per tool, framework handles registration and validation
- Unified error handling across all tools
- Pluggable auth (none,jwt,oauth)
- Swappable storage backends:in-memory,filesystem,Supabase
- Structured logging with optional OpenTelemetry tracing
- Runs locally (stdio/HTTP) or in Docker from the same codebase

- Type-safe client for the Congress.gov REST API v3
- Optional API key from api.data.gov— defaults toDEMO_KEY(30 req/hr); own key gets 5,000 req/hr
- Automatic pagination and response normalization
- Rate limiting awareness
- All tools are read-only and idempotent

A public instance is available athttps://congressgov.caseyjhand.com/mcp— no installation required. Point any MCP client at it via Streamable HTTP:

{ "mcpServers": { "congressgov-mcp-server": { "type": "streamable-http", "url": "https://congressgov.caseyjhand.com/mcp" } } }

Add the following to your MCP client configuration file.

{ "mcpServers": { "congressgov-mcp-server": { "type": "stdio", "command": "bunx", "args": ["@cyanheads/congressgov-mcp-server@latest"], "env": { "CONGRESS_API_KEY": "your-api-key" } } } }

{ "mcpServers": { "congressgov-mcp-server": { "type": "stdio", "command": "npx", "args": ["-y", "@cyanheads/congressgov-mcp-server@latest"], "env": { "CONGRESS_API_KEY": "your-api-key" } } } }

Get a free API key atapi.data.gov/signupfor 5,000 req/hr. Without a key the server falls back toDEMO_KEY(30 req/hr).

git clone https://github.com/cyanheads/congressgov-mcp-server.git

All configuration is validated at startup via Zod schemas insrc/config/server-config.ts. Key environment variables:

bun run rebuild bun run start:http # or start:stdio

bun run devcheck # Lints, formats, type-checks bun run test # Runs test suite

docker build -t congressgov-mcp-server . docker run -e CONGRESS_API_KEY=your-api-key -p 3010:3010 congressgov-mcp-server

See CLAUDE.mdfor development guidelines and architectural rules. The short version:

- Handlers throw, framework catches — notry/catchin tool logic
- Usectx.logfor logging,ctx.statefor storage
- All tools are read-only withreadOnlyHint: trueandidempotentHint: true

Issues and pull requests are welcome. Run checks and tests before submitting:

This project is licensed under the Apache 2.0 License. See the LICENSEfile for details.

Search U.S. government contracts, vendors, and awards.

Full access to searches tenders, companies, governement spendings and procurement data from Indonesia

AI-powered property zoning, buildability, and ADU eligibility analysis for any U.S. address via 20+ government data sources.

A Centralized MCP Server for Fetching Data from Many Countries' Govs

jpcite — Japan public-program MCP server. 11,684 subsidies + 9,484 e-Gov laws + 22,258 enforcement cases + 13,801 invoice registrants + 166K corporate entities. 93 tools. Evidence Packet with source_url + fetched_at + known gaps. ¥3/req metered, 3 free per IP daily. Anonymous trial, no signup.

MCP Server for Brazilian Federal Senate open data - legislators, bills, votes, committees

Search NHTSA vehicle recalls and FDA food/drug recalls in real-time. 4 MCP tools for product safet monitoring.

Great Question is an Agentic UX research platform for product builders. Its MCP lets AI agents create studies directly from any AI tool, surface insights, find the right research candidates, and query your entire research repository.

Provides airfield aeronautical information for general aviation private pilots like runways, fuel prices, landing fees, weather, webcams and more

Multimodal RAG for source-backed AI answers

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

congressgov_bill_lookup

congressgov_enacted_laws

congressgov_member_lookup

congressgov_committee_lookup

congressgov_roll_votes

congressgov_senate_nominations

congressgov_bill_summaries

congressgov_crs_reports

congressgov_committee_reports

congressgov_daily_record

Claude Desktop / Cursor

McpServers

Transport

Package

Registry

More like this

Sequential Thinking

Time

Filesystem

EverArt

`congressgov_bill_lookup`

`congressgov_enacted_laws`

`congressgov_member_lookup`

`congressgov_committee_lookup`

`congressgov_roll_votes`

`congressgov_senate_nominations`

`congressgov_bill_summaries`

`congressgov_crs_reports`

`congressgov_committee_reports`

`congressgov_daily_record`