io.github.cyanheads/openstates-mcp-server

Est-ce que io.github.cyanheads/openstates-mcp-server est sûr ?

Au dernier audit MCP Hub, le serveur MCP « io.github.cyanheads/openstates-mcp-server » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 10 outils

• openstates_get_bill≈ 3285 tokens

  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.

  Paramètres, retour & exemple (5)

  Paramètres

  • bill_id · string · optionnel
    Bill identifier as used by the legislature (e.g., "HB 1000", "SB 42"). Required with jurisdiction + session.
  • include · array · optionnel
    Related data to inline. "sponsorships", "actions", "votes" are most commonly needed. "versions" and "documents" provide links to bill text and fiscal notes.
  • session · string · optionnel
    Session identifier. Required with jurisdiction + bill_id.
  • jurisdiction · string · optionnel
    State name, abbreviation, or OCD-ID. Required when using path-based lookup with session + bill_id.
  • openstates_id · string · optionnel
    OCD bill ID from openstates_search_bills results (e.g., "ocd-bill/..."). Preferred over the three-part path when available.

  Exemple d'appel

  {"name": "openstates_get_bill", "arguments": {"bill_id": "texte", "include": [], "session": "texte", "jurisdiction": "texte", "openstates_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"id": "texte", "error": {}, "title": "texte", "votes": [], "actions": [], "session": "texte", "sources": [], "subject": [], "versions": [], "abstracts": [], "documents": [], "identifier": "texte"}}

• openstates_get_committee≈ 1098 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • include · array · optionnel
    Related data to inline. "memberships" includes the full roster with member roles. "links" includes the committee homepage and reference links, and "sources" the provenance URLs behind the record.
  • committee_id · string · requis
    OCD organization ID (from openstates_search_committees results).

  Exemple d'appel

  {"name": "openstates_get_committee", "arguments": {"committee_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"id": "texte", "name": "texte", "error": {}, "links": [], "sources": [], "parent_id": "texte", "memberships": [], "classification": "texte"}}

• openstates_get_event≈ 1668 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • include · array · optionnel
    Related data to inline. "agenda" and "participants" are most useful; "links", "media", and "documents" add related URLs, recordings, and files, and "sources" the provenance URLs behind the record.
  • event_id · string · requis
    OCD event ID (from openstates_search_events results).

  Exemple d'appel

  {"name": "openstates_get_event", "arguments": {"event_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"id": "texte", "name": "texte", "error": {}, "links": [], "media": [], "agenda": [], "status": "texte", "sources": [], "end_date": "texte", "location": {}, "documents": [], "start_date": "texte"}}

• openstates_get_jurisdiction≈ 1398 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • include · array · optionnel
    Related data to inline. "legislative_sessions" returns all historical and current sessions with identifiers and date ranges. "organizations" lists the jurisdiction's legislative chambers and executive bodies. "latest_runs" shows last scraper run metadata.
  • jurisdiction_id · string · requis
    OCD jurisdiction ID, state name (e.g., "Washington"), or two-letter abbreviation (e.g., "wa").

  Exemple d'appel

  {"name": "openstates_get_jurisdiction", "arguments": {"jurisdiction_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"id": "texte", "url": "texte", "name": "texte", "error": {}, "latest_runs": [], "organizations": [], "classification": "texte", "latest_bill_update": "texte", "latest_people_update": "texte", "legislative_sessions": []}}

• openstates_get_legislators_by_location≈ 2109 tokens

  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.

  Paramètres, retour & exemple (3)

  Paramètres

  • include · array · optionnel
    Related data to inline. "offices" includes phone, fax, and address. "links" includes website and social links. "other_names" includes alternate/former names, "other_identifiers" cross-system IDs, and "sources" the provenance URLs behind the record.
  • latitude · number · requis
    Latitude in decimal degrees (e.g., 47.6062 for Seattle, WA).
  • longitude · number · requis
    Longitude in decimal degrees (e.g., -122.3321 for Seattle, WA).

  Exemple d'appel

  {"name": "openstates_get_legislators_by_location", "arguments": {"latitude": 1, "longitude": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"count": 1, "error": {}, "notice": "texte", "stateCount": 1, "legislators": [], "federalCount": 1}}

• openstates_list_jurisdictions≈ 1868 tokens

  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").

  Paramètres, retour & exemple (4)

  Paramètres

  • page · integer · optionnel
    Page number (1-indexed).
  • include · array · optionnel
    Related data to inline. "legislative_sessions" returns all session identifiers and date ranges — required when you need to discover valid session values for bill searches. "organizations" lists the jurisdiction's legislative chambers and executive bodies, and "latest_runs" the recent scraper run history.
  • per_page · integer · optionnel
    Results per page (upstream maximum 52). The default call returns the complete state inventory (56) in one response by fetching and merging the pages server-side; set a smaller value only to page manually.
  • classification · string · optionnel · state | municipality | country
    Filter by jurisdiction type. Use "state" (default) for all 50 states, DC, and the 5 US territories.

  Exemple d'appel

  {"name": "openstates_list_jurisdictions", "arguments": {"page": 1, "include": [], "per_page": 1, "classification": "state"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"page": 1, "error": {}, "maxPage": 1, "results": [], "pagination": {}, "totalCount": 1}}

• openstates_search_bills≈ 4555 tokens

  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.

  Paramètres, retour & exemple (15)

  Paramètres

  • q · string · optionnel
    Full-text search across bill titles, abstracts, and text. Required unless jurisdiction is provided. Pair it with jurisdiction whenever a state is known — a q-only search over every jurisdiction times out upstream for a common term.
  • page · integer · optionnel
    Page number (1-indexed).
  • sort · string · optionnel · updated_asc | updated_desc | first_action_asc | first_action_desc | latest_action_asc | latest_action_desc
    Sort order. Use "latest_action_desc" for bills currently moving through the legislature.
  • chamber · string · optionnel · upper | lower
    Filter by originating chamber. "upper" = Senate, "lower" = House/Assembly.
  • include · array · optionnel
    Related data to inline. "sponsorships" and "actions" cover most research needs without a separate openstates_get_bill call. "votes" adds full vote tallies and per-legislator positions.
  • session · string · optionnel
    Session identifier (e.g., "2025", "2025-2026", "2025rs"). Use openstates_get_jurisdiction with include=legislative_sessions to discover valid values. Omit to search across all sessions.
  • sponsor · string · optionnel
    Filter by sponsor name or OCD person ID.
  • subject · array · optionnel
    Filter to bills tagged with one or more subject categories.
  • per_page · integer · optionnel
    Results per page. Maximum 20. Default 10.
  • action_since · string · optionnel
    ISO 8601 date — only return bills with an action after this date (e.g., "2025-01-01").
  • jurisdiction · string · optionnel
    State name, two-letter abbreviation, or OCD-ID (e.g., "Washington", "wa", or "ocd-jurisdiction/country:us/state:wa/government"). Required unless q is provided.
  • created_since · string · optionnel
    ISO 8601 date — only return bills first entered in Open States after this date (e.g., "2025-01-01"). Use to find newly-introduced bills, as opposed to recently-updated or recently-acted-on.
  • updated_since · string · optionnel
    ISO 8601 date — only return bills updated after this date (e.g., "2025-01-01").
  • classification · string · optionnel
    Bill classification: "bill", "resolution", "constitutional amendment", etc.
  • sponsor_classification · string · optionnel
    Filter sponsor type: "primary", "cosponsor".

  Exemple d'appel

  {"name": "openstates_search_bills", "arguments": {"q": "texte", "page": 1, "sort": "updated_asc", "chamber": "upper", "include": [], "session": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"page": 1, "error": {}, "notice": "texte", "maxPage": 1, "results": [], "pagination": {}, "totalCount": 1, "appliedFilters": {}}}

• openstates_search_committees≈ 1903 tokens

  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.

  Paramètres, retour & exemple (7)

  Paramètres

  • page · integer · optionnel
    Page number (1-indexed).
  • parent · string · optionnel
    OCD organization ID of a parent committee to retrieve its subcommittees.
  • chamber · string · optionnel · upper | lower
    Filter by chamber. "upper" = Senate, "lower" = House/Assembly.
  • include · array · optionnel
    Related data to inline. "memberships" includes the full roster with member roles. "links" includes the committee homepage and reference links, and "sources" the provenance URLs behind the record.
  • per_page · integer · optionnel
    Results per page. Maximum 20.
  • jurisdiction · string · requis
    State name, abbreviation, or OCD-ID. Required — an all-states request exceeds the upstream timeout, so every call must be scoped to a single jurisdiction.
  • classification · string · optionnel · committee | subcommittee
    Filter to parent committees or subcommittees only. Omit for all.

  Exemple d'appel

  {"name": "openstates_search_committees", "arguments": {"jurisdiction": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"page": 1, "error": {}, "maxPage": 1, "results": [], "pagination": {}, "totalCount": 1, "coverageNote": "texte", "appliedFilters": {}}}

• openstates_search_events≈ 2592 tokens

  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 often indicate the state lacks event data rather than no events occurring.

  Paramètres, retour & exemple (7)

  Paramètres

  • page · integer · optionnel
    Page number (1-indexed).
  • after · string · optionnel
    ISO 8601 datetime — events starting after this time. Use to find upcoming hearings.
  • before · string · optionnel
    ISO 8601 datetime — events starting before this time.
  • include · array · optionnel
    Related data to inline. "agenda" includes the meeting agenda with bill references. "participants" includes the committee or chamber hosting the event. "links" and "media" add related URLs and recordings, "documents" the attached files, and "sources" the provenance URLs behind the record.
  • per_page · integer · optionnel
    Results per page. Maximum 20.
  • jurisdiction · string · requis
    State name, abbreviation, or OCD-ID. Required — the Open States events endpoint has no all-states search, so every call must be scoped to a single jurisdiction.
  • require_bills · boolean · optionnel
    When true, only return events with at least one bill on the agenda. Most useful for tracking legislation through committee.

  Exemple d'appel

  {"name": "openstates_search_events", "arguments": {"jurisdiction": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"page": 1, "error": {}, "notice": "texte", "maxPage": 1, "results": [], "pagination": {}, "totalCount": 1, "coverageNote": "texte", "appliedFilters": {}}}

• openstates_search_people≈ 2946 tokens

  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), 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.

  Paramètres, retour & exemple (8)

  Paramètres

  • id · array · optionnel
    OCD person IDs (e.g., "ocd-person/9eddb3cd-868e-42ba-831a-b415fd7ed445"). Required unless jurisdiction is provided — it returns exactly these people, so it scopes the call on its own and needs no jurisdiction alongside it. Resolves the IDs that openstates_search_people results, openstates_get_bill sponsorships[].person.id, and openstates_get_committee memberships[].person_id hand back — any number of them in one call, subject to per_page. An ID Open States does not know matches nothing rather than failing, as does an ID paired with a jurisdiction that person does not belong to.
  • name · string · optionnel
    Name or partial name to match (case-insensitive substring). Narrows within the jurisdiction; it does not substitute for one.
  • page · integer · optionnel
    Page number (1-indexed).
  • include · array · optionnel
    Related data to inline. "offices" includes phone, fax, and address. "links" includes website and social links. "other_names" includes alternate/former names, "other_identifiers" cross-system IDs, and "sources" the provenance URLs behind the record.
  • district · string · optionnel
    District label (e.g., "1", "37", "At-Large"). Formats vary by state.
  • per_page · integer · optionnel
    Results per page. Maximum 20.
  • jurisdiction · string · optionnel
    State name, abbreviation, or OCD-ID. Required unless id is provided — an all-states search exceeds the upstream timeout, so every call must be scoped to a single jurisdiction or to specific person IDs.
  • org_classification · string · optionnel · legislature | executive | lower | upper | government
    Filter by role type. "upper" = Senate, "lower" = House/Assembly, "executive" = governors and executive officials, "legislature" = every legislator (both chambers merged into one paginated set, all upper members then all lower, excluding executive officials). Omitting this filter returns every officeholder including executive ones — it is not equivalent to "legislature".

  Exemple d'appel

  {"name": "openstates_search_people", "arguments": {"id": [], "name": "texte", "page": 1, "include": [], "district": "texte", "per_page": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"page": 1, "error": {}, "notice": "texte", "maxPage": 1, "results": [], "pagination": {}, "totalCount": 1, "appliedFilters": {}}}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://openstates.caseyjhand.com/mcp