CongressMCP

Real-time U.S. Congressional data for AI assistants via the Model Context Protocol.

48 tools covering bills, members, votes, committees, hearings, amendments, nominations, treaties, scorecards, and AI-powered analysis.

Website | Docs | Get API Key

Quick Start

1. Get an API Key

curl -X POST https://www.congressmcp.com/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "Your Name"}'

2. Connect to Your AI Client

Claude Code:

claude mcp add congressmcp \
  --transport http \
  https://www.congressmcp.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "congressmcp": {
      "url": "https://www.congressmcp.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor (Settings > MCP Servers > Add):

URL: https://www.congressmcp.com/mcp
Header: Authorization: Bearer YOUR_API_KEY

Windsurf (Settings > MCP):

{
  "congressmcp": {
    "serverUrl": "https://www.congressmcp.com/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

3. Start Asking Questions

Once connected, just ask your AI naturally:

"What bills has my senator introduced this session?"
"How did the House vote on the latest defense bill?"
"Compare the voting records of Senators Warren and Collins"
"Score all senators on climate-related votes"

Tool Reference

Bills (7 tools)

| Tool | Description | |------|-------------| | search_bills | Search bills by keyword, topic, bill number, date range, or policy area | | get_bill | Get detailed bill info: sponsor, cosponsors count, subjects, latest summary | | get_bill_actions | Get the legislative timeline/actions for a bill | | get_bill_cosponsors | Get cosponsors with party affiliation | | get_bill_text | Get available text versions with download URLs | | get_bill_summary | Get CRS plain-language summaries at each legislative stage | | get_bill_subjects | Get Library of Congress subject/topic assignments |

Members (3 tools)

| Tool | Description | |------|-------------| | search_members | Search by name, state, district, party, or chamber. Supports fuzzy matching | | get_member | Get detailed member info: terms served, bills sponsored/cosponsored, vote count | | get_member_legislation | Get bills sponsored or cosponsored by a member |

Votes (5 tools)

| Tool | Description | |------|-------------| | get_member_votes | Get a member's voting record with date filtering | | get_vote_detail | Get details of a specific roll call including party breakdown | | get_vote_members | Get how each member voted on a specific roll call | | get_recent_votes | Browse recent votes by date range and chamber | | score_members_on_votes | Score all members against a set of votes with preferred positions |

Committees (2 tools)

| Tool | Description | |------|-------------| | get_committees | List committees filtered by chamber or congress | | get_committee_members | Get members of a specific committee |

Extended Data (6 tools)

| Tool | Description | |------|-------------| | get_amendments | Browse amendments by bill, congress, chamber, or date | | get_hearings | Browse hearings by date, chamber, committee, or keyword | | get_nominations | Browse presidential nominations with status filtering | | get_public_laws | Browse bills signed into law by congress or date | | get_member_terms | Get term history with contact info (phone, address, website) | | submit_feedback | Submit feedback, bug reports, or feature requests |

Context Views (4 tools)

Single-call aggregated views that combine multiple data sources:

| Tool | Description | |------|-------------| | get_bill_context | Bill + sponsors + CBO cost estimates + laws + status + suggested queries | | get_member_context | Career summary + office info + committees + legislation + voting + participation rate | | get_vote_context | Vote details + party breakdown + all member positions | | get_nomination_context | Nomination + timeline + committee referrals + hearings + related votes |

Scorecards (4 tools)

Build custom scorecards and analyze voting patterns:

| Tool | Description | |------|-------------| | search_scorecard_votes | Find votes by keyword for scorecard building | | build_scorecard | Score ALL members against chosen votes with letter grades (A+ through F) | | get_member_scorecard | Pre-built scorecard: party alignment, bipartisan score, participation rate | | find_similar_members | Find members with the most similar voting patterns |

Treaties & Search (3 tools)

| Tool | Description | |------|-------------| | get_treaties | Browse treaties sent to the Senate for ratification | | get_treaty | Get detailed treaty info including actions and committee referrals | | search_congress | Universal cross-domain search across bills, members, and amendments |

AI Enrichments (4 tools) — Pro

| Tool | Description | |------|-------------| | get_bill_enrichment | AI-generated topic classification, significance rating, impact assessment | | get_legislator_profile | AI-generated archetype, topic authority, vote courage analysis | | search_by_topic | Search bills by AI-classified policy topic with significance filtering | | search_by_issue_tag | Search bills by specific issue tag (e.g. "insulin price cap") |

Analysis (9 tools)

| Tool | Description | |------|-------------| | get_party_unity | How often a member votes with their party (Pro) | | compare_members | Shared cosponsored bills and voting alignment between two members (Pro) | | get_legislation_stats | Aggregate bill counts by type and status for a congress | | get_vote_stats | Voting statistics and chamber breakdowns for a congress | | get_sponsor_effectiveness | How often a member's bills advance, with committee power analysis | | get_broker_score | Bipartisan deal-making power score (0-100) with top bills (Pro) | | get_bill_viability | Passage probability score (0-100) with contributing factors (Pro) | | get_cosponsor_effectiveness | How often cosponsored bills advance vs average (Pro) | | get_data_freshness | When each data domain was last updated |

Example Workflows

Find Your Representatives

"Who represents 742 Evergreen Terrace, Springfield, IL?"

The AI will use search_members with state and district to find your senators and house representative.

Track a Bill

"What's the status of the PRESS Act? Show me its full legislative history."

The AI chains search_bills → get_bill_context to find the bill and show sponsors, actions, cost estimates, and current status.

Build an Issue Scorecard

"Score all senators on immigration votes this session."

The AI uses search_scorecard_votes with "immigration" to find relevant votes, then build_scorecard to grade every senator A+ through F.

Compare Two Legislators

"Compare the voting records of Ted Cruz and John Cornyn."

Uses search_members to find bioguide IDs, then compare_members for voting alignment and shared bills.

Investigate Bipartisanship

"Which House members have the highest bipartisan broker scores?"

Uses get_broker_score to measure cross-aisle deal-making power based on opposing-party cosponsors.

Monitor Committee Activity

"What hearings has the Senate Judiciary Committee held this month?"

Uses get_hearings with committee code and date filters.

Analyze Sponsor Effectiveness

"How effective is Senator Warren at getting her bills through committee?"

Uses get_sponsor_effectiveness for advancement rates, committee power analysis, and comparison to average.

Check Bill Viability

"What are the chances that HR 1234 passes?"

Uses get_bill_viability for a 0-100 passage probability score based on historical patterns, cosponsor momentum, and bipartisan support.

Pricing

| | Free | Pro | |---|---|---| | Price | $0/mo | $25/mo | | Requests | 100/month | 10,000/month | | Rate limit | 10/min | 60/min | | Core tools | Bills, members, votes, committees, hearings, amendments, nominations | Everything | | AI enrichments | - | Topic classification, significance scoring, archetypes | | Analysis tools | Legislation stats, vote stats, sponsor effectiveness, data freshness | All analysis tools | | Scorecards | - | Custom scorecards, member scorecards, similar members | | Support | Standard | Priority |

.gov and .edu emails get 50% off Pro.

Get Started Free

Data Coverage

Bills: 367,000+ bills across all congresses
Members: 12,000+ current and historical members
Votes: 3,000,000+ individual vote records
Committees: All standing, select, and joint committees
Hearings: Committee hearing schedules and witness lists
Amendments: Floor and committee amendments
Nominations: Presidential nominations to the Senate
Treaties: Treaties sent to the Senate for ratification
Public Laws: All bills signed into law

Data is sourced from official Congressional records and updated daily. The current Congress is the 119th (2025-2027).

Key Concepts

Bioguide ID

Every member of Congress has a unique bioguide ID (e.g., S000148 for Chuck Schumer). Use search_members to find a member's bioguide ID before calling member-specific tools.

Bill Identifiers

Bills are identified by three parts:

Congress number (e.g., 119)
Type (hr = House bill, s = Senate bill, hjres = House joint resolution, etc.)
Number (e.g., 1234)

Example: HR 1234 in the 119th Congress → congress=119, type="hr", number=1234

Roll Call Votes

Votes are identified by:

Chamber (House or Senate)
Congress (e.g., 119)
Session (1 or 2)
Roll call number (sequential within a session)

Pro vs Free Tools

Tools marked [Pro] require a Pro subscription. Free tier users can access core data tools (bills, members, votes, committees, hearings, amendments, nominations). Pro adds AI enrichments, analysis tools, and scorecards.

Feedback

Found a bug? Have a feature request? Use the submit_feedback tool directly, or open an issue on this repo.

Links

Built by LegiCraft.

MCP Servers