io.github.cyanheads/openstates-mcp-server
v0.3.3Search bills, legislators, committees, and events across all 50 US states, DC, and 5 US territories.
Endpoint health
online- Last checked
- 11/20/2026, 9:18:08 AM
- Latency
- 265 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.cyanheads%2Fopenstates-mcp-server
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.cyanheads/openstates-mcp-server": {
"url": "https://openstates.caseyjhand.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
10 shown · authentication unknown
Get Bill
openstates_get_bill
Fetch full detail for a specific state bill. Accepts either the three-part path (jurisdiction + session + bill_id) or a direct OCD bill ID (openstates_id from search results). Use include to request votes, actions, sponsorships, documents, and versions in one call rather than searching again. include=votes returns the full vote tally and per-legislator positions. include=actions returns the complete action history. Prefer openstates_id when available to avoid session identifier lookup.
Schema valid · SHA-256 ae47d2e7d716…
View input schema
{ "type": "object", "properties": { "openstates_id": { "description": "OCD bill ID from openstates_search_bills results: \"ocd-bill/\" followed by a UUID (e.g., \"ocd-bill/4f255ccf-42a6-46ad-bbc6-0b027ebb15f2\"). Preferred over the three-part path when available.", "type": "string" }, "jurisdiction": { "description": "State name, abbreviation, or OCD-ID. Required when using path-based lookup with session + bill_id.", "type": "string" }, "session": { "description": "Session identifier. Required with jurisdiction + bill_id.", "type": "string" }, "bill_id": { "description": "Bill identifier as used by the legislature (e.g., \"HB 1000\", \"SB 42\"). Required with jurisdiction + session.", "type": "string" }, "include": { "description": "Related data to inline. \"sponsorships\", \"actions\", \"votes\" are most commonly needed. \"versions\" and \"documents\" provide links to bill text and fiscal notes.", "type": "array", "items": { "type": "string", "enum": [ "sponsorships", "abstracts", "other_titles", "other_identifiers", "actions", "sources", "documents", "versions", "votes", "related_bills" ] } } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }
Connections
streamable-http
https://openstates.caseyjhand.com/mcp