Skip to content
MCP server

NYS Open Legislation

Search New York State bills, laws, members and hearings from an AI assistant

Runs locally
Install
Pricing
Free
Platforms
CLI, self-hosted
Runs
Locally
Version
2.6.0
Listing updated
4 days ago

Similar MCP servers

About NYS Open Legislation

NYS Open Legislation is a free MCP server for legal and government. It runs locally on your machine and is started by your AI client.

Its dataset is the NYS Open Legislation API run by the New York State Senate, which the README says covers more than 150,000 bills and resolutions back to 2009. BetaNYC, a civic technology group, built this server as part of a suite of civic data servers for New York.

A free API key is needed for live data. As an option, you can build a local SQLite corpus with scripts from the git repository; when one exists the server answers from it first and labels results with the sync date, falling back to the live API when a record is missing. With a corpus but no key it runs in local-only mode, and five tools without local coverage say so rather than failing. It refuses to start only when both are missing.

Bill links point at the public nysenate.gov site.

Install

Run in a terminal

claude mcp add nys-openlegislation-mcp --env NYS_LEGISLATION_API_KEY='<NYS_LEGISLATION_API_KEY>' -- npx -y @betanyc/nys-openlegislation-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "nys-openlegislation-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@betanyc/nys-openlegislation-mcp"
      ],
      "env": {
        "NYS_LEGISLATION_API_KEY": "<NYS_LEGISLATION_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "nys-openlegislation-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@betanyc/nys-openlegislation-mcp"
      ],
      "env": {
        "NYS_LEGISLATION_API_KEY": "<NYS_LEGISLATION_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "nys-openlegislation-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@betanyc/nys-openlegislation-mcp"
      ],
      "env": {
        "NYS_LEGISLATION_API_KEY": "<NYS_LEGISLATION_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "nys-openlegislation-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@betanyc/nys-openlegislation-mcp"
      ],
      "env": {
        "NYS_LEGISLATION_API_KEY": "<NYS_LEGISLATION_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "nys-openlegislation-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@betanyc/nys-openlegislation-mcp"
      ],
      "env": {
        "NYS_LEGISLATION_API_KEY": "<NYS_LEGISLATION_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • NYS_LEGISLATION_API_KEYFree NYS Open Legislation API key, needed for live data. Optional only if a local corpus exists
  • NYS_CORPUS_DBPath to the optional local corpus database. Defaults to data/corpus.db in the package

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

get_bill_votes
Votes on a bill.
get_bill_updates
Updates for a bill.
get_committee_meetings
Committee meeting history.
get_updates
Aggregate change feed across content types.
search
Full-text search within a content type.
whats_changed
What changed in this server.
about_betanyc
Who built the server and where to report issues.

What it does

Bills
Search, fetch by print number, list by session and read votes.
Laws
Browse law trees and retrieve section text.
Members and committees
Look up Senate and Assembly members, committees and meeting history.
Calendars and agendas
Floor calendars and committee agendas with vote records.
Transcripts
Floor session and public hearing transcripts.
Local corpus
Optional SQLite copy for offline or heavy use.

Good for

  • Research the history of a bill
  • Look up the text of a state law section
  • Check a committee's agenda and votes
  • Run bulk legislative research offline

Pricing

Free

Free API key from the NYS Senate

NYS Open Legislation FAQ

Do I need an API key?

A free key from legislation.nysenate.gov/public is needed for live data, but a local corpus can serve without one.

How far back does it go?

Bills and resolutions from 2009.

How long does building the corpus take?

The README says a full fetch without law or transcript text takes 2 to 6 hours.

Which Node version?

Node.js 20 or newer.

Is NYS Open Legislation free?

Yes. NYS Open Legislation is free to use.

How do I add NYS Open Legislation to Claude Code?

Run this command in your terminal: claude mcp add nys-openlegislation-mcp --env NYS_LEGISLATION_API_KEY='<NYS_LEGISLATION_API_KEY>' -- npx -y @betanyc/nys-openlegislation-mcp

What are the best alternatives to NYS Open Legislation?

The closest alternatives to NYS Open Legislation are Docket Room, Delilah, NYC Charter, Laws and Rules, Uk Parliament Bills and us-congress-watch.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers