Openstates MCP server

online · 100% uptime

by cyanheads·io.github.cyanheads/openstates-mcp-server·v0.4.0·2 stars

No reviews yet

Search bills, legislators, committees, and events across all 50 US states, DC, and 5 US territories.

A93/100grade A

Write a review Run it

What users say

No reviews yet

Be the first

Safety scan

A93/100

not scanned yet

Adoption

Growing

2 stars156 downloads/wk

Reviews

Write one

Nobody has reviewed Openstates yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Openstates tools

Tool list not cached yet. `describe` through the gateway fetches it live.

Not scanned yet. New listings are scanned within a day or two of arriving.

How Openstates compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 93/100; higher than 95% of 3,470 Web search servers
Uptime: 100%; of our recent checks; the typical remote Web search server answers 100%
Response time: 523 ms; faster than 28% of 2,238 Web search servers
GitHub stars: 2; more than 70% of 1,786 Web search servers
Downloads a week: 156; more than 67% of 827 Web search servers with a package

Release history: 5 versions in the registry since 2026-08-25, latest 2026-10-28, typically one every 19 days.

Install Openstates in Claude Code, Cursor or VS Code

claude mcp add --transport http openstates-mcp-server https://openstates.caseyjhand.com/mcp

Add to Cursor

What the publisher says

From the Openstates repository's README, as published. We do not edit it. Read it on GitHub

@cyanheads/openstates-mcp-server Search bills, legislators, committees, and events across all 50 US states, DC, and 5 US territories via MCP. STDIO or Streamable HTTP. 10 Tools • 1 Resource • 2 Prompts

Public Hosted Server: https://openstates.caseyjhand.com/mcp

Overview

US state legislative data from the Open States v3 API — all 50 states, DC, and 5 US territories. Search and fetch bills, legislators, committees, events, and jurisdiction coverage metadata from any MCP client. Runs as a stdio process, a local Streamable HTTP server, or the public hosted endpoint above.

Tools

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Openstates: common questions

Is Openstates MCP server safe?: Yes, by our scan: it is graded A (93/100). Read the Openstates safety report
How do I install Openstates?: It runs remotely at openstates.caseyjhand.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does Openstates need an API key?: No secret keys are declared. It reads 15 settings from the environment.
Is Openstates maintained?: The last commit was 26 days ago (2026-10-09). The latest release is v0.4.0.
Is Openstates up?: 100% of our last 28 checks got an answer. We check remote servers about four times a day.
What can I use instead of Openstates?: Servers from other publishers that do the same job: Jshookmcp MCP server, AIHOT MCP server and Sui Knowledge Base (kapa.ai) MCP server.
How does Openstates compare with other Web search MCP servers?: safety score 93/100 (higher than 95% of 3,470 Web search servers); uptime 100% (of our recent checks; the typical remote Web search server answers 100%); response time 523 ms (faster than 28% of 2,238 Web search servers). Full comparison.

Alternatives to Openstates

Same job from other publishers: the closest match first, then the best rated.

Jshookmcp
Search-first MCP server for JavaScript reverse engineering: 735 tools across 36 domains.
not reviewed
Established
C
AIHOT
Chinese AI news: search topics, explore hot events, and read daily, weekly and monthly briefs.
not reviewed
Established
B
Sui Knowledge Base (kapa.ai)
Semantic search across Sui documentation and knowledge sources, powered by kapa.ai
not reviewed
Established
A
Free Search
No-API-key web search, page fetching and document reading across many engines. Local-first.
not reviewed
Established
B
GEO Tracker by DigestSEO
Track brand citations across seven AI search surfaces. Free OSS; optional EUR 99 client-ready audit.
not reviewed
Established
B

Run it through the gateway

With the gateway added, ask your agent for it by name:

agent prompt

call io.github.cyanheads/openstates-mcp-server → <tool>

Free per call. Metered, capped by your key, logged for reliability.

Add the gateway (gw.mcp.market)

Rating: —
Safety grade: A · 93/100
Stars: 2
Downloads/wk: 156
Price: Free
Licence: Apache-2.0
Transport: Remote · mixed
Uptime: 100% · 28/28 checks
Version: 0.4.0
Category: Web search
Last release: 2026-10-09

Credentials it needs

OPENSTATES_API_KEYOpen States API key from open.pluralpolicy.com. Required to make any API requests.
OPENSTATES_DAILY_REQUEST_BUDGETMaximum upstream Open States requests per rolling 24 hours. Rejects before the request is issued once spent. Defaults to the v3 free-tier daily cap.
OPENSTATES_REQUEST_TIMEOUT_MSPer-attempt upstream request deadline in milliseconds (minimum 1000). Expiry is non-retryable. Open States answers a scoped query in under a second to ~57s and its gateway gives up near 60s.
OPENSTATES_TOTAL_REQUEST_BUDGET_MSWall-clock ceiling in milliseconds for one call across every retry attempt and the backoff between them. Bounds a slow upstream that keeps failing retryably. Must be at least OPENSTATES_REQUEST_TIMEOUT_MS; startup rejects a lower value.
MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_TRANSPORT_TYPESelects the HTTP transport.
OPENSTATES_API_KEYOpen States API key from open.pluralpolicy.com. Required to make any API requests.
OPENSTATES_DAILY_REQUEST_BUDGETMaximum upstream Open States requests per rolling 24 hours. Rejects before the request is issued once spent. Defaults to the v3 free-tier daily cap.
OPENSTATES_REQUEST_TIMEOUT_MSPer-attempt upstream request deadline in milliseconds (minimum 1000). Expiry is non-retryable. Open States answers a scoped query in under a second to ~57s and its gateway gives up near 60s.
OPENSTATES_TOTAL_REQUEST_BUDGET_MSWall-clock ceiling in milliseconds for one call across every retry attempt and the backoff between them. Bounds a slow upstream that keeps failing retryably. Must be at least OPENSTATES_REQUEST_TIMEOUT_MS; startup rejects a lower value.
MCP_HTTP_HOSTThe hostname for the HTTP server.
MCP_HTTP_PORTThe port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Endpoint

https://openstates.caseyjhand.com/mcp

streamable-http

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/cyanheads-openstates-mcp-server.svg)](https://mcp.market/server/cyanheads-openstates-mcp-server)

How the badge works