Global law
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
NY State bills, laws, members, committees, calendars and transcripts from NYS Open Legislation
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 9/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 21/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install NYS Open Legislation. Follow https://mcp.popnx.com/i/betanyc-nys-openlegislation-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 19, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server NYS Open Legislation for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "nys-openlegislation": { "command": "npx", "args": [ "-y", "@betanyc/nys-openlegislation-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the NYS Open Legislation tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
SettingsDeveloperEdit Config
{
"mcpServers": {
"nys-openlegislation": {
"command": "npx",
"args": [
"-y",
"@betanyc/nys-openlegislation-mcp"
]
}
}
}Use NYS Open Legislation and tell me what you can do for me, then show me one thing✓ If Claude says it is using NYS Open Legislation or shows a NYS Open Legislation tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
NYS_LEGISLATION_API_KEY Free NYS Open Legislation API key, needed for live data. Optional only if a local corpus existsNYS_CORPUS_DB Path to the optional local corpus database. Defaults to data/corpus.db in the packageDescriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect NYS Open Legislation yet
NYS Open Legislation runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect NYS Open Legislation
B · Others in Law & government data that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
Install Node.js on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server NYS Open Legislation for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user nys-openlegislation -- npx -y @betanyc/nys-openlegislation-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the NYS Open Legislation tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user nys-openlegislation -- npx -y @betanyc/nys-openlegislation-mcpYou should see NYS Open Legislation listed as connected
Use NYS Open Legislation and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using NYS Open Legislation or shows a NYS Open Legislation tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
NYS_LEGISLATION_API_KEY Free NYS Open Legislation API key, needed for live data. Optional only if a local corpus existsNYS_CORPUS_DB Path to the optional local corpus database. Defaults to data/corpus.db in the packageDescriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
Install Node.js on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server NYS Open Legislation for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "nys-openlegislation": { "command": "npx", "args": [ "-y", "@betanyc/nys-openlegislation-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the NYS Open Legislation tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Use NYS Open Legislation and tell me what you can do for me, then show me one thing✓ If Cursor says it is using NYS Open Legislation or shows a NYS Open Legislation tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
NYS_LEGISLATION_API_KEY Free NYS Open Legislation API key, needed for live data. Optional only if a local corpus existsNYS_CORPUS_DB Path to the optional local corpus database. Defaults to data/corpus.db in the packageDescriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
Install Node.js on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server NYS Open Legislation for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "nys-openlegislation": { "type": "stdio", "command": "npx", "args": [ "-y", "@betanyc/nys-openlegislation-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the NYS Open Legislation tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Use NYS Open Legislation and tell me what you can do for me, then show me one thing✓ If VS Code says it is using NYS Open Legislation or shows a NYS Open Legislation tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
NYS_LEGISLATION_API_KEY Free NYS Open Legislation API key, needed for live data. Optional only if a local corpus existsNYS_CORPUS_DB Path to the optional local corpus database. Defaults to data/corpus.db in the packageDescriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Claude Code
claude mcp add --scope user nys-openlegislation -- npx -y @betanyc/nys-openlegislation-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"nys-openlegislation": {
"command": "npx",
"args": [
"-y",
"@betanyc/nys-openlegislation-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"nys-openlegislation": {
"command": "npx",
"args": [
"-y",
"@betanyc/nys-openlegislation-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"nys-openlegislation": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@betanyc/nys-openlegislation-mcp"
]
}
}
}NYS_LEGISLATION_API_KEY secret envNYS_CORPUS_DB envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
The registry name was verified with the GitHub account BetaNYC, which owns the repo
Code last changed today
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Not checked yet
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/betanyc-nys-openlegislation-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed today, and the latest version (3.0.0) reached the registry today.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
In the same category: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
German court decisions (Rechtsprechung) and laws (Gesetze) with citation graph and citation checks.
Search French-language and European case law and French legal texts (codes, statutes, treaties).
Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.
Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.
| This one NYS Open Legislation | Global law | Open Legal Data (Germany) | LibreJustice | InfraNode | Fedlex Connector | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | No | No | No | No | No | No |
| Add with + in Claude | No | No | No | No | No | No |
| Basic checks | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| License | MIT | NOASSERTION | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
An MCP server for the NYS Open Legislation API, maintained by the New York State Senate. Gives AI assistants direct access to the full NYS legislative record — bills, laws, members, committees, calendars, agendas, and transcripts — covering 150,000+ bills and resolutions dating back to 2009.
Built by BetaNYC as part of a suite of civic data MCP servers for New York.
[What's changed](WHATS-CHANGED.md): new tools, corrections and other changes a reader would notice, newest first. Developer detail is in CHANGELOG.md.
| Resource | Tools |
|---|---|
| Bills | Search, get by print number, list by session, get votes, track updates |
| Laws | List all law bodies, browse law trees, retrieve section text |
| Members | List and search Senate and Assembly members |
| Committees | List committees, get details and meeting history |
| Floor Calendars | List and get Senate floor calendars |
| Agendas | List and get committee agendas with vote records |
| Transcripts | Floor session and public hearing transcripts |
| Updates | Aggregate change feed across all content types |
| Search | Full-text ElasticSearch within a content type (bills, laws, agendas, calendars, transcripts, hearings) |
| About this server | What changed in it, who built it, and where its data comes from |
A free API key is strongly recommended, and required for live data. Get one from the NYS Open Legislation portal and set it as the NYS_LEGISLATION_API_KEY environment variable:
NYS_LEGISLATION_API_KEY (e.g. export NYS_LEGISLATION_API_KEY="your-api-key"), or pass it in your MCP client's env block — see InstallationWithout a key, the server still starts as long as a local corpus exists, and serves it in local-only mode. Results are labelled with the corpus sync date and a note saying what refreshes them. The 5 tools with no local coverage (get_bill_votes, get_bill_updates, get_committee_meetings, get_updates, search) return a message naming the key rather than failing opaquely, and a lookup that finds nothing in the corpus says so explicitly — offline, "not in the corpus" and "does not exist" are not the same claim.
The server refuses to start only when both the key and the corpus are missing.
Bill URLs returned by this server point to the public nysenate.gov website — no login required.
Requires Node.js 20 or newer.
No global install needed. Add to your Claude Desktop config and npx handles the rest.
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": { "nys-openlegislation": { "command": "npx", "args": ["-y", "@betanyc/nys-openlegislation-mcp"], "env": { "NYS_LEGISLATION_API_KEY": "your-api-key-here" } } } }
Restart Claude Desktop. The server starts automatically.
npm install -g @betanyc/nys-openlegislation-mcp
Then in your MCP config:
{
"mcpServers": { "nys-openlegislation": { "command": "nys-openlegislation-mcp", "env": { "NYS_LEGISLATION_API_KEY": "your-api-key-here" } } } }
By default the server queries the live NYS Open Legislation API on every request. If you run large workloads — bulk research, repeated searches, or offline use — you can build a local SQLite corpus that the server queries first, falling back to the API only on a cache miss.
The corpus is also what makes the server usable without an API key: with a corpus present and no key, it starts in local-only mode instead of exiting. Building the corpus in the first place does require a key (npm run sync calls the live API), so this is a "borrow a colleague's corpus" or "key expired" path, not a way to skip registration entirely. The corpus location defaults to data/corpus.db in the package and can be overridden with NYS_CORPUS_DB.
The fetch and sync scripts (scripts/) are not included in the npm package — building a local corpus requires a git clone:
git clone https://github.com/BetaNYC/nys-openlegislation-mcp.git
cd nys-openlegislation-mcp npm install
better-sqlite3 is an optional dependency. The server works without it — it just means every request goes to the live API. If its native build was skipped, install it explicitly with npm install better-sqlite3.
NYS_LEGISLATION_API_KEY=your-key node scripts/fetch-data.js
Options:
| Flag | Default | Description |
|---|---|---|
--start-year=YYYY | 2009 | Earliest session year to fetch |
--types=bills,laws,... | all types | Comma-separated list: bills,laws,members,committees,agendas,calendars,transcripts |
--include-law-text | off | Fetch full text of every law section (large — adds significant download time) |
--include-transcript-text | off | Fetch full text of floor and hearing transcripts (very large) |
--delay-ms=N | 150 | Delay between API calls in ms |
--dry-run | off | Print what would be fetched without writing |
The corpus lands in data/corpus.db (override the location with the NYS_CORPUS_DB environment variable — both the server and the scripts honor it). A full fetch without law or transcript text takes 2–6 hours depending on your start year and network speed. The --types flag lets you fetch only what you need.
NYS_LEGISLATION_API_KEY=your-key node scripts/sync.js
Options:
| Flag | Default | Description |
|---|---|---|
--from=YYYY-MM-DDTHH:MM:SS | last sync time | Override the start, in New York local time (the API's own convention) |
--delay-ms=N | 150 | Delay between API calls in ms |
--dry-run | off | Print what would be synced without writing |
The Senate's API reads every time as New York local time. Each sync asks for the changes from where the last one ended up to two minutes ago, and saves that end time with its New York offset (for example 2026-11-13T16:58:00-05:00). A copy last synced by a version before 2.7.0 saved UTC times with no zone, which made each sync skip the changes made in the four or five hours after the previous one; the next sync reads such a value as UTC and starts from the right time. To pick up changes an older version missed, run the sync once with --from set to the day you first built the copy. fetch-data.js never moves an existing sync time forward, so a partial load such as --types=committees does not make the next sync skip anything.
Cron example (nightly at 2am):
0 2 * * * NYS_LEGISLATION_API_KEY=your-key node /path/to/scripts/sync.js >> /var/log/nys-sync.log 2>&1
When data/corpus.db exists and better-sqlite3 is available, every tool handler queries the local DB first. If the record is found locally, it returns immediately without an API call, annotated with "source": "local corpus (synced )" so staleness is visible. If the record is not found — or the local result is empty (0 items) — it falls through to the live API transparently; an empty local slice never shadows live data.
Law section text and transcript full text fall back to the API unless --include-law-text / --include-transcript-text were used during the initial fetch.
AGENDA / BILL / CALENDAR / LAW content types — committee changes never appear in it. Re-run fetch-data.js --types=committees periodically (it is a quick fetch) to refresh committee data.fetch-data.js for those periodically.npm run sync and fetch-data.js (no extra API calls). A corpus built before this change gains the members.full_name column on its next sync. A member who has never prime-sponsored a bill in the corpus has no full name locally.items and size only; the total, offsetStart, offsetEnd and limit fields come from the live API.Every tool rejects parameters it does not declare, rather than ignoring them. Passing an undeclared key returns an error naming both the offending key and the parameters that tool accepts. This is deliberate: silently dropping a filter returns real, correctly-sourced data that answers a *different* question, and nothing in the response would signal it.
| Tool | Description |
|---|---|
search_bills | Full-text bill search with ElasticSearch syntax, optional session year filter (omit it to search all sessions; all sessions in the local corpus, when it answers) |
get_bill | Get a specific bill by print number (e.g. S1234) and session year |
list_bills | List bills introduced in a session year |
get_bill_votes | Get committee and floor vote records for a bill (the votes block of the bill record) |
get_bill_updates | Feed of bill changes within a date range |
| Tool | Description |
|---|---|
list_laws | List all NYS law bodies (Education Law, Labor Law, etc.) |
get_law_tree | Get table of contents for a law body |
get_law_section | Get text of a specific law section |
Citation links. Law records from get_law_section, and search results of type: "laws", carry a nysenate_url field: a link a person can open on nysenate.gov. It is populated only for `SECTION` and `ARTICLE` documents, the two shapes checked in a browser on 2026-08-02 (…/laws/EDN/6233, …/laws/EDN/A125). It is null for every other type, including CHAPTER and TITLE, because their URL shape has not been verified, and a wrong link is worse than none. If the field is populated, use it. If it is null, cite the law and section in plain text. Note that www.nysenate.gov returns 403 to curl, so check a new doc type in a browser before adding it.
| Tool | Description |
|---|---|
list_members | List Senate or Assembly members for a session year |
get_member | Get a specific legislator by member ID; errors if the member sits in the other chamber from chamber |
search_members | Search legislators by name; every row carries chamber, and fullName where known (a locally served member who has never prime-sponsored a bill has none). Defaults to the current session. Served from the local corpus when present (works without a key) |
| Tool | Description |
|---|---|
list_committees | List Senate or Assembly committees |
get_committee | Get committee details — chair, schedule, location |
get_committee_meetings | Get meeting history and bills considered |
| Tool | Description |
|---|---|
list_calendars | List Senate floor calendars for a year |
get_calendar | Get a specific floor calendar with bill lists |
list_agendas | List committee agendas for a year |
get_agenda | Get a specific agenda with vote records |
| Tool | Description |
|---|---|
list_floor_transcripts | List Senate floor session transcripts |
get_floor_transcript | Get a specific floor session transcript |
list_hearing_transcripts | List public hearing transcripts |
| get_hearing_transcript | Get a specif