Data · Remote MCP server

Openstates MCP Server

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

What the MCP Registry states

The entry as published to the official MCP Registry (read 2026-10-04), latest version.

Registry name
io.github.cyanheads/openstates-mcp-server
Version
0.3.2
Status
Active
Category
data
Transport
Streamable HTTP, stdio (local process)
Package
npm
Published
2026-09-20
Updated
2026-09-20
Publisher
cyanheads (GitHub) · 140 servers with pages here
Namespace
Namespace verified by the MCP Registry via GitHub (github.com/cyanheads) · how
Repository
github.com/cyanheads/openstates-mcp-server
Source
Registry API entry

Remote endpoints

TransportURLHeaders declared
Streamable HTTPhttps://openstates.caseyjhand.com/mcpNone

Live check

This directory connected to each remote endpoint and asked for its list of tools. The check connects and lists tools only; it doesn't run tools, sign in or test security.

Reachable
Yes (HTTP 200)
Handshake
openstates-mcp-server 0.3.2 · protocol 2025-06-18
Tools discovered
10: 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, openstates_list_jurisdictions, openstates_get_jurisdiction
Checked on
2026-10-05

How the live check works

Packages

RegistryPackageVersionTransportEnvironment variables
npmruntime: bun@cyanheads/openstates-mcp-server0.3.2stdioOPENSTATES_API_KEY (required), OPENSTATES_DAILY_REQUEST_BUDGET, OPENSTATES_REQUEST_TIMEOUT_MS, OPENSTATES_TOTAL_REQUEST_BUDGET_MS, MCP_LOG_LEVEL
npmruntime: bun@cyanheads/openstates-mcp-server0.3.2HTTPOPENSTATES_API_KEY (required), OPENSTATES_DAILY_REQUEST_BUDGET, OPENSTATES_REQUEST_TIMEOUT_MS, OPENSTATES_TOTAL_REQUEST_BUDGET_MS, MCP_HTTP_HOST, MCP_HTTP_PORT, MCP_HTTP_ENDPOINT_PATH, MCP_AUTH_MODE, MCP_LOG_LEVEL

How to connect Openstates MCP Server

Openstates MCP Server is a remote MCP server: there is nothing to install. Its endpoint is https://openstates.caseyjhand.com/mcp, served over Streamable HTTP. In an assistant that accepts remote MCP servers (often under a setting named connectors, integrations or tools), add a new server and give it this URL; in a client configured by file, add it as a remote (HTTP) server with the same URL.

No headers are declared in the registry entry. If the server needs you to sign in, a client that supports MCP authorization opens the service's own sign-in page when it first connects.

It can also run locally from a Node.js package published to the npm registry: @cyanheads/openstates-mcp-server version 0.3.2. It speaks MCP over stdio, so the client starts it as a program and talks to it through standard input and output. It needs Node.js; clients usually start it with npx - the usual command is npx -y @cyanheads/openstates-mcp-server@0.3.2; the entry names bun as the runtime. It reads these environment variables: OPENSTATES_API_KEY (required), OPENSTATES_DAILY_REQUEST_BUDGET, OPENSTATES_REQUEST_TIMEOUT_MS, OPENSTATES_TOTAL_REQUEST_BUDGET_MS and MCP_LOG_LEVEL; set them in the client's configuration for this server.

It can also run locally from a Node.js package published to the npm registry: @cyanheads/openstates-mcp-server version 0.3.2. The package starts a local server that speaks MCP over Streamable HTTP; the client then connects to it by URL (the entry names bun as the runtime). It reads these environment variables: OPENSTATES_API_KEY (required), OPENSTATES_DAILY_REQUEST_BUDGET, OPENSTATES_REQUEST_TIMEOUT_MS, OPENSTATES_TOTAL_REQUEST_BUDGET_MS, MCP_HTTP_HOST, MCP_HTTP_PORT, MCP_HTTP_ENDPOINT_PATH, MCP_AUTH_MODE and MCP_LOG_LEVEL; set them in the client's configuration for this server.

In the mcpServers JSON format that many desktop and editor MCP clients read, the entry looks like this (placeholders in angle brackets):

{
  "mcpServers": {
    "openstates-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/openstates-mcp-server@0.3.2"
      ],
      "env": {
        "OPENSTATES_API_KEY": "<value>",
        "OPENSTATES_DAILY_REQUEST_BUDGET": "<value>",
        "OPENSTATES_REQUEST_TIMEOUT_MS": "<value>",
        "OPENSTATES_TOTAL_REQUEST_BUDGET_MS": "<value>",
        "MCP_LOG_LEVEL": "<value>"
      }
    }
  }
}

