MCP server

Openstates

io.github.cyanheads/openstates-mcp-server

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

10

Token cost

About 5,811 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

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

Gemini CLI

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

Cursor

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

VS Code

{"servers":{"openstates-mcp-server":{"type":"http","url":"https://openstates.caseyjhand.com/mcp"}}}

Antigravity

agy mcp add openstates-mcp-server https://openstates.caseyjhand.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"openstates-mcp-server","server_url":"https://openstates.caseyjhand.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"openstates-mcp-server","server_url":"https://openstates.caseyjhand.com/mcp"}

Tools

• openstates_get_bill ~466 tokens
  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 search results). Use include to request votes, actions, sponsorships, documents, and versions in one call rather than searching again. includ
• openstates_get_committee ~262 tokens
  Fetch committee detail by OCD organization ID. Returns name, classification, and membership roster when include=memberships is requested. Experimental — not all states have committee data in Open States. Obtain the committee_id from openstates_search_committees.
• openstates_get_event ~261 tokens
  Fetch full event detail by OCD event ID. Returns agenda, participants, media links, and associated documents when requested via include. Experimental — event coverage is limited in Open States. Obtain the event_id from openstates_search_events.
• openstates_get_jurisdiction ~376 tokens
  Fetch full metadata for a specific jurisdiction including all legislative sessions, their identifiers, and coverage dates. Use when you need to know the exact session identifier for a state before filtering bill searches — session formats vary widely (e.g., "2025", "2025rs", "2025s1"). Jurisdiction
• openstates_get_legislators_by_location ~471 tokens
  Find every legislator representing a geographic coordinate — both tiers. Pass latitude and longitude to get the state senators and representatives for that location (and potentially governor/executive officials), plus the coordinate's two US Senators and its US Representative. jurisdiction.classific
• openstates_list_jurisdictions ~579 tokens
  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 Virgin Islands): 56 in total, returned complete in a single default call. Returns coverage metadata: latest bill update time, latest people
• openstates_search_bills ~1078 tokens
  Search state legislative bills across all covered US jurisdictions. Supports full-text search, jurisdiction/session filtering, subject tags, sponsor lookups, and sort order. Either jurisdiction or q (full-text) is required, and pairing them is the reliable form — a q-only search spans all 56 jurisdi
• openstates_search_committees ~572 tokens
  List committees for a jurisdiction. jurisdiction is required — a request spanning all 56 jurisdictions exceeds the upstream timeout, so scope every call to a single state; use openstates_list_jurisdictions to pick one. Experimental — Open States is actively working to restore committee support and n
• openstates_search_events ~646 tokens
  Search hearings, floor sessions, and committee meetings. jurisdiction is required — the Open States events endpoint has no all-states search, so scope every call to a single state; use openstates_list_jurisdictions to pick one. Experimental — most states do not publish event data to Open States. Use
• openstates_search_people ~1100 tokens
  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 but cannot be filtered on — narrow by party after the call. Either jurisdiction or id is required — a search spanning all 56 jurisdictions

Browse

• GitHub tools
• GitHub and code hosting
• Maps and places
• Government and public data

Related MCP servers

• Openstates
  OpenStates MCP — bills, legislators, votes in all 50 US states
• Legislation
  U.S. bills, roll-call votes, legislators and 2026 elections for all 50 states, D.C. and Congress.
• Washington Code
  Washington state law: the Revised Code of Washington (RCW, statutes) and the
• Civdotiq Civiq
  U.S. civic data for AI agents: reps, votes, bills, finance, lobbying, cited gov sources. 47 tools.
• KeyVex
  US public financial disclosures for AI agents: Congress trades, SEC filings, FEC, lobbying, more
• Congress
  Congress MCP — US Congress bill/law/member data via the official congress.gov API (Library of…
• LiveDataLink
  294 public-data tools across 60 domains; source freshness varies. Free tier.
• Rootz Officials
  Origin-signed US political data: 25,546 officials, bills, votes, positions with sources.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.cyanheads/openstates-mcp-server.svg)](https://aptlynx.net/servers/io.github.cyanheads/openstates-mcp-server)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents