NYS Open Legislation
Search New York State bills, laws, members and hearings from an AI assistant
- 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-mcpAdd 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 existsNYS_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.