openstates-guide

openstates-guide is a skill for Claude Code from cyanheads/openstates-mcp-server. It costs 78 tokens per session (1,885 once invoked), scanned A, original, Apache-2.0.

A research guide for Open States, a service that collects information about US state and territorial legislatures. It helps trace bills, votes, legislators, committees, and hearings while keeping state government separate from Congress.

In plain words
What is it for?
Use it to investigate a bill's progress, votes, sponsors, hearings, committees, legislators, or representatives for a location.
Why use it?
It reduces errors from ambiguous jurisdictions, stale legislative data, missing coordinates, or treating an absent search result as proof that something does not exist. It also identifies when federal sources or a geocoder are needed.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the openstates-mcp-server plugin — 35 skills, 1 MCP server shipped together

Good fit Use it to investigate a bill's progress, votes, sponsors, hearings, committees, legislators, or representatives for a location.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/cyanheads/openstates-mcp-server/openstates-guide
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add cyanheads/openstates-mcp-server --skill openstates-guide
Clone the repo
git clone --depth 1 https://github.com/cyanheads/openstates-mcp-server

Made for: Claude Code.

Or install openstates-mcp-server, the plugin that ships this one along with the rest of its 35 skills, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for openstates-guide

README.md
[![agentmods](https://agentmods.dev/badge/skills/cyanheads/openstates-mcp-server/openstates-guide/github.svg)](https://agentmods.dev/skills/cyanheads/openstates-mcp-server/openstates-guide)
Your own site
<a href="https://agentmods.dev/skills/cyanheads/openstates-mcp-server/openstates-guide"><img src="https://agentmods.dev/badge/skills/cyanheads/openstates-mcp-server/openstates-guide/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for openstates-guide

Your own site · 80×15
<a href="https://agentmods.dev/skills/cyanheads/openstates-mcp-server/openstates-guide"><img src="https://agentmods.dev/badge/skills/cyanheads/openstates-mcp-server/openstates-guide.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 78 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,885 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00078 $0.01885
Opus 5.5 $0.00031 $0.00754
Sonnet 5.5 $0.00016 $0.00377
Haiku 4.5 $0.00008 $0.00188

Measured yesterday against content hash 76662f5f84be, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

openstates-guide scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/openstates-guide/SKILL.md · 72 lines

How it starts

The opening of the file, as written. The whole thing — 72 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Scope

State legislatures through Open States: bills, votes, legislators, committees, and hearings for the 50 states, DC, and the five US territories, scraped from each legislature's site and trailing it by hours to days.

  • Congress is out of scope, though openstates_get_legislators_by_location returns a coordinate's members of Congress alongside its state legislators. Federal bills and votes come from a Congress.gov source such as congressgov-mcp-server.
  • The server does not geocode. Turn an address into decimal coordinates with a geocoder (openstreetmap-mcp-server composes) before the location lookup.

Identifiers

ID Form Comes from Feeds
Jurisdiction ocd-jurisdiction/country:us/state:tx/government; tools also take Texas or tx openstates_list_jurisdictions every jurisdiction input, including the jurisdiction resource URI
Session 89R, 892, 20252026, 2025-2026 the identifier of each legislative session from openstates_get_jurisdiction session filters, the openstates_get_bill path lookup
Bill (OCD) ocd-bill/<uuid> id on openstates_search_bills results openstates_get_bill direct lookup, copied verbatim
Bill (legislature) HB 2, SB 1090 a bill's identifier, its related bills, event agenda entries openstates_get_bill with jurisdiction and session
Person ocd-person/<uuid> legislator results, sponsorships, vote positions, committee memberships openstates_search_people by id; the bill sponsor filter
Committee ocd-organization/<uuid> openstates_search_committees openstates_get_committee; the parent filter for subcommittees
Event ocd-event/<uuid> openstates_search_events openstates_get_event

A person ID is stable across sessions. A bill's IDs are not: a bill reintroduced next session gets a new identifier and a new OCD ID.

Gates

Pin the session before naming a bill. A bill identifier is unique only within one session of one jurisdiction. HB 2 is a different bill in every session, special sessions included, and Texas's 2025 alone runs 89R, 891, and 892. Read the sessions from openstates_get_jurisdiction, choose by start and end dates, and pass the exact identifier, never a year or the session's name. When "this session" spans a regular session and called sessions, say which one you answered for.

Read the full file on GitHub · 72 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 72 lines · 78 tokens per session scan A 76662f5f84be

Subscribe to this mod's changes

openstates-guide is a skill published in the GitHub repository cyanheads/openstates-mcp-server (2 stars, last pushed 2d ago), licensed Apache-2.0. It adds 78 tokens to every session and 1,885 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-28.

Related

Other skills, from other repositories

congressgov-guide

Use congressgov tools for legislative research across bills, enacted laws, members, committees, votes, and Congressional Record documents. Resolve linked identifiers, select the relevant document version, and check discovery coverage before reporting absence.

cyanheads/congressgov-mcp-server · 48 tokens

patsnap-patent-literature-search

Search Patsnap's global patent and scientific literature databases together using natural-language, semantic, keyword, and BM25-based queries with multidimensional filters, then fetch patent or literature records as Markdown.

patsnap/patent-literature-search-mcp · 48 tokens

wikidata-guide

Use wikidata tools to identify entities, verify qualified claims, join external identifiers, and build SPARQL graph queries. Use for Wikidata research that needs identity disambiguation, statement evidence, or completeness checks.

cyanheads/wikidata-mcp-server · 48 tokens

evidence-bundle

For ONE obligation (article-50, article-53 GPAI transparency, dora or cra) and an optional subject: the obligation record, its counsel-gate status and the already-signed measurement cards that are relevant to it, read from GET /api/evidence-bundle. The same module as the free MCP tool evidencebundlepreview.…

CSOAI-ORG/councilof-ai · 157 tokens

article50-detect

Verify a C2PA-style signed manifest for AI-generated content (EU AI Act Article 50) at POST https://councilof.ai/api/detect. Deterministically checks the Ed25519-signed metadata layer and the IPTC/schema.org digitalSourceType; returns AIMARKED / NOTAIMARKED / UNVERIFIABLE with a signed verdict receipt (in-toto/DSSE…

CSOAI-ORG/councilof-ai · 131 tokens

pack

Assemble a Council of AI attested measurement pack via the CSOAI 402 rail. Use when the user says pack assemble, agent invoice, x402 pack, or first-buyer pack. The board stays free; the pack is a paid assembly of existing evidence, never a grade.

CSOAI-ORG/councilof-ai · 61 tokens