What is Congress Gov Mcp

congress_gov_mcp is an unofficial MCP server designed to interface with the Congress.gov API, providing access to legislative data and resources.

Use cases

Use cases for congress_gov_mcp include building applications that track legislation, analyzing voting patterns, and providing insights into congressional activities.

How to use

To use congress_gov_mcp, install the required prerequisites, clone the repository, install dependencies, and configure your API key in the .env file. Then, set up the server configuration for either Claude Desktop or Claude Code as per your requirements.

Key features

Key features of congress_gov_mcp include seamless integration with the Congress.gov API, support for various installation methods, and the ability to retrieve legislative data such as bills and congress sessions.

Where to use

congress_gov_mcp can be used in fields such as legislative research, political analysis, and application development that require access to U.S. congressional data.

Congress.gov 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

Installing via Smithery

To install congress_gov_mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @AshwinSundar/congress_gov_mcp --client claude

Manual 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.

3. Install Claude Desktop, Claude Code, or another client that supports MCP Integrations

Initial 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:

congress_gov_mcp/.env

CONGRESS_GOV_API_KEY="your-api-key-here"

Client Configuration

Claude Desktop

1. Complete Prerequisites

2. Copy the absolute path to your uv installation:

which uv

2. Add the following to your Claude Desktop configuration file, inside the mcpServers block:

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "congress_gov_mcp": {
      "command": "/absolute_path/to/uv",
      "args": [
        "run",
        "/absolute_path_to/congress_gov_mcp/server.py"
      ]
    }
  }
}

Claude Code

1. Complete Prerequisites

2. Add the following to .mcp.json in the directory you are running Claude Code in, inside the mcpServers block:

{
  "mcpServers": {
    "congress_gov_mcp": {
      "command": "uv",
      "args": [
        "run",
        "/absolute_path_to/congress_gov_mcp/server.py"
      ]
    }
  }
}

Roadmap

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