プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

NYS Open Legislation

作者:BetaNYCバージョン 2.6.0i★ 5iパソコンで動くリポジトリ ↗
レジストリ名io.github.BetaNYC/nys-openlegislation-mcp

インストール方法

What it does

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

  • Connects パソコンで動く
  • Account or key No key needed
  • Category 法律・行政データ

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気9/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア21/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

NYS Open Legislation をインストールして。https://mcp.popnx.com/i/betanyc-nys-openlegislation-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを 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 がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "nys-openlegislation": {
          "command": "npx",
          "args": [
            "-y",
            "@betanyc/nys-openlegislation-mcp"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    NYS Open Legislation を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が NYS Open Legislation を使っていると言うか、回答に NYS Open Legislation のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • NYS_LEGISLATION_API_KEY 無料の NYS Open Legislation API キー。ライブデータに必要です。ローカルのコーパスが存在する場合のみ任意です。
    英語の原文を見るFree NYS Open Legislation API key, needed for live data. Optional only if a local corpus exists
  • NYS_CORPUS_DB 任意のローカルコーパスデータベースへのパス。デフォルトはパッケージ内の data/corpus.db です。
    英語の原文を見るPath to the optional local corpus database. Defaults to data/corpus.db in the package

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ NYS Open Legislation につなげません

NYS Open Legislation はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · NYS Open Legislation につなげるアプリを使う

  • 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)

B · 法律・行政データ の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを 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 がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user nys-openlegislation -- npx -y @betanyc/nys-openlegislation-mcp
  4. Claude Code で /mcp と入力

    NYS Open Legislation が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    NYS Open Legislation を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が NYS Open Legislation を使っていると言うか、回答に NYS Open Legislation のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • NYS_LEGISLATION_API_KEY 無料の NYS Open Legislation API キー。ライブデータに必要です。ローカルのコーパスが存在する場合のみ任意です。
    英語の原文を見るFree NYS Open Legislation API key, needed for live data. Optional only if a local corpus exists
  • NYS_CORPUS_DB 任意のローカルコーパスデータベースへのパス。デフォルトはパッケージ内の data/corpus.db です。
    英語の原文を見るPath to the optional local corpus database. Defaults to data/corpus.db in the package

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを 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 がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    NYS Open Legislation を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が NYS Open Legislation を使っていると言うか、回答に NYS Open Legislation のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • NYS_LEGISLATION_API_KEY 無料の NYS Open Legislation API キー。ライブデータに必要です。ローカルのコーパスが存在する場合のみ任意です。
    英語の原文を見るFree NYS Open Legislation API key, needed for live data. Optional only if a local corpus exists
  • NYS_CORPUS_DB 任意のローカルコーパスデータベースへのパス。デフォルトはパッケージ内の data/corpus.db です。
    英語の原文を見るPath to the optional local corpus database. Defaults to data/corpus.db in the package

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを 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 がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    NYS Open Legislation を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が NYS Open Legislation を使っていると言うか、回答に NYS Open Legislation のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • NYS_LEGISLATION_API_KEY 無料の NYS Open Legislation API キー。ライブデータに必要です。ローカルのコーパスが存在する場合のみ任意です。
    英語の原文を見るFree NYS Open Legislation API key, needed for live data. Optional only if a local corpus exists
  • NYS_CORPUS_DB 任意のローカルコーパスデータベースへのパス。デフォルトはパッケージ内の data/corpus.db です。
    英語の原文を見るPath to the optional local corpus database. Defaults to data/corpus.db in the package

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?NYS Open Legislation を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user nys-openlegislation -- npx -y @betanyc/nys-openlegislation-mcp

