io.github.cyanheads/openstates-mcp-server

Search bills, legislators, committees, and events across all 50 US states, DC, and 5 US territories.

What does this entry provide?

io.github.cyanheads/openstates-mcp-server is an MCP server entry in ChatHome Skills, sourced from Official MCP Registry and scored 78/100. As a Model Context Protocol server, it exposes tools that MCP-compatible LLM clients such as Claude, Cursor, and Copilot can call directly, extending an agent's reach beyond its built-in capabilities. ChatHome Skills discovered this entry through its daily ingest of official registries and GitHub discovery queries, and re-verifies repository facts, freshness signals, and install metadata on every run. The quality score weighs official-registry presence, a working install command, license clarity, GitHub star trajectory, and repository freshness — the full formula is on the Sources page. The install command above is ready to copy. Review the last-pushed date and repository status before adding io.github.cyanheads/openstates-mcp-server to a production agent workflow; the snapshot facts below are point-in-time values from the most recent ingest.

Snapshot facts

Source: Official MCP Registry
Quality: 78/100
Install method: streamable-http
Repo: cyanheads/openstates-mcp-server
Repo updated: Oct 25, 2026

Install command

mcp add io.github.cyanheads/openstates-mcp-server https://openstates.caseyjhand.com/mcp

Install method: streamable-http

Review the upstream source before running this command.

GitHub project Homepage

Quality

Repo stars

Repo updated

Oct 25, 2026

How is this score calculated?

Weighted across six dimensions, scored 0-100.
Provenance (25): listed in an official or curated registry.
Installability (25): a runnable install command beats a declared transport, which beats a source checkout.
Maintenance (20): recency of the last push; archived entries score zero here.
Adoption (20): repository stars on a log curve.

MCP manifest

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-10-25T09:53:49.270966Z",
      "publishedAt": "2026-10-25T09:53:49.270966Z",
      "statusChangedAt": "2026-10-25T09:53:49.270966Z"
    }
  },
  "server": {
    "name": "io.github.cyanheads/openstates-mcp-server",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "remotes": [
      {
        "url": "https://openstates.caseyjhand.com/mcp",
        "type": "streamable-http"
      }
    ],
    "version": "0.3.4",
    "packages": [
      {
        "version": "0.3.4",
        "transport": {
          "type": "stdio"
        },
        "identifier": "@cyanheads/openstates-mcp-server",
        "runtimeHint": "npx",
        "registryType": "npm",
        "registryBaseUrl": "https://registry.npmjs.org",
        "environmentVariables": [
          {
            "name": "OPENSTATES_API_KEY",
            "format": "string",
            "isRequired": true,
            "description": "Open States API key from open.pluralpolicy.com. Required to make any API requests."
          },
          {
            "name": "OPENSTATES_DAILY_REQUEST_BUDGET",
            "format": "number",
            "default": "250",
            "description": "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."
          },
          {
            "name": "OPENSTATES_REQUEST_TIMEOUT_MS",
            "format": "number",
            "default": "45000",
            "description": "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."
          },
          {
            "name": "OPENSTATES_TOTAL_REQUEST_BUDGET_MS",
            "format": "number",
            "default": "90000",
            "description": "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."
          },
          {
            "name": "MCP_LOG_LEVEL",
            "format": "string",
            "default": "info",
            "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')."
          }
        ]
      },
      {
        "version": "0.3.4",
        "transport": {
          "url": "http://localhost:3010/mcp",
          "type": "streamable-http"
        },
        "identifier": "@cyanheads/openstates-mcp-server",
        "runtimeHint": "npx",
        "registryType": "npm",
        "registryBaseUrl": "https://registry.npmjs.org",
        "environmentVariables": [
          {
            "name": "MCP_TRANSPORT_TYPE",
            "value": "http",
            "format": "string",
            "description": "Selects the HTTP transport."
          },
          {
            "name": "OPENSTATES_API_KEY",
            "format": "string",
            "isRequired": true,
            "description": "Open States API key from open.pluralpolicy.com. Required to make any API requests."
          },
          {
            "name": "OPENSTATES_DAILY_REQUEST_BUDGET",
            "format": "number",
            "default": "250",
            "description": "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."
          },
          {
            "name": "OPENSTATES_REQUEST_TIMEOUT_MS",
            "format": "number",
            "default": "45000",
            "description": "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."
          },
          {
            "name": "OPENSTATES_TOTAL_REQUEST_BUDGET_MS",
            "format": "number",
            "default": "90000",
            "description": "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."
          },
          {
            "name": "MCP_HTTP_HOST",
            "format": "string",
            "default": "127.0.0.1",
            "description": "The hostname for the HTTP server."
          },
          {
            "name": "MCP_HTTP_PORT",
            "format": "string",
            "default": "3010",
            "description": "The port to run the HTTP server on."
          },
          {
            "name": "MCP_HTTP_ENDPOINT_PATH",
            "format": "string",
            "default": "/mcp",
            "description": "The endpoint path for the MCP server."
          },
          {
            "name": "MCP_AUTH_MODE",
            "format": "string",
            "default": "none",
            "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'."
          },
          {
            "name": "MCP_LOG_LEVEL",
            "format": "string",
            "default": "info",
            "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')."
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/cyanheads/openstates-mcp-server",
      "source": "github"
    },
    "description": "Search bills, legislators, committees, and events across all 50 US states, DC, and 5 US territories."
  }
}

Report an issue with this listing