{"id":28772829,"url":"https://github.com/amurshak/congressmcp","last_synced_at":"2026-04-28T01:32:30.267Z","repository":{"id":298282563,"uuid":"987971735","full_name":"amurshak/congressMCP","owner":"amurshak","description":"An MCP server allowing AI agents and MCP clients to interface with the Congress.gov API","archived":false,"fork":false,"pushed_at":"2026-03-13T19:51:54.000Z","size":820,"stargazers_count":28,"open_issues_count":0,"forks_count":7,"subscribers_count":3,"default_branch":"master","last_synced_at":"2026-04-20T03:11:53.957Z","etag":null,"topics":["congress","government","legislation","mcp","mcp-server","modelcontextprotocol","policy"],"latest_commit_sha":null,"homepage":"https://congressmcp.lawgiver.ai","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amurshak.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-21T21:33:29.000Z","updated_at":"2026-04-06T00:32:30.000Z","dependencies_parsed_at":"2025-06-27T15:22:11.666Z","dependency_job_id":"d1134995-cbbf-448e-a709-4fe68938faa1","html_url":"https://github.com/amurshak/congressMCP","commit_stats":null,"previous_names":["amurshak/congressmcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/amurshak/congressMCP","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amurshak%2FcongressMCP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amurshak%2FcongressMCP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amurshak%2FcongressMCP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amurshak%2FcongressMCP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amurshak","download_url":"https://codeload.github.com/amurshak/congressMCP/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amurshak%2FcongressMCP/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32362781,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"ssl_error","status_checked_at":"2026-04-27T20:07:00.910Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["congress","government","legislation","mcp","mcp-server","modelcontextprotocol","policy"],"created_at":"2025-06-17T14:05:51.708Z","updated_at":"2026-04-28T01:32:30.255Z","avatar_url":"https://github.com/amurshak.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CongressMCP\n\n**91+ congressional data tools for Claude, Cursor, VS Code, and any MCP client.**\n\nAccess live U.S. Congressional data — bills, votes, members, committees, hearings, and more — through natural language via the [Model Context Protocol](https://modelcontextprotocol.io/).\n\n## Quick Start\n\n### 1. Get a free Congress.gov API key\n\nSign up at **[api.congress.gov/sign-up](https://api.congress.gov/sign-up/)** (takes 30 seconds, completely free).\n\n### 2. Configure your MCP client\n\n**Claude Desktop** — add to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"congressmcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"congressmcp\"],\n      \"env\": {\n        \"CONGRESS_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n**VS Code** — add to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"congressmcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"congressmcp\"],\n      \"env\": {\n        \"CONGRESS_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n**Cursor** — add to `~/.cursor/mcp.json` using the same format as VS Code.\n\n### 3. Start asking questions\n\n\u003e \"Find recent climate change bills in the 119th Congress\"\n\u003e \"How did senators from California vote on the latest defense bill?\"\n\u003e \"Who are the members of the Senate Judiciary Committee?\"\n\u003e \"What's the latest action on H.R. 1234?\"\n\n## Tools\n\n**6 toolsets, 91+ operations** covering all Congress.gov API endpoints:\n\n| Toolset | Operations | What it does |\n|---------|-----------|--------------|\n| **Bills** | 16 | Search, details, text, actions, amendments, cosponsors, subjects |\n| **Amendments** | 7 | Search, details, actions, sponsors, text |\n| **Treaties \u0026 Summaries** | 5 | Treaty search, actions, committees, text; bill summaries |\n| **Members \u0026 Committees** | 13 | Member search by name/state/district, sponsored legislation, committee bills/reports |\n| **Voting \u0026 Nominations** | 13 | House/Senate votes, nominations, roll calls |\n| **Records \u0026 Hearings** | 10+ | Congressional Record, hearings, CRS reports, committee prints |\n\n## Running from source\n\n```bash\ngit clone https://github.com/amurshak/congressMCP\ncd congressMCP\npip install -e .\n\n# stdio (default — for MCP clients)\nCONGRESS_API_KEY=your-key congressmcp\n\n# HTTP (for self-hosting / remote access)\ncongressmcp --transport streamable-http --port 8000\n```\n\n## Configuration\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `CONGRESS_API_KEY` | Yes | — | Your free Congress.gov API key |\n| `MCP_TRANSPORT` | No | `stdio` | Transport mode (`stdio` or `streamable-http`) |\n| `ENABLE_CACHING` | No | `false` | Cache API responses in memory |\n| `CACHE_TIMEOUT` | No | `300` | Cache TTL in seconds |\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Submit a pull request\n\n## License\n\nSustainable Use License\n\n---\n\n**Built for government transparency and accessible civic data.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famurshak%2Fcongressmcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famurshak%2Fcongressmcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famurshak%2Fcongressmcp/lists"}