openstates-mcp-server
io.github.cyanheads/openstates-mcp-servercyanheadsstreamable-httpv0.5.0Scanned
Search bills, legislators, committees, and events across all 50 US states, DC, and 5 US territories.
10 tools: 10 only read.
- Reads private data · 1
- Reads text others write · 10
- Can send data out · 0
- No findings
Tools listed without sign-in. Remote posture
With Anlyon
Decide which of this server's tools your agent can use.
- Anlyon lists the tools and adopts none.
- Each tool you adopt gets approvals and receipts.
- Your agent never holds the key.
A tool your agent calls directly is not routed through Anlyon and is not governed by it. Anlyon Radar only lists and labels, and these labels are the same either way.
What the openstates-mcp-server can do
The openstates-mcp-server is published by the GitHub account cyanheads. It has 10 tools. Every one of them only reads: going by their definitions, none of them creates, changes, sends or deletes anything.
1 tool reads private data (openstates_search_events); 10 tools bring in text other people can write (openstates_search_bills, openstates_get_bill, openstates_search_people and 7 more).
None of the fixed checks matched anything in its tool definitions. That is not a safety guarantee.
Its remote endpoint lists its tools without sign-in, and its tools changed once since Anlyon Radar first saw them.
Last scanned Nov 21, 2026, version 0.5.0.
Tools
Grouped by what each tool does, most consequential first. Open one for its reasons and full description; descriptions are the publisher's own words.
10 tools
Only reads 10Show 10 read-only tools
openstates_get_billFetch full detail for a specific state bill.Reads text others writeNo findings
Why it is in this group
- The name "openstates_get_bill" says "get": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
- openWorldHint: true
openstates_get_committeeFetch committee detail by OCD organization ID.Reads text others writeNo findings
Why it is in this group
- The name "openstates_get_committee" says "get": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it Fetch committee detail by OCD organization ID. Returns name, classification, and membership roster when include=memberships is requested. Experimental — not all states have committee data in Open States. Obtain the committee_id from openstates_search_committees.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
- openWorldHint: true
openstates_get_eventFetch full event detail by OCD event ID.Reads text others writeNo findings
Why it is in this group
- The name "openstates_get_event" says "get": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it Fetch full event detail by OCD event ID. Returns agenda, participants, media links, and associated documents when requested via include. Experimental — event coverage is limited in Open States. Obtain the event_id from openstates_search_events.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
- openWorldHint: true
openstates_get_jurisdictionFetch full metadata for a specific jurisdiction including all legislative sessions, their identifiers, and coverage dates.Reads text others writeNo findings
Why it is in this group
- The name "openstates_get_jurisdiction" says "get": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it Fetch full metadata for a specific jurisdiction including all legislative sessions, their identifiers, and coverage dates. Use when you need to know the exact session identifier for a state before filtering bill searches — session formats vary widely (e.g., "2025", "2025rs", "2025s1"). Jurisdiction IDs follow OCD format: ocd-jurisdiction/country:us/state:{abbr}/government (e.g., ocd-jurisdiction/country:us/state:wa/government). State names (e.g., "Washington") and two-letter abbreviations (e.g., "wa") are also accepted.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
- openWorldHint: true
openstates_get_legislators_by_locationFind every legislator representing a geographic coordinate — both tiers.Reads text others writeNo findings
Why it is in this group
- The name "openstates_get_legislators_by_location" says "get": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it Find every legislator representing a geographic coordinate — both tiers. Pass latitude and longitude to get the state senators and representatives for that location (and potentially governor/executive officials), plus the coordinate's two US Senators and its US Representative. jurisdiction.classification separates the tiers: "state" is a state legislature, "country" is the US Congress. current_role.org_classification does not — it is "upper"/"lower" for a US Senator exactly as for a state senator. Useful for constituent-to-representative matching, address-based policy research, and electoral boundary analysis. This server does not geocode addresses — the caller must provide decimal-degree coordinates. Use include=offices to get contact information alongside the legislator list.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
- openWorldHint: true
openstates_list_jurisdictionsList all jurisdictions covered by Open States — all 50 states, DC, and 5 US territories (American Samoa, Guam, Northern Mariana Islands, Puerto Rico, and the US Virgin Islands): 56…Reads text others writeNo findings
Why it is in this group
- The name "openstates_list_jurisdictions" says "list": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it List all jurisdictions covered by Open States — all 50 states, DC, and 5 US territories (American Samoa, Guam, Northern Mariana Islands, Puerto Rico, and the US Virgin Islands): 56 in total, returned complete in a single default call. Returns coverage metadata: latest bill update time, latest people update time, and optionally all legislative sessions with their identifiers. Use this when you need to discover valid session identifiers for a state before calling openstates_search_bills with a session filter. The legislative_sessions include option returns all historical and current sessions — always check valid session identifiers here before using them in bill searches, since formats vary widely by state (e.g., "2025", "2025-2026", "2025rs", "2025s1").
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
- openWorldHint: true
openstates_search_billsSearch state legislative bills across all covered US jurisdictions.Reads text others writeNo findings
Why it is in this group
- The name "openstates_search_bills" says "search": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it Search state legislative bills across all covered US jurisdictions. Supports full-text search, jurisdiction/session filtering, subject tags, sponsor lookups, and sort order. Either jurisdiction or q (full-text) is required, and pairing them is the reliable form — a q-only search spans all 56 jurisdictions and exceeds the upstream timeout for a common term, though a distinctive one still returns quickly. include=sponsorships,actions returns sponsor and action history inline. sort=latest_action_desc surfaces bills currently moving. openstates_get_jurisdiction with include=legislative_sessions returns valid session identifiers for session filtering.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
- openWorldHint: true
openstates_search_committeesList committees for a jurisdiction.Reads text others writeNo findings
Why it is in this group
- The name "openstates_search_committees" says "search": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it List committees for a jurisdiction. jurisdiction is required — a request spanning all 56 jurisdictions exceeds the upstream timeout, so scope every call to a single state; use openstates_list_jurisdictions to pick one. Experimental — Open States is actively working to restore committee support and not all states have data. Use chamber to scope to upper (senate) or lower (house) committees. Use classification=subcommittee to find subcommittees of a parent. Use include=memberships to get the full roster with member roles. The coverageNote field in the output will always note the experimental coverage limitations.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
- openWorldHint: true
openstates_search_eventsSearch hearings, floor sessions, and committee meetings.Reads private dataReads text others writeNo findings
Why it is in this group
- The name "openstates_search_events" says "search": a word for reading.
What it can reach
- private-dataThe description's first sentence says "search" and "meeting": it reads calendars.
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it Search hearings, floor sessions, and committee meetings. jurisdiction is required — the Open States events endpoint has no all-states search, so scope every call to a single state; use openstates_list_jurisdictions to pick one. Experimental — most states do not publish event data to Open States. Use after and before to scope to a date range. Set require_bills=true to filter to events with bills on the agenda, which is the most useful filter for tracking legislation through committee. Use include=agenda,participants for full meeting context. Empty results from an unfiltered search often indicate the state lacks event data rather than no events occurring.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
- openWorldHint: true
openstates_search_peopleSearch state legislators and officials by name, jurisdiction, chamber, or district, or fetch specific people by OCD person ID.Reads text others writeNo findings
Why it is in this group
- The name "openstates_search_people" says "search": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it Search state legislators and officials by name, jurisdiction, chamber, or district, or fetch specific people by OCD person ID. Party is reported on every result but cannot be filtered on — narrow by party after the call. Either jurisdiction or id is required — a search spanning all 56 jurisdictions exceeds the upstream timeout, including a name-only one, so scope every call to a single state or to specific person IDs. Use openstates_list_jurisdictions to pick a jurisdiction, or openstates_get_legislators_by_location when you have coordinates but no state. id takes the person IDs that openstates_get_bill sponsorships and openstates_get_committee memberships hand back, and resolves any number of them in one call. Supports name substring matching (case-insensitive). org_classification targets a role type: "upper" for Senate, "lower" for House/Assembly, "executive" for governors and executive officials, and "legislature" for every legislator — both chambers merged into one paginated set (all upper members, then all lower), or the single body in Nebraska and the DC Council, which excludes executive-branch officials. Omitting org_classification is not the same as "legislature": it returns every officeholder, executive officials included. include=offices adds phone, fax, and address. include=links adds website and social links.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
- openWorldHint: true
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Exfil surface
Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.
No private-data, untrusted-input, outbound path in this server alone: no tool is tagged outbound.
- Reads private data1
- Reads files, mail, messages, databases, secrets, calendars or repositories.
- Reads text others write10
- Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
- Can send data out0
- Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.
Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.
Remote posture
What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.
Looked at Nov 20, 2026, 19:33 UTC, unchanged since Oct 22, 2026. No credentials were sent and no tool was called. What is looked at.
- Reachable
- yes
- HTTP status of an anonymous initialize
- 200
- tools/list served without credentials
- yes
- Tools that change things, listed without credentials
- 0
- Protocol version
- 2025-06-18
- WWW-Authenticate on 401
- not observed
- resource_metadata in WWW-Authenticate
- not observed
- RFC 9728 protected resource metadata
- not observed
- Authorization servers
- not observed
- Legacy HTTP+SSE transport
- no
- Dynamic client registration
- not observed
- Client ID metadata documents
- not observed
Findings
Matches of fixed checks, with the text they matched.
No check matched anything in these tool definitions. That is not a safety guarantee.
History
Changes to its tool definitions and to its remote endpoint, newest first.
Tools4 changed.~4 changedView diff
- Changed:openstates_get_billOnly readsinputSchema
- Changed:openstates_search_committeesOnly readsinputSchema
- Changed:openstates_search_eventsOnly readsdescription
- Changed:openstates_search_peopleOnly readsdescriptioninputSchema
Install
Pinned to version 0.5.0. Values in angle brackets are yours to fill in.
claude mcp add --transport http openstates https://openstates.caseyjhand.com/mcpclaude mcp add --transport http openstates https://openstates.caseyjhand.com/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__openstates__openstates_search_bills",
"mcp__openstates__openstates_get_bill",
"mcp__openstates__openstates_search_people",
"mcp__openstates__openstates_get_legislators_by_location",
"mcp__openstates__openstates_search_committees",
"mcp__openstates__openstates_get_committee",
"mcp__openstates__openstates_search_events",
"mcp__openstates__openstates_get_event",
"mcp__openstates__openstates_list_jurisdictions",
"mcp__openstates__openstates_get_jurisdiction"
],
"ask": [],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as openstates. Review it before you use it.
Capability tags behind 10 rules
- mcp__openstates__openstates_search_bills untrusted-input
- mcp__openstates__openstates_get_bill untrusted-input
- mcp__openstates__openstates_search_people untrusted-input
- mcp__openstates__openstates_get_legislators_by_location untrusted-input
- mcp__openstates__openstates_search_committees untrusted-input
- mcp__openstates__openstates_get_committee untrusted-input
- mcp__openstates__openstates_search_events private-data, untrusted-input
- mcp__openstates__openstates_get_event untrusted-input
- mcp__openstates__openstates_list_jurisdictions untrusted-input
- mcp__openstates__openstates_get_jurisdiction untrusted-input
Pin
Keep the decision: fail CI when the tools change, follow every change, or show a badge.
Pin in CI
Fail a build when the tools you reviewed are not the tools the server serves today.
curl -s "https://radar.anlyon.com/api/v1/servers/io.github.cyanheads/openstates-mcp-server/verify?hash=027ec1dd4899d0072989007d37747ec61221a5f84dcdb5ad82ba24e46f60eefe" | jq -e '.changed == false'Pinned hash 027ec1dd4899, from Nov 21, 2026, 18:18 UTC.
Watch
Get told when its tools change: a new tool, a new description, a new class.
https://radar.anlyon.com/servers/io.github.cyanheads/openstates-mcp-server/changes.xmlAn Atom feed. Works in any feed reader or Slack's RSS app.
Badge
[](https://radar.anlyon.com/servers/io.github.cyanheads/openstates-mcp-server)Source: MCP Registry · repository. Synced Nov 21, 2026, 19:18 UTC.
openstates-mcp-server: questions and answers
Answered from the scan above, not from the publisher's description.
Is the openstates-mcp-server safe?
- No scan can promise that. What its definitions show: 10 tools, all of which only read, and 0 findings from fixed checks. Read-only tools can still pass private data to a model.
Can the openstates-mcp-server delete data?
- No tool is classed as destructive: going by their definitions, none of them deletes, cancels or revokes anything.
Can the openstates-mcp-server do things that cannot be undone?
- No tool is classed as irreversible: none of them sends, pays, publishes or merges, going by their definitions.
What tools does the openstates-mcp-server have?
- 10 tools: 10 read. openstates_search_bills, openstates_get_bill, openstates_search_people, openstates_get_legislators_by_location, openstates_search_committees, openstates_get_committee, openstates_search_events, openstates_get_event and 2 more.
Does the openstates-mcp-server need sign-in or OAuth?
- Its remote endpoint listed its tools to an anonymous client, without sign-in.
Does the openstates-mcp-server send data to outside services?
- None of its tools sends, posts or publishes, or takes a recipient, channel or URL.
Has the openstates-mcp-server changed its tools?
- Yes, once since Anlyon Radar started tracking it, most recently on Oct 28, 2026. Every change is on this page and in its Atom feed.