search_bills
Pack: openstates · Endpoint: https://gateway.pipeworx.io/openstates/mcp
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.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
jurisdiction | string | yes | 2-letter state code or jurisdiction name |
query | string | no | Free-text search across title/summary |
session | string | no | Session identifier (e.g., “20232024”) |
classification | string | no | bill | resolution | constitutional amendment | etc. |
sponsor | string | no | Legislator name filter |
sort | string | no | updated_desc | updated_asc | first_action_desc | first_action_asc | latest_action_desc | latest_action_asc |
per_page | number | no | 1-50 (default 20) |
page | number | no | 1-based page (default 1) |
Example call
curl -X POST https://gateway.pipeworx.io/openstates/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_bills","arguments":{}}}'
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"openstates": {
"url": "https://gateway.pipeworx.io/openstates/mcp"
}
}
}
See Getting Started for client-specific install steps.