betanyc avatar

NYS Open Legislation

betanyc/nys-openlegislation-mcp

NY State bills, laws, members, committees, calendars and transcripts from NYS Open Legislation

GitHub stars
5
tools
24
auth
Secret needed
transport
STDIO
env vars
2
last updated
Nov 9, 2026

Tools

24 tools

Public tool metadata for what this MCP can expose to an agent.

search_billsFull-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)

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)

No parameter schema in public metadata yet.

get_billGet a specific bill by print number (e.g. `S1234`) and session year

Get a specific bill by print number (e.g. `S1234`) and session year

No parameter schema in public metadata yet.

list_billsList bills introduced in a session year

List bills introduced in a session year

No parameter schema in public metadata yet.

get_bill_votesGet committee and floor vote records for a bill (the `votes` block of the bill record)

Get committee and floor vote records for a bill (the `votes` block of the bill record)

No parameter schema in public metadata yet.

get_bill_updatesFeed of bill changes within a date range

Feed of bill changes within a date range

No parameter schema in public metadata yet.

list_lawsList all NYS law bodies (Education Law, Labor Law, etc.)

List all NYS law bodies (Education Law, Labor Law, etc.)

No parameter schema in public metadata yet.

get_law_treeGet table of contents for a law body

Get table of contents for a law body

No parameter schema in public metadata yet.

get_law_sectionGet text of a specific law section

Get text of a specific law section

No parameter schema in public metadata yet.

list_membersList Senate or Assembly members for a session year

List Senate or Assembly members for a session year

No parameter schema in public metadata yet.

get_memberGet a specific legislator by member ID; errors if the member sits in the other chamber from `chamber`

Get a specific legislator by member ID; errors if the member sits in the other chamber from `chamber`

No parameter schema in public metadata yet.

search_membersSearch 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)

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)

No parameter schema in public metadata yet.

list_committeesList Senate or Assembly committees

List Senate or Assembly committees

No parameter schema in public metadata yet.

get_committeeGet committee details — chair, schedule, location

Get committee details — chair, schedule, location

No parameter schema in public metadata yet.

get_committee_meetingsGet meeting history and bills considered

Get meeting history and bills considered

No parameter schema in public metadata yet.

list_calendarsList Senate floor calendars for a year

List Senate floor calendars for a year

No parameter schema in public metadata yet.

get_calendarGet a specific floor calendar with bill lists

Get a specific floor calendar with bill lists

No parameter schema in public metadata yet.

list_agendasList committee agendas for a year

List committee agendas for a year

No parameter schema in public metadata yet.

get_agendaGet a specific agenda with vote records

Get a specific agenda with vote records

No parameter schema in public metadata yet.

list_floor_transcriptsList Senate floor session transcripts

List Senate floor session transcripts

No parameter schema in public metadata yet.

get_floor_transcriptGet a specific floor session transcript

Get a specific floor session transcript

No parameter schema in public metadata yet.

list_hearing_transcriptsList public hearing transcripts

List public hearing transcripts

No parameter schema in public metadata yet.

get_hearing_transcriptGet a specific hearing transcript

Get a specific hearing transcript

No parameter schema in public metadata yet.

get_updatesAggregate change feed for a date range. `type` selects the timestamp the range filters on (`processed` or `published`); `content_type` restricts to `bills`, `agendas`, `calendars`, or `laws`

Aggregate change feed for a date range. `type` selects the timestamp the range filters on (`processed` or `published`); `content_type` restricts to `bills`, `agendas`, `calendars`, or `laws`

No parameter schema in public metadata yet.

searchFull-text search within one content type — `bills` (default), `laws`, `agendas`, `calendars`, `transcripts`, `hearings`. One type per call; the upstream API has no unified search endpoint. Search resolutions via `type: "bills"`.

Full-text search within one content type — `bills` (default), `laws`, `agendas`, `calendars`, `transcripts`, `hearings`. One type per call; the upstream API has no unified search endpoint. Search resolutions via `type: "bills"`.

No parameter schema in public metadata yet.

Sponsors

Configuration

NYS_LEGISLATION_API_KEYsecret

Free NYS Open Legislation API key, needed for live data. Optional only if a local corpus exists

NYS_CORPUS_DB

Path to the optional local corpus database. Defaults to data/corpus.db in the package

Readme

@betanyc/nys-openlegislation-mcp

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: new tools, corrections and other changes a reader would notice, newest first. Developer detail is in CHANGELOG.md.


What it covers


View the full README on GitHub

Details

Repository
github.com/betanyc/nys-openlegislation-mcp
Package
@betanyc/nys-openlegislation-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from betanyc