
NY State bills, laws, members, committees, calendars and transcripts from NYS Open Legislation
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 yearGet 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 yearList 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 rangeFeed 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 bodyGet table of contents for a law body
No parameter schema in public metadata yet.
get_law_sectionGet text of a specific law sectionGet text of a specific law section
No parameter schema in public metadata yet.
list_membersList Senate or Assembly members for a session yearList 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 committeesList Senate or Assembly committees
No parameter schema in public metadata yet.
get_committeeGet committee details — chair, schedule, locationGet committee details — chair, schedule, location
No parameter schema in public metadata yet.
get_committee_meetingsGet meeting history and bills consideredGet meeting history and bills considered
No parameter schema in public metadata yet.
list_calendarsList Senate floor calendars for a yearList Senate floor calendars for a year
No parameter schema in public metadata yet.
get_calendarGet a specific floor calendar with bill listsGet a specific floor calendar with bill lists
No parameter schema in public metadata yet.
list_agendasList committee agendas for a yearList committee agendas for a year
No parameter schema in public metadata yet.
get_agendaGet a specific agenda with vote recordsGet a specific agenda with vote records
No parameter schema in public metadata yet.
list_floor_transcriptsList Senate floor session transcriptsList Senate floor session transcripts
No parameter schema in public metadata yet.
get_floor_transcriptGet a specific floor session transcriptGet a specific floor session transcript
No parameter schema in public metadata yet.
list_hearing_transcriptsList public hearing transcriptsList public hearing transcripts
No parameter schema in public metadata yet.
get_hearing_transcriptGet a specific hearing transcriptGet 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
NYS_LEGISLATION_API_KEYsecretFree 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
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.
@betanyc/nys-openlegislation-mcp