# openstates-mcp-server

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

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1468 installs · ★ 3 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/openstates-mcp-server
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/openstates-mcp-server

## What it 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.

## Requirements
- Remote server: `https://openstates-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http openstates-mcp-server https://openstates-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add openstates-mcp-server --url https://openstates-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "openstates-mcp-server": {
            "url": "https://openstates-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "openstates-mcp-server": {
            "type": "http",
            "url": "https://openstates-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http openstates-mcp-server https://openstates-mcp-server--cyanheads.run.tools
```

## When to use it
- 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
- 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

## Similar
- [mcp](https://affpapa.org/en/nevibecode/mcp/thechrisgrey-mcp.md) — MCP server
- [Legalize](https://affpapa.org/en/nevibecode/mcp/legalize.md) — MCP server · ★ 2 repo stars
- [America's Law Graph](https://affpapa.org/en/nevibecode/mcp/americas-law-graph.md) — MCP server · 1586 installs
- [socrata-mcp-server](https://affpapa.org/en/nevibecode/mcp/socrata-mcp-server.md) — MCP server · 1882 installs
- [UK Legal Research](https://affpapa.org/en/nevibecode/mcp/uk-legal-research.md) — MCP server · ★ 21 repo stars
- [HowToRomania](https://affpapa.org/en/nevibecode/mcp/howtoromania.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
