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
목록은 사용 점수(100점 만점)로 정렬되며 구성은 다음과 같습니다
| 인기 | 9/80 | GitHub 별 또는 주간 다운로드: 큰 쪽 60, 작은 쪽 20 |
|---|---|---|
| 최신성 | 12/12 | 30일 안에 릴리스나 코드 변경이 있으면 만점 |
| 응답 중 | 0/8 | 마지막 점검 때 클라우드 엔드포인트가 응답 |
| 사용 점수 | 21/100 |
품질: 기본 점검 3/3개 통과(표시만, 정렬에는 안 씀) · 상승세: 데이터 없음 (급상승 탭에서만 사용)
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
한 문장으로 AI에게 설치 맡기기
NYS Open Legislation 설치해 줘. https://mcp.popnx.com/i/betanyc-nys-openlegislation-mcp.md 를 따라 하고, 명령을 먼저 보여 주고 내가 승인하면 실행해.내 컴퓨터에서 작업하는 AI(Claude Code, Cursor 등)에 붙여 넣으세요. 단계를 읽고 명령을 보여 준 뒤 승인을 기다립니다. 키도 가입도 필요 없습니다. · AI가 읽을 전체 내용 보기
검사 3/3 통과 · 내 컴퓨터에서 실행돼요 · ✓ 명령 확인 2026년 11월 14일
먼저: 어떤 AI를 쓰시나요?
쓰는 앱을 고르면 아래에 단계가 나옵니다.
Claude에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만) · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요
이 메시지를 Claude 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Claude에 MCP server NYS Open Legislation을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "mcpServers": { "nys-openlegislation": { "command": "npx", "args": [ "-y", "@betanyc/nys-openlegislation-mcp" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 NYS Open Legislation의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -vMac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v
한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
SettingsDeveloperEdit Config
{
"mcpServers": {
"nys-openlegislation": {
"command": "npx",
"args": [
"-y",
"@betanyc/nys-openlegislation-mcp"
]
}
}
}NYS Open Legislation을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude가 NYS Open Legislation을 쓰고 있다고 하거나 답에 NYS Open Legislation 도구 이름이 나오면 연결된 거예요
위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.
NYS_LEGISLATION_API_KEY 무료 NYS Open Legislation API 키로, 실시간 데이터에 필요합니다. 로컬 코퍼스가 있는 경우에만 선택 사항입니다. NYS_CORPUS_DB 선택적 로컬 코퍼스 데이터베이스 경로. 기본값은 패키지 내의 data/corpus.db입니다. 설명은 자동 번역이며 변수 이름은 원문 그대로입니다. 확실하지 않으면 원문을 확인하세요.
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
ChatGPT는 아직 NYS Open Legislation에 연결할 수 없어요
NYS Open Legislation는 내 컴퓨터에 설치해서 쓰지만 ChatGPT는 웹에서 도는 서버만 연결할 수 있어요
A · NYS Open Legislation에 연결되는 앱 쓰기
B · 법률 및 정부 데이터에서 ChatGPT에 연결되는 다른 서버
같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요
Claude Code에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
이 메시지를 Claude Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Claude Code에 MCP server NYS Open Legislation을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): claude mcp add --scope user nys-openlegislation -- npx -y @betanyc/nys-openlegislation-mcp 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 NYS Open Legislation의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -vMac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v
한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
Mac: Command+스페이스를 누르고 Terminal 입력 · Windows: PowerShell 열기
claude mcp add --scope user nys-openlegislation -- npx -y @betanyc/nys-openlegislation-mcpNYS Open Legislation이 목록에 있고 연결됨으로 보이면 돼요
NYS Open Legislation을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude Code가 NYS Open Legislation을 쓰고 있다고 하거나 답에 NYS Open Legislation 도구 이름이 나오면 연결된 거예요
위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.
NYS_LEGISLATION_API_KEY 무료 NYS Open Legislation API 키로, 실시간 데이터에 필요합니다. 로컬 코퍼스가 있는 경우에만 선택 사항입니다. NYS_CORPUS_DB 선택적 로컬 코퍼스 데이터베이스 경로. 기본값은 패키지 내의 data/corpus.db입니다. 설명은 자동 번역이며 변수 이름은 원문 그대로입니다. 확실하지 않으면 원문을 확인하세요.
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Cursor에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
이 메시지를 Cursor 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Cursor에 MCP server NYS Open Legislation을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "mcpServers": { "nys-openlegislation": { "command": "npx", "args": [ "-y", "@betanyc/nys-openlegislation-mcp" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 NYS Open Legislation의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -vMac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v
한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
NYS Open Legislation을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Cursor가 NYS Open Legislation을 쓰고 있다고 하거나 답에 NYS Open Legislation 도구 이름이 나오면 연결된 거예요
위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.
NYS_LEGISLATION_API_KEY 무료 NYS Open Legislation API 키로, 실시간 데이터에 필요합니다. 로컬 코퍼스가 있는 경우에만 선택 사항입니다. NYS_CORPUS_DB 선택적 로컬 코퍼스 데이터베이스 경로. 기본값은 패키지 내의 data/corpus.db입니다. 설명은 자동 번역이며 변수 이름은 원문 그대로입니다. 확실하지 않으면 원문을 확인하세요.
메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
VS Code에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
이 메시지를 VS Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 VS Code에 MCP server NYS Open Legislation을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "servers": { "nys-openlegislation": { "type": "stdio", "command": "npx", "args": [ "-y", "@betanyc/nys-openlegislation-mcp" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 NYS Open Legislation의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -vMac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v
한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
NYS Open Legislation을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ VS Code가 NYS Open Legislation을 쓰고 있다고 하거나 답에 NYS Open Legislation 도구 이름이 나오면 연결된 거예요
위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.
NYS_LEGISLATION_API_KEY 무료 NYS Open Legislation API 키로, 실시간 데이터에 필요합니다. 로컬 코퍼스가 있는 경우에만 선택 사항입니다. NYS_CORPUS_DB 선택적 로컬 코퍼스 데이터베이스 경로. 기본값은 패키지 내의 data/corpus.db입니다. 설명은 자동 번역이며 변수 이름은 원문 그대로입니다. 확실하지 않으면 원문을 확인하세요.
메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
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 비밀 envNYS_CORPUS_DB env설명은 자동 번역이며 변수 이름은 원문 그대로입니다. 확실하지 않으면 원문을 확인하세요.
이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.
내 컴퓨터에서 실행하는 앱
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 19일 점검
레지스트리 이름이 GitHub 계정 BetaNYC 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
코드 마지막 변경: 오늘
MIT 사용
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요
OSV.dev에 @betanyc/nys-openlegislation-mcp@2.6.0 항목이 없습니다
이 버전의 패키지 자체만 확인하며 모든 의존성은 아닙니다 · 확인 2026년 11월 15일
제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.
[](https://mcp.popnx.com/en/servers/betanyc-nys-openlegislation-mcp)질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.
아직 리뷰가 없어요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).
GitHub 저장소는 마지막으로 오늘 변경됐고, 최신 버전(2.6.0)은 5일 전 레지스트리에 올라왔어요.
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Node.js도 있어야 해요.
같은 카테고리에는: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector
같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.
카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
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.
| 이 항목 NYS Open Legislation | Global law | Open Legal Data (Germany) | LibreJustice | InfraNode | Fedlex Connector | |
|---|---|---|---|---|---|---|
| 실행 위치 | 컴퓨터에 설치 필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 |
| 키 필요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 |
| Claude에서 +로 추가 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 |
| 기본 점검 | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| 라이선스 | MIT | NOASSERTION | MIT | Apache-2.0 | Apache-2.0 | MIT |
| 가격 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 |
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
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