Unofficial MCP server for the Congress.gov API
- Install uv. The easiest way on macOS and Linux is curl -LsSf https://astral.sh/uv/install.sh | sh
- Get a Congress.gov API key.
-
Complete Prerequisites
-
Clone this repository, and cd in:
git clone http://github.com/AshwinSundar/congress_gov_mcp
cd congress_gov_mcp
-
Install dependencies:
uv sync
-
Create a .env file from the template:
cp .env.template .env
-
Add your Congress.gov API key to the .env file:
congress_gov_mcp/.env
CONGRESS_GOV_API_KEY="your-api-key-here"
-
Complete Prerequisites
-
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"
}
}
}
}
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 "
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 "
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 "
- api.congress.gov
- /bill
- /{congress}
- /{congress}/{billType}
- /{congress}/{billType}/{billNumber}
- /actions
- /amendments
- /committees
- /cosponsors
- /relatedbills
- /subjects
- /summaries
- /text
- /titles
- /amendment
- /{congress}
- /{congress}/{amendmentType}
- /{congress}/{amendmentType}/{amendmentNumber}
- /actions
- /cosponsors
- /amendments
- /text
- /summaries
- /{congress}
- /{congress}/{billType}
- /congress
- /{congress}
- /current
- /member
- /{bioguideId}
- /sponsored-legislation
- /cosponsored-legislation
- /{bioguideId}
- /committee
- /{systemCode}
- /bills
- /reports
- /nominations
- /meetings
- /hearings
- /house-communication
- /senate-communication
- /{systemCode}
- /committee-report
- /{congress}
- /{congress}/{reportType}
- /{congress}/{reportType}/{reportNumber}
- /text
- /committee-print
- /{congress}
- /{congress}/{printType}
- /{congress}/{printType}/{printNumber}
- /text
- /committee-meeting
- /{congress}
- /{congress}/{chamber}
- /meetings
- /hearing
- /{congress}
- /{congress}/{chamber}
- /{congress}/{chamber}/{hearingNumber}
- /house-vote
- /{congress}
- /{congress}/{session}
- /{congress}/{session}/{rollCallNumber}
- /congressional-record
- /{volume}
- /{volume}/{pagePrefix}
- /{volume}/{pagePrefix}/{pageNumber}
- /daily-congressional-record
- /{volume}
- /{volume}/{issue}
- /bound-congressional-record
- /{year}
- /{year}/{month}
- /{year}/{month}/{day}
- /house-communication
- /{congress}
- /{congress}/{communicationType}
- /{congress}/{communicationType}/{communicationNumber}
- /house-requirement
- /{congress}
- /{congress}/{requirementNumber}
- /senate-communication
- /{congress}
- /{congress}/{communicationType}
- /{congress}/{communicationType}/{communicationNumber}
- /nomination
- /{congress}
- /{congress}/{nominationNumber}
- /actions
- /hearings
- /crsreport
- /{productCode}
- /treaty
- /{congress}
- /{congress}/{treatyNumber}
- /actions
- /committees
- /bill