# NYC City Finance (OMB) AI Agent Connect

> NYC City Finance (OMB) MCP gives your AI client direct access to New York City Office of the Mayor's Budget records. You can query expense budget lines by fiscal year, rank agencies by their adopted budgets, pull capital commitment plans, and check citywide energy cost projections through a single connection. No API keys or manual data scraping required.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_h2ycBpxWdRE4lXUjV0f2qYWZTsTLSAI4ooKiKwc6/ai-agent-connect
- **Tags:** new-york, nyc, budget, omb, expense, capital, energy, finance

## Description

You can now query New York City's financial records using natural language. This MCP connects your AI client to the Office of the Mayor's Budget (OMB) data, allowing you to bypass manual searches on city portals. Whether you are analyzing agency spending or projecting future energy costs, your agent can pull specific budget lines, appropriation details, and capital project funding directly into your conversation. 

For fiscal year data, the tool covers 2024 through 2027, with 2026 acting as the default. You can filter expense budgets by agency, appropriation, or object class using case-insensitive matches. If you need to look at long-term infrastructure, the capital budget and commitment plan tools provide project-level details, including funding sources and yearly amounts. For energy planning, the tool provides commodity-specific projections from 2020 through 2030. Vinkius hosts this MCP, so you just connect your client and start asking questions about NYC's money.

## Tools

### count_expense_budget_lines
This tool counts the number of expense budget lines for a specific fiscal year. Use it to estimate the size of a budget dataset before running a larger search.

### get_energy_cost_projections
This tool retrieves citywide energy cost projections for commodities like Gasoline, Fuel Oil, or Heat, Light & Power. It covers fiscal years 2020 through 2030.

### search_capital_budget
This tool searches the NYC OMB capital budget for specific projects. You can filter by project type, funding, or budget-line title using exact matches.

### search_capital_commitment
This tool queries the NYC OMB capital commitment plan. It allows you to find project details and yearly funding amounts using free-text filters.

### search_expense_budget
This tool searches the NYC OMB expense budget for specific agency or appropriation details. Results are sorted by the largest adopted budget amounts first.

### top_agency_budgets
This tool identifies the NYC agencies with the largest adopted expense budgets for a given fiscal year.

## Prompt Examples

**Prompt:** 
```
Which NYC agencies have the largest expense budget in FY 2026?
```

**Response:** 
```
top_agency_budgets with fiscal_year: "2026" returns the agencies ranked by their summed adopted budget amount for the fiscal year.
```

**Prompt:** 
```
Show me the education agency's expense budget lines for FY 2026.
```

**Response:** 
```
search_expense_budget with agency_name: "Education" and fiscal_year: "2026" returns the matching budget lines sorted by the adopted amount, largest first.
```

**Prompt:** 
```
What is the projected gasoline cost for FY 2030?
```

**Response:** 
```
get_energy_cost_projections with typ: "Gasoline" and fisc_yr: "2030" returns the citywide projected cost for that commodity and fiscal year.
```

## Capabilities

### Budget Line Retrieval
Your agent pulls specific appropriation and object class details from the expense budget.

### Agency Ranking
The AI identifies which city agencies hold the highest budget allocations.

### Capital Project Auditing
Your agent searches for specific infrastructure projects and their funding sources.

### Energy Forecasting
The AI accesses decade-long projections for citywide energy commodity costs.

### Data Volume Estimation
Your agent checks the number of budget lines to manage the scope of a query.

## Use Cases

### Agency Spending Analysis
Compare the adopted budget of the Department of Education against other major agencies for a specific fiscal year.

### Infrastructure Planning
Search the capital commitment plan to find how much funding is allocated to specific project types over a five-year period.

### Energy Budgeting
Retrieve projected costs for Gasoline or Fuel Oil to assist in municipal energy expenditure forecasting.

### Budget Volume Checks
Use the line count tool to see how many budget entries exist for a year before performing a deep search.

## Benefits

- Eliminates the need for manual API key management or complex web scraping.
- Provides direct access to OMB expense and capital budget records.
- Supports case-insensitive filtering for agency and appropriation names.
- Delivers sorted budget data, placing the largest expenditures at the top of the list.

## How It Works

Connecting to this MCP is a one-time setup that gives your AI client immediate access to NYC financial tools.

1. Subscribe to the NYC City Finance (OMB) MCP on Vinkius.
2. Connect your preferred client like Claude, Cursor, or Windsurf with one click.
3. Ask your AI agent a question about NYC budgets or energy costs.
4. The agent invokes the specific tool needed to fetch the data.
5. The data is returned directly to your chat interface for analysis.

## Frequently Asked Questions

**Do I need an API key to use this NYC budget data?**
No. This MCP provides keyless access to the NYC OMB records through the Vinkius platform.

**Which fiscal years are available for the expense budget?**
The expense budget data is published for fiscal years 2024 through 2027.

**How does the tool handle agency name searches?**
The tool uses case-insensitive partial matches for agency, appropriation, and object-class names.

**Can I see future energy cost projections?**
Yes. You can access citywide energy cost projections for various commodities through the year 2030.

**What happens if I don't specify a fiscal year?**
Most budget tools, including the expense budget and agency ranking tools, default to fiscal year 2026 if you omit it.

**Do I need an API key?**
No. NYC Open Data serves all public datasets anonymously over its SODA API (data.cityofnewyork.us). This MCP defines no credentials and needs nothing configured.

**Which fiscal years are published?**
The OMB expense budget publishes fiscal years 2024–2027; the tools default to FY 2026 when the fiscal year is omitted. The energy cost projections table runs fiscal years 2020–2030.

**Why do the budget tools pin a fiscal year?**
The expense budget holds several fiscal years in one table. Every search, count and ranking is scoped to one fiscal year — fiscal_year defaults to "2026" when omitted — so the query stays bounded and fast.