Openstates MCP Server

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 12 min ago.

claude mcp add openstates-mcp-server --transport http https://openstates.caseyjhand.com/mcp

{
  "mcpServers": {
    "openstates-mcp-server": {
      "url": "https://openstates.caseyjhand.com/mcp"
    }
  }
}

[mcp_servers.openstates-mcp-server]
url = "https://openstates.caseyjhand.com/mcp"

{
  "mcpServers": {
    "openstates-mcp-server": {
      "url": "https://openstates.caseyjhand.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "openstates-mcp-server": {
      "url": "https://openstates.caseyjhand.com/mcp"
    }
  }
}

This one needs environment variables set before it will start: OPENSTATES_API_KEY (Open States API key from open.pluralpolicy.com. Required to make any API requests.), OPENSTATES_DAILY_REQUEST_BUDGET (Maximum 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_MS (Per-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_MS (Wall-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_HOST (The hostname for the HTTP server.), MCP_HTTP_PORT (The port to run the HTTP server on.), MCP_HTTP_ENDPOINT_PATH (The endpoint path for the MCP server.), MCP_AUTH_MODE (Authentication mode to use: 'none', 'jwt', or 'oauth'.), MCP_LOG_LEVEL (Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').). The author declared them in the registry entry; get the values from the project itself.

Available tools 10

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

Endpoints