congressgov-mcp-server

by cyanheads

Not rated
GitHub

About

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

Details

Author
cyanheads
Categories
Productivity, Other

Setup

Install congressgov-mcp-server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/cyanheads/congressgov-mcp-server

Follow the installation instructions in the repository README, then restart your MCP client.

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 onlycommitteeCodechamberis 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

SeeCLAUDE.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 theLICENSEfile 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

Sign in to leave a review

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

Email sign in

No reviews posted yet.