MCP server
Openstates MCP Server
Search bills, legislators, committees, and events across all 50 US states, DC, and 5 US…
- Pricing
- Open source
- Runs
- Locally or Remotely
- Version
- 0.4.0
- Listing updated
- 4 days ago
About Openstates MCP Server
Openstates MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.
Search bills, legislators, committees, and events across all 50 US states, DC, and 5 US territories.
Install
Run in a terminal
claude mcp add --transport http openstates-mcp-server https://openstates.caseyjhand.com/mcpAdd to Settings → Connectors → Add custom connector
https://openstates.caseyjhand.com/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"openstates-mcp-server": {
"url": "https://openstates.caseyjhand.com/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"openstates-mcp-server": {
"type": "http",
"url": "https://openstates.caseyjhand.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"openstates-mcp-server": {
"serverUrl": "https://openstates.caseyjhand.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"openstates-mcp-server": {
"type": "http",
"url": "https://openstates.caseyjhand.com/mcp"
}
}
}Configuration
OPENSTATES_API_KEYOpen States API key from open.pluralpolicy.com. Required to make any API requests.RequiredOPENSTATES_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_TRANSPORT_TYPESelects the HTTP transport.OPENSTATES_API_KEYOpen States API key from open.pluralpolicy.com. Required to make any API requests.RequiredOPENSTATES_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_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'.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
Pricing
Open source
Openstates MCP Server FAQ
Is Openstates MCP Server free?
Yes. Openstates MCP Server is open source, so you can use and self-host it for free.
How do I add Openstates MCP Server to Claude Code?
Run this command in your terminal: claude mcp add --transport http openstates-mcp-server https://openstates.caseyjhand.com/mcp