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
claude mcp add --transport http openstates-mcp-server https://openstates-mcp-server--cyanheads.run.toolsWhat 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/abc123with 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.toolsPlatform CLI: remote server
codex mcp add openstates-mcp-server --url https://openstates-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"openstates-mcp-server": {
"url": "https://openstates-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"openstates-mcp-server": {
"type": "http",
"url": "https://openstates-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http openstates-mcp-server https://openstates-mcp-server--cyanheads.run.toolsStep 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.