Claude 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 秘密 env
    無料の NYS Open Legislation API キー。ライブデータに必要です。ローカルのコーパスが存在する場合のみ任意です。
    英語の原文を見るFree NYS Open Legislation API key, needed for live data. Optional only if a local corpus exists
  • NYS_CORPUS_DB env
    任意のローカルコーパスデータベースへのパス。デフォルトはパッケージ内の data/corpus.db です。
    英語の原文を見るPath to the optional local corpus database. Defaults to data/corpus.db in the package

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
46/週
接続方法
パソコンで動く
最新バージョンi
2.6.0
レジストリ公開日i
2026年11月14日
コードの最終更新i
2026年11月19日
作者
BetaNYC
パッケージ
npm: @betanyc/nys-openlegislation-mcp
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント BetaNYC で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:今日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に @betanyc/nys-openlegislation-mcp@2.6.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/betanyc-nys-openlegislation-mcp.svg)](https://mcp.popnx.com/en/servers/betanyc-nys-openlegislation-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

法律・行政データのほかのサーバーとの比較i

  • このカテゴリのほかの1951件のうち96%よりスターが多い
  • このカテゴリのほかの1951件のうち88%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1951件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

NYS Open Legislationは安全ですか?

当てはまる基本チェック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スターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Global law

The law of nearly every country on earth, any date: read it, see what changed it, check citations.

作者:lexifina広く使われている★ 21059 日前更新

クラウドで動く✓ lexifina.com

LibreJustice

Search French-language and European case law and French legal texts (codes, statutes, treaties).

作者:librejustice初期★ 362 か月前更新

クラウドで動く✓ 提供元 · librejustice.fr

InfraNode

Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.

作者:street1983nk初期★ 185 か月前更新

クラウドで動く✓ 提供元 · infranode.dev
似たものと比べる
これ
NYS Open Legislation
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/44/44/44/44/4
ライセンスMITNOASSERTIONMITApache-2.0Apache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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


What it covers

ResourceTools
BillsSearch, get by print number, list by session, get votes, track updates
LawsList all law bodies, browse law trees, retrieve section text
MembersList and search Senate and Assembly members
CommitteesList committees, get details and meeting history
Floor CalendarsList and get Senate floor calendars
AgendasList and get committee agendas with vote records
TranscriptsFloor session and public hearing transcripts
UpdatesAggregate change feed across all content types
SearchFull-text ElasticSearch within a content type (bills, laws, agendas, calendars, transcripts, hearings)
About this serverWhat changed in it, who built it, and where its data comes from

API key

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:

  1. Register at [legislation.nysenate.gov/public](https://legislation.nysenate.gov/public)
  2. You'll receive an API key by email
  3. Set it as 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 Installation

Without 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.


Installation

Requires Node.js 20 or newer.

Use with Claude Desktop (recommended)

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.

Global install
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" } } } }


Local corpus (optional)

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.

Requirements

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.

1. Fetch the initial corpus
NYS_LEGISLATION_API_KEY=your-key node scripts/fetch-data.js

Options:

FlagDefaultDescription
--start-year=YYYY2009Earliest session year to fetch
--types=bills,laws,...all typesComma-separated list: bills,laws,members,committees,agendas,calendars,transcripts
--include-law-textoffFetch full text of every law section (large — adds significant download time)
--include-transcript-textoffFetch full text of floor and hearing transcripts (very large)
--delay-ms=N150Delay between API calls in ms
--dry-runoffPrint 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.

2. Run incremental sync (nightly)
NYS_LEGISLATION_API_KEY=your-key node scripts/sync.js

Options:

FlagDefaultDescription
--from=YYYY-MM-DDTHH:MM:SSlast sync timeOverride the start, in New York local time (the API's own convention)
--delay-ms=N150Delay between API calls in ms
--dry-runoffPrint 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
How local-first works

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.

Known limitations
  • Committees go stale between full fetches. The incremental sync consumes the aggregate updates feed, which only carries 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.
  • Law and transcript text are not incrementally synced; re-run fetch-data.js for those periodically.
  • Member full names come from bill sponsor records already in the corpus, filled in by 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.
  • Local results carry no `total`. Paginated results served from the local corpus return items and size only; the total, offsetStart, offsetEnd and limit fields come from the live API.

Tools

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.

Bills
ToolDescription
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)
get_billGet a specific bill by print number (e.g. S1234) and session year
list_billsList bills introduced in a session year
get_bill_votesGet committee and floor vote records for a bill (the votes block of the bill record)
get_bill_updatesFeed of bill changes within a date range
Laws
ToolDescription
list_lawsList all NYS law bodies (Education Law, Labor Law, etc.)
get_law_treeGet table of contents for a law body
get_law_sectionGet 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.

Members
ToolDescription
list_membersList Senate or Assembly members for a session year
get_memberGet a specific legislator by member ID; errors if the member sits in the other chamber from chamber
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)
Committees
ToolDescription
list_committeesList Senate or Assembly committees
get_committeeGet committee details — chair, schedule, location
get_committee_meetingsGet meeting history and bills considered
Calendars & Agendas
ToolDescription
list_calendarsList Senate floor calendars for a year
get_calendarGet a specific floor calendar with bill lists
list_agendasList committee agendas for a year
get_agendaGet a specific agenda with vote records
Transcripts
ToolDescription
list_floor_transcriptsList Senate floor session transcripts
get_floor_transcriptGet a specific floor session transcript
list_hearing_transcriptsList public hearing transcripts

| get_hearing_transcript | Get a specif

冒頭だけを表示しています。続きはリポジトリで読めます