OpenStates

live GovernmentLegal

Bills, legislators, votes in all 50 US states. Closes the federal-vs-state gap left by congress / propublica-congress.

4 tools
0ms auth
free tier 50 calls/day

Tools

search_bills required: jurisdiction

Search bills in a US statehouse.

Parameters
Name Type Description
jurisdiction req string 2-letter state code or name
query opt string Free-text search
session opt string Session ID
classification opt string bill | resolution | etc.
sponsor opt string Sponsor name
sort opt string Sort order
per_page opt number 1-50
page opt number 1-based page
▶ Try it
get_bill

Full bill detail by OpenStates ID, or state/session/identifier.

Parameters
Name Type Description
openstates_id opt string OpenStates bill ID
jurisdiction opt string State code
session opt string Session ID
identifier opt string Bill identifier (e.g., "AB-123")
▶ Try it
search_legislators

Filter legislators by state, name, chamber, party.

Parameters
Name Type Description
jurisdiction opt string State code or name
name opt string Name fragment
org_classification opt string upper | lower | legislature
district opt string District ID
party opt string Party name
per_page opt number 1-50
page opt number 1-based page
▶ Try it
get_legislator required: person_id

Full legislator detail by person ID.

Parameters
Name Type Description
person_id req string OpenStates person ID
▶ Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash 
curl -X POST https://gateway.pipeworx.io/openstates/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash 
curl -X POST https://gateway.pipeworx.io/openstates/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_bills","arguments":{"jurisdiction": "example"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript 
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search_bills", {"jurisdiction":"example"});
ask_pipeworx 
// Or ask in plain English:
const answer = await px.ask("bills, legislators, votes in all 50 us states");