# NYC Budget

NYC Budget — an MCP server for accessing New York City budget data. It provides the agent with 14 tools to query expense funding, capital designations, and agency budgets.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 20 repo stars
- Author: BetaNYC
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/BetaNYC/New-York-City-Budget/tree/HEAD/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-budget

## What it does

The server connects your AI agent to structured financial data from New York City. It processes expense reports, capital plans, and open data sources, allowing for queries across budget lines, agencies, and fiscal years.

A prebuilt SQLite index is included in the package, so no manual database cloning or building is required. To access additional PDF-derived tables, you can enable them by setting the `NYC_BUDGET_PDF_DATA` environment variable.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `NYC_BUDGET_PDF_DATA`, `NYC_BUDGET_PDF_DATA_URL`, `NYC_BUDGET_DATA_DIR` — 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 NYC_BUDGET_PDF_DATA=<NYC_BUDGET_PDF_DATA> --env NYC_BUDGET_PDF_DATA_URL=<NYC_BUDGET_PDF_DATA_URL> --env NYC_BUDGET_DATA_DIR=<NYC_BUDGET_DATA_DIR> --transport stdio mcp -- npx -y @betanyc/nyc-budget-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp --env NYC_BUDGET_PDF_DATA=<NYC_BUDGET_PDF_DATA> --env NYC_BUDGET_PDF_DATA_URL=<NYC_BUDGET_PDF_DATA_URL> --env NYC_BUDGET_DATA_DIR=<NYC_BUDGET_DATA_DIR> -- npx -y @betanyc/nyc-budget-mcp
```
Replace <…> with your own values

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e NYC_BUDGET_PDF_DATA=<NYC_BUDGET_PDF_DATA> -e NYC_BUDGET_PDF_DATA_URL=<NYC_BUDGET_PDF_DATA_URL> -e NYC_BUDGET_DATA_DIR=<NYC_BUDGET_DATA_DIR> mcp npx -y @betanyc/nyc-budget-mcp
```
Replace <…> with your own values

## When to use it
- retrieve NYC capital designation data
- compare adopted and modified agency budgets
- fetch expense information by budget line
- query historical changes in budget data

## Example prompts
- Find capital designations for the project by budget line.
- Compare the adopted agency budget for 2024 against the modified version.
- What has changed in the expense data for the latest reporting period?

## Similar
- [nyc-property-intel](https://affpapa.org/en/nevibecode/mcp/nyc-property-intel.md) — MCP server · ★ 7 repo stars
- [SubwayInfo NYC](https://affpapa.org/en/nevibecode/mcp/subwayinfo-nyc.md) — MCP server · 16873 installs
- [budget-optimizer](https://affpapa.org/en/nevibecode/skills/onewave-ai-budget-optimizer.md) — skill · 454 installs
- [budget-planner](https://affpapa.org/en/nevibecode/skills/budget-planner.md) — skill · ★ 12746 repo stars
- [daily-budget-check](https://affpapa.org/en/nevibecode/skills/daily-budget-check.md) — skill · ★ 1198 repo stars
- [budget-set](https://affpapa.org/en/nevibecode/skills/budget-set.md) — skill · ★ 1198 repo stars

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