Derived from the registry entry; the live check above only shows whether the endpoint answered. What the server does, and on what terms, is set by its publisher; check its repository or website before giving it access to your accounts or files. How to add an MCP server to an assistant · Before you connect

More from cyanheads (GitHub)

All 140 →
ServerRunsEndpoint or package
Openaq MCP ServerFind air-quality stations and read pollutant observations from government monitors via OpenAQ v3.Remote & Local · HTTP, stdioLive check: ✗ no handshakeopenaq.caseyjhand.com
Openchargemap MCP ServerFind EV charging stations, detail, and reliability check-ins via the global Open Charge Map.Remote & Local · HTTP, stdioLive check: ✓ handshakeopenchargemap.caseyjhand.com
Openfda MCP ServerQuery FDA data on drugs, food, devices, and recalls via openFDA. STDIO or Streamable HTTP.Remote & Local · HTTP, stdioLive check: ✓ handshakeopenfda.caseyjhand.com
Openfec MCP ServerAccess FEC campaign finance data. Query data about candidates, money trails, and election filings.Remote & Local · HTTP, stdioLive check: ✓ handshakeopenfec.caseyjhand.com
Openfoodfacts MCP ServerBarcode lookup, nutrition search, and product comparison for 3M+ crowd-sourced food products.Remote & Local · HTTP, stdioLive check: ✓ handshakeopenfoodfacts.caseyjhand.com
Openlibrary MCP ServerSearch books and authors, fetch editions, browse subjects, and resolve cover images.Remote & Local · HTTP, stdioLive check: ✓ handshakeopenlibrary.caseyjhand.com
Openstreetmap MCP ServerGeocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data.Remote & Local · HTTP, stdioLive check: ✓ handshakeopenstreetmap.caseyjhand.com
Orcid MCP ServerResearcher profiles, works, affiliations, funding, and peer reviews from the ORCID registry.Remote & Local · HTTP, stdioLive check: ✓ handshakeorcid.caseyjhand.com
Osv Advisory MCP ServerQuery OSV.dev for package vulnerabilities and batch-audit dependency lists via MCP.Remote & Local · HTTP, stdioLive check: ✓ handshakeosv-advisory.caseyjhand.com
Ourairports MCP ServerOffline global aviation reference - airports, runways, navaids, frequencies from OurAirports.Remote & Local · HTTP, stdioLive check: ✓ handshakeourairports.caseyjhand.com
Paleobiology MCP ServerSearch fossil occurrences, taxon ranges, diversity through deep time, and the geologic time scale.Remote & Local · HTTP, stdioLive check: ✓ handshakepaleobiology.caseyjhand.com
Pentest MCP ServerOffline methodology engine for authorized penetration testing, CTF, and security research.Remote & Local · HTTP, stdioLive check: ✓ handshakepentest.caseyjhand.com

More data servers

All 4,815 →
ServerRunsEndpoint or package
OpenQRGenerate, edit and track dynamic (editable) QR codes with scan analytics. Hosted MCP and REST API.Remote & Local · HTTP, stdioLive check: ✓ handshakeopenqr.uk
OpenregistryLive data from 27 official national company registries. Unmodified. For KYB and due diligence.Remote · HTTPLive check: sign-in requiredopenregistry.sophymarine.com
OpenResearch MCPZero-auth research MCP: web, academic, finance, news, weather, macro, social, SEC. No keys.Local · stdioPyPI: openresearch-mcp
OpenRevenueOpenRevenue analytics MCP: projects, stats, visitors, funnels, and goals via API key or OAuth.Remote · HTTPLive check: sign-in requiredmcp.openrevenue.com
OpenSwissDataSwiss customs tariff (TARES), FINMA register, NOGA/NACE/ISIC codes. 3 free tools + search trial.Remote & Local · HTTP, stdioLive check: ✓ handshakemcp.openswissdata.com
OpenWeather for agentsOpenWeather data for AI agents: list feeds, sign up, check balance, get a top-up link, fetch data.Remote · HTTPLive check: ✓ handshakemcp.openweathermap.org
Openwebninja MCPOfficial MCP server for OpenWeb Ninja APIs - 40+ real-time web data and SERP APIs as MCP tools.Local · stdionpm: @openwebninja/mcp-server
Openzim MCPOffline MCP access to ZIM knowledge archives - Wikipedia, Wiktionary, Stack Exchange, Kiwix.Local · stdioPyPI: openzim-mcp