io.github.cyanheads/openstates-mcp-server

up checked 2026-11-11T11:39:06.203Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided description

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

Summary by lookupd

Lets an agent search and fetch US state bills, legislators, committees, and hearings across all 50 states, DC, and territories.

Install

Claude Code, remote (streamable-http)

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

Claude Code, npm package (stdio)

claude mcp add openstates-mcp-server -- npx -y @cyanheads/openstates-mcp-server

Claude Code, npm package (stdio)

claude mcp add openstates-mcp-server -- npx -y @cyanheads/openstates-mcp-server

Codex, remote (streamable-http)

codex mcp add openstates-mcp-server --url https://openstates.caseyjhand.com/mcp

Codex, npm package (stdio)

codex mcp add openstates-mcp-server -- npx -y @cyanheads/openstates-mcp-server

Codex, npm package (stdio)

codex mcp add openstates-mcp-server -- npx -y @cyanheads/openstates-mcp-server

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Cursor, npm package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "openstates-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/openstates-mcp-server"
      ]
    }
  }
}

Cursor, npm package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "openstates-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/openstates-mcp-server"
      ]
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (10 tools)

Publisher-provided text

• openstates_search_bills Search state legislative bills across all covered US jurisdictions. Supports full-text search, jurisdiction/session filtering, subject tags, sponsor lookups, an
• openstates_get_bill Fetch full detail for a specific state bill. Accepts either the three-part path (jurisdiction + session + bill_id) or a direct OCD bill ID (openstates_id from s
• openstates_search_people Search state legislators and officials by name, jurisdiction, chamber, or district, or fetch specific people by OCD person ID. Party is reported on every result
• openstates_get_legislators_by_location Find every legislator representing a geographic coordinate — both tiers. Pass latitude and longitude to get the state senators and representatives for that loca
• openstates_search_committees List committees for a jurisdiction. jurisdiction is required — a request spanning all 56 jurisdictions exceeds the upstream timeout, so scope every call to a si
• openstates_get_committee Fetch committee detail by OCD organization ID. Returns name, classification, and membership roster when include=memberships is requested. Experimental — not all
• openstates_search_events Search hearings, floor sessions, and committee meetings. jurisdiction is required — the Open States events endpoint has no all-states search, so scope every cal
• openstates_get_event Fetch full event detail by OCD event ID. Returns agenda, participants, media links, and associated documents when requested via include. Experimental — event co
• openstates_list_jurisdictions List all jurisdictions covered by Open States — all 50 states, DC, and 5 US territories (American Samoa, Guam, Northern Mariana Islands, Puerto Rico, and the US
• openstates_get_jurisdiction Fetch full metadata for a specific jurisdiction including all legislative sessions, their identifiers, and coverage dates. Use when you need to know the exact s

Details

• Version: 0.4.0
• Transports: streamable-http, stdio
• Uptime (7 days): 100%
• Median latency: 781 ms
• First indexed: 2026-11-01T09:26:29.389Z
• Last seen in registry: 2026-11-01T09:26:29.848Z
• Repository: https://github.com/cyanheads/openstates-mcp-server

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.cyanheads/openstates-mcp-server.svg)](https://lookupd.com/servers/io.github.cyanheads/openstates-mcp-server)

• 62092 servers
• Last crawl: 2026-11-11T17:38:11.606Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp