MCP server

Openstates

io.github.pipeworx-io/openstates

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

OpenStates MCP — bills, legislators, votes in all 50 US states

Website Source

At a glance

Type

MCP server

Publisher

pipeworx.io (verified by the MCP Registry)

Status

Working at last check

Tools

46

Token cost

About 27,432 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 https://gateway.pipeworx.io/openstates/mcp

Claude Desktop

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

Codex (config.toml)

[mcp_servers.openstates]
url = "https://gateway.pipeworx.io/openstates/mcp"

Gemini CLI

{"mcpServers":{"openstates":{"httpUrl":"https://gateway.pipeworx.io/openstates/mcp"}}}

Cursor

{"mcpServers":{"openstates":{"url":"https://gateway.pipeworx.io/openstates/mcp"}}}

VS Code

{"servers":{"openstates":{"type":"http","url":"https://gateway.pipeworx.io/openstates/mcp"}}}

Antigravity

agy mcp add openstates https://gateway.pipeworx.io/openstates/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","server_url":"https://gateway.pipeworx.io/openstates/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"openstates","server_url":"https://gateway.pipeworx.io/openstates/mcp"}

Tools

• get_bill ~260 tokens
  Fetch a single bill with full detail: versions, sponsorships, related/companion bills, actions, and votes. Pass the OpenStates ID (e.g., "ocd-bill/abc...") or a state/session/identifier triple.
• get_legislator ~113 tokens
  Fetch a single legislator by OpenStates person ID. Returns biographical info, current roles, prior offices, contact methods, sources.
• search_bills ~461 tokens
  Search bills in any US statehouse. Pass jurisdiction as a 2-letter state code (e.g., "CA", "NY", "TX") or full name. Returns bill identifiers, titles, classifications, last action, sponsors, and OpenStates IDs for use with get_bill.
• search_legislators ~295 tokens
  Find state legislators. Filter by jurisdiction, name, chamber (upper/lower), party, or district. Returns name, current/prior roles, party, contact details, OpenStates IDs.

Browse

• GitHub tools
• GitHub and code hosting

Related MCP servers

• Openstates
  Search bills, legislators, committees, and events across all 50 US states, DC, and 5 US territories.
• 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.
• Rootz Officials
  Origin-signed US political data: 25,546 officials, bills, votes, positions with sources.
• Bill Commons
  Search 209k+ US state bills, all 50 states + DC: full text, sponsors, votes, status. Free.
• Swiss Living Index
  Official Swiss data for all 26 cantons and 2,100 communes: tax, rent, health premiums, fuel, jobs.
• vote.direct
  Run a real election or board vote: price it, check state HOA rules, draft the ballot and voter list.

Badge for your README

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

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