<span>Congress.gov</span> MCP server

Ever wonder what our (US) Congress is up to? Tired of reading the news to find out? Ask the US Congress API yourself.

Unofficial MCP server for the Congress.gov API

Installation

Prerequisites

1. Install uv. The easiest way on macOS and Linux is curl -LsSf https://astral.sh/uv/install.sh | sh
2. Get a Congress.gov API key.

Setup

1. Complete Prerequisites

2. Clone this repository, and cd in:

   git clone http://github.com/AshwinSundar/congress_gov_mcp

   cd congress_gov_mcp

3. Install dependencies:

   uv sync

4. Create a .env file from the template:

   cp .env.template .env

5. Add your Congress.gov API key to the .env file:

<u>congress_gov_mcp/.env</u>

CONGRESS_GOV_API_KEY="your-api-key-here"

Configure for Claude Desktop

1. Complete Prerequisites

2. Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "congress_gov_mcp": {
      "command": "uv",
      "args": [
        "run",
        "/path/to/congress_gov_mcp/server.py"
      ],
      "env": {
        "CONGRESS_GOV_API_KEY": "your-api-key-here"
      }
    }
  }
}

Configure for Claude Code

Local Installation

claude mcp add -s local --name congress_gov_mcp --env CONGRESS_GOV_API_KEY="your-api-key-here /path/to/congress_gov_mcp/server.py "

User Installation

claude mcp add -s user --name congress_gov_mcp --env CONGRESS_GOV_API_KEY="your-api-key-here /path/to/congress_gov_mcp/server.py "

Project Installation

claude mcp add -s project --name congress_gov_mcp --env CONGRESS_GOV_API_KEY="your-api-key-here /path/to/congress_gov_mcp/server.py "

Roadmap

• [x] api.congress.gov
  • [x] /bill
    • [ ] /{congress}
    • [ ] /{congress}/{billType}
    • [ ] /{congress}/{billType}/{billNumber}
      • [ ] /actions
      • [ ] /amendments
      • [ ] /committees
      • [ ] /cosponsors
      • [ ] /relatedbills
      • [ ] /subjects
      • [ ] /summaries
      • [ ] /text
      • [ ] /titles
  • [x] /amendment
    • [ ] /{congress}
    • [ ] /{congress}/{amendmentType}
    • [ ] /{congress}/{amendmentType}/{amendmentNumber}
      • [ ] /actions
      • [ ] /cosponsors
      • [ ] /amendments
      • [ ] /text
  • [x] /summaries
    • [ ] /{congress}
    • [ ] /{congress}/{billType}
  • [x] /congress
    • [ ] /{congress}
    • [ ] /current
  • [x] /member
    • [ ] /{bioguideId}
      • [ ] /sponsored-legislation
      • [ ] /cosponsored-legislation
  • [x] /committee
    • [ ] /{systemCode}
      • [ ] /bills
      • [ ] /reports
      • [ ] /nominations
      • [ ] /meetings
      • [ ] /hearings
      • [ ] /house-communication
      • [ ] /senate-communication
  • [x] /committee-report
    • [ ] /{congress}
    • [ ] /{congress}/{reportType}
    • [ ] /{congress}/{reportType}/{reportNumber}
      • [ ] /text
  • [x] /committee-print
    • [ ] /{congress}
    • [ ] /{congress}/{printType}
    • [ ] /{congress}/{printType}/{printNumber}
      • [ ] /text
  • [x] /committee-meeting
    • [ ] /{congress}
    • [ ] /{congress}/{chamber}
      • [ ] /meetings
  • [x] /hearing
    • [ ] /{congress}
    • [ ] /{congress}/{chamber}
    • [ ] /{congress}/{chamber}/{hearingNumber}
  • [x] /house-vote
    • [ ] /{congress}
    • [ ] /{congress}/{session}
    • [ ] /{congress}/{session}/{rollCallNumber}
  • [x] /congressional-record
    • [ ] /{volume}
    • [ ] /{volume}/{pagePrefix}
    • [ ] /{volume}/{pagePrefix}/{pageNumber}
  • [x] /daily-congressional-record
    • [ ] /{volume}
    • [ ] /{volume}/{issue}
  • [x] /bound-congressional-record
    • [ ] /{year}
    • [ ] /{year}/{month}
    • [ ] /{year}/{month}/{day}
  • [x] /house-communication
    • [ ] /{congress}
    • [ ] /{congress}/{communicationType}
    • [ ] /{congress}/{communicationType}/{communicationNumber}
  • [x] /house-requirement
    • [ ] /{congress}
    • [ ] /{congress}/{requirementNumber}
  • [x] /senate-communication
    • [ ] /{congress}
    • [ ] /{congress}/{communicationType}
    • [ ] /{congress}/{communicationType}/{communicationNumber}
  • [x] /nomination
    • [ ] /{congress}
    • [ ] /{congress}/{nominationNumber}
      • [ ] /actions
      • [ ] /hearings
  • [x] /crsreport
    • [ ] /{productCode}
  • [x] /treaty
    • [ ] /{congress}
    • [ ] /{congress}/{treatyNumber}
      • [ ] /actions
      • [ ] /committees