io.github.cyanheads/openstates-mcp-server MCP Server
io.github.cyanheads/openstates-mcp-server
What this kind of tool is for
- Let your agent search the web or a document set and cite what it found.
- Pull structured facts out of pages instead of copy-pasting by hand.
- Track changes on a topic over days without re-reading everything.
How to compare servers like this
- Source coverage:
- Check which engines, sites, or document types the tool can actually reach.
- Citation behavior:
- Prefer tools that return links you can open, not just summarized claims.
- Terms of service:
- Some sources forbid automated access; make sure the tool stays inside them.
- Maintenance signal:
- Scrapers break silently when pages change; recent commits are the best proxy.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the io.github.cyanheads/openstates-mcp-server MCP server?
Search bills, legislators, committees, and events across all 50 US states, DC, and 5 US territories.
How to install io.github.cyanheads/openstates-mcp-server
Copy-paste configuration for popular MCP clients.
OPENSTATES_API_KEYrequiredOpen States API key from open.pluralpolicy.com. Required to make any API requests.
OPENSTATES_DAILY_REQUEST_BUDGETMaximum upstream Open States requests per rolling 24 hours. Rejects before the request is issued once spent. Defaults to the v3 free-tier daily cap.
OPENSTATES_REQUEST_TIMEOUT_MSPer-attempt upstream request deadline in milliseconds (minimum 1000). Expiry is non-retryable. Open States answers a scoped query in under a second to ~57s and its gateway gives up near 60s.
OPENSTATES_TOTAL_REQUEST_BUDGET_MSWall-clock ceiling in milliseconds for one call across every retry attempt and the backoff between them. Bounds a slow upstream that keeps failing retryably. Must be at least OPENSTATES_REQUEST_TIMEOUT_MS; startup rejects a lower value.
MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_HTTP_HOSTThe hostname for the HTTP server.
MCP_HTTP_PORTThe port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
{
"mcpServers": {
"openstates-mcp-server": {
"command": "bun",
"args": [
"-y",
"@cyanheads/openstates-mcp-server",
"run",
"start:stdio"
],
"env": {
"OPENSTATES_API_KEY": "<YOUR_OPENSTATES_API_KEY>",
"OPENSTATES_DAILY_REQUEST_BUDGET": "<YOUR_OPENSTATES_DAILY_REQUEST_BUDGET>",
"OPENSTATES_REQUEST_TIMEOUT_MS": "<YOUR_OPENSTATES_REQUEST_TIMEOUT_MS>",
"OPENSTATES_TOTAL_REQUEST_BUDGET_MS": "<YOUR_OPENSTATES_TOTAL_REQUEST_BUDGET_MS>",
"MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
"MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
"MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
"MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
"MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
}
}
}
}Related MCP servers
Geocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data.
Researcher profiles, works, affiliations, funding, and peer reviews from the ORCID registry.
Query OSV.dev for package vulnerabilities and batch-audit dependency lists via MCP.
Offline global aviation reference — airports, runways, navaids, frequencies from OurAirports.
Search fossil occurrences, taxon ranges, diversity through deep time, and the geologic time scale.
Offline methodology engine for authorized penetration testing, CTF, and security research.
