Skip to main content
MCP server CX Codex

openstates-mcp-server — Claude Code MCP server: US legislation search

openstates-mcp-server searches bills, legislators, committees and hearings in every US state, DC and five territories via Open States API.

Apache-2.0 1,468 installs ★ 3 updated 2026-10-09

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http openstates-mcp-server https://openstates-mcp-server--cyanheads.run.tools
Open on GitHub

What openstates-mcp-server does

The server gives the agent 10 tools for state legislation: openstates_search_bills runs full-text bill searches with filters for session, chamber, sponsors and subject tags; openstates_get_bill fetches bill detail by OCD ID or jurisdiction+session+bill_id triple; openstates_search_people and openstates_get_legislators_by_location find legislators by name, district or latitude/longitude; openstates_search_committees and openstates_get_committee list committees with rosters (coverage is incomplete); openstates_search_events and openstates_get_event search hearings and sessions with agenda and media links; openstates_list_jurisdictions and openstates_get_jurisdiction provide metadata for all 56 jurisdictions and their sessions.

Resource openstates://jurisdiction/{+jurisdiction_id} injects jurisdiction metadata as reference context. Two prompts — openstates_bill_research and openstates_legislator_profile — structure bill analysis and legislator profiling. Skill openstates-guide explains request chains and API limits to the agent.

For Claude Code and Codex the server runs over a public HTTP endpoint https://openstates-mcp-server--cyanheads.run.tools, no API key required. Cursor, GitHub Copilot and Gemini CLI need one command with the same URL.

What it helps with

  • Find every bill in a state by keyword and filter by session or sponsor
  • Identify who represents an address in the state legislature
  • Pull a legislator's voting record and sponsored bills
  • Check committee agenda and hearing schedule
  • Compare bill versions and track actions

Example prompts for the agent

  • Find all California bills from 2024 tagged education
  • Who represents coordinates 37.7749, -122.4194 in the legislature?
  • Show bill ocd-bill/abc123 with votes and sponsors

How to install openstates-mcp-server

Platform CLI: remote server

claude mcp add --transport http openstates-mcp-server https://openstates-mcp-server--cyanheads.run.tools

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about openstates-mcp-server

How to install openstates-mcp-server in Claude Code?

Run claude mcp add --transport http openstates-mcp-server https://openstates-mcp-server--cyanheads.run.tools — the server connects without an API key.

What does openstates-mcp-server do?

It connects the agent to Open States API: search bills, legislators, committees and hearings for every US state, DC and five territories.

Which states does openstates-mcp-server cover?

Every state, DC and five US territories (Puerto Rico, Virgin Islands, Guam, American Samoa, Northern Mariana Islands) — 56 jurisdictions total.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open