# NYC Council

NYC Council — an MCP server for Claude Code querying New York City Council legislative records. Pulls bills, hearings, roll-call votes, and committee rosters from a local index or the live Legistar API.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 repo stars
- Author: BetaNYC
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/BetaNYC/nyc-council-mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/nyc-council

## What it does

The server connects an assistant to New York City Council records using two modes. A local SQLite index parsed from the `jehiah/nyc_legislation` repository allows sub-second full-text searches across thousands of bills, resolutions, and roll-call votes. Real-time inquiries hit the official Legistar API directly.

When configured with both data sources, the server exposes 28 tools. They inspect district representatives from 1999 onward, committee assignments, document attachments, and voting history down to individual council members.

Running the server requires Node.js 18 or later. Real-time endpoints demand a free `LEGISTAR_TOKEN`, while offline searches rely on indexing a cloned 920 MB git archive into `legistar.db`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `LEGISTAR_TOKEN`, `LEGISTAR_DB_PATH` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env LEGISTAR_TOKEN=<LEGISTAR_TOKEN> --env LEGISTAR_DB_PATH=<LEGISTAR_DB_PATH> --transport stdio nyc-council -- npx -y @betanyc/nyc-council-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add nyc-council --env LEGISTAR_TOKEN=<LEGISTAR_TOKEN> --env LEGISTAR_DB_PATH=<LEGISTAR_DB_PATH> -- npx -y @betanyc/nyc-council-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nyc-council": {
            "command": "npx",
            "args": [
                "-y",
                "@betanyc/nyc-council-mcp"
            ],
            "env": {
                "LEGISTAR_TOKEN": "<LEGISTAR_TOKEN>",
                "LEGISTAR_DB_PATH": "<LEGISTAR_DB_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "nyc-council": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@betanyc/nyc-council-mcp"
            ],
            "env": {
                "LEGISTAR_TOKEN": "<LEGISTAR_TOKEN>",
                "LEGISTAR_DB_PATH": "<LEGISTAR_DB_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e LEGISTAR_TOKEN=<LEGISTAR_TOKEN> -e LEGISTAR_DB_PATH=<LEGISTAR_DB_PATH> nyc-council npx -y @betanyc/nyc-council-mcp
```
Replace <…> with your own values

## When to use it
- search NYC Council bills and resolutions by full text or law number
- inspect roll-call voting records with dates and member names
- look up council district representatives and committee chairs
- fetch direct download links for legislative attachments

## Example prompts
- Find NYC Council introductions regarding commercial zoning changes
- Who held Council District 3 on March 15, 2021?
- Show the voting breakdown and committee status for matter Int 0450-2024

## Similar
- [NYC Budget](https://affpapa.org/en/nevibecode/mcp/nyc-budget.md) — MCP server · ★ 20 repo stars
- [SubwayInfo NYC](https://affpapa.org/en/nevibecode/mcp/subwayinfo-nyc.md) — MCP server · 16873 installs
- [nyc-property-intel](https://affpapa.org/en/nevibecode/mcp/nyc-property-intel.md) — MCP server · ★ 7 repo stars
- [NYC Charter, Laws and Rules](https://affpapa.org/en/nevibecode/mcp/nyc-charter-laws-and-rules.md) — MCP server · ★ 10 repo stars
- [marketing-council](https://affpapa.org/en/nevibecode/skills/marketing-council.md) — skill · 56900 installs
- [drizzle-orm-patterns](https://affpapa.org/en/nevibecode/skills/drizzle-orm-patterns.md) — skill · 5900 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
