CongressMCP

91+ congressional data tools for Claude, Cursor, VS Code, and any MCP client.

Access live U.S. Congressional data — bills, votes, members, committees, hearings, and more — through natural language via the Model Context Protocol.

Quick Start

1. Get a free Congress.gov API key

Sign up at **api.congress.gov/sign-up** (takes 30 seconds, completely free).

2. Configure your MCP client

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "congressmcp": {
      "command": "uvx",
      "args": ["congressmcp"],
      "env": {
        "CONGRESS_API_KEY": "your-api-key-here"
      }
    }
  }
}

VS Code — add to .vscode/mcp.json:

{
  "servers": {
    "congressmcp": {
      "command": "uvx",
      "args": ["congressmcp"],
      "env": {
        "CONGRESS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor — add to ~/.cursor/mcp.json using the same format as VS Code.

3. Start asking questions

"Find recent climate change bills in the 119th Congress"

"How did senators from California vote on the latest defense bill?"

"Who are the members of the Senate Judiciary Committee?"

"What's the latest action on H.R. 1234?"

Tools

6 toolsets, 91+ operations covering all Congress.gov API endpoints:

Running from source

git clone https://github.com/amurshak/congressMCP
cd congressMCP
pip install -e .

# stdio (default — for MCP clients)
CONGRESS_API_KEY=your-key congressmcp

# HTTP (for self-hosting / remote access)
congressmcp --transport streamable-http --port 8000

Configuration

Contributing

1. Fork the repository

2. Create a feature branch

3. Submit a pull request

License

Sustainable Use License

---

Built for government transparency and accessible civic data.