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