Nyc Checkbook Mcp

NYC Checkbook data: city spending, contracts, budget, payroll, and revenue from Checkbook NYC

LLM Mart 0 views 90 listing impressions

Bringing New York City's checkbook to AI assistants everywhere.

An MCP (Model Context Protocol) server for NYC Checkbook data — spending, contracts, budget, payroll, and revenue — powered by the Checkbook NYC public API.

Checkbook NYC is the NYC Comptroller's financial transparency platform. It tracks $129B+ in annual city spending across 52,000+ vendors and 188,000+ contracts.

Vibe coded with Claude by BetaNYC.

What's changed: new tools, changes to what the tools return, and corrections, newest first.

Where the data comes from: each kind of data, its publisher, how current it is, its terms, and where to report an error. Also published as a DCAT-US 3.0 catalog, data.json.

Contents


Getting started

To use this server you will need:

  • Node 18 or later
  • An MCP client, such as Claude Desktop or Claude Code

No API key is required. Checkbook NYC is a public API, so this server works out of the box — no signup, no token, no environment variables to set.

Note that the API is rate-limited to one request per second. This server enforces that internally, so you do not need to manage it yourself. See API notes and limits.


What it does

Exposes 13 tools over MCP. One of them, smart_search, is off unless the server is started with the environment variable CHECKBOOK_ENABLE_SMART_SEARCH set to 1 or true. While it is off, it sends nothing and answers that it is disabled, pointing to the structured tools.

Tool Description
search_contracts Structured contract search with filters (agency, vendor, status, amount, dates, MWBE)
get_contract Look up a single contract by ID
search_spending Search spending (check) records by agency, payee, contract, date, amount
search_budget Search budget data by agency, department, fiscal year
search_payroll Search payroll records by agency, title, pay frequency, pay date, amount range (no employee names)
search_revenue Search revenue data by agency and fiscal year
get_agency_spending All spending for a specific agency in a fiscal year
search_nycedc_contracts NYCEDC / Other Government Entities (OGE) contracts — separate from citywide
search_nycha_contracts NYCHA (Housing Authority) contracts at release/line-item granularity
smart_search Off by default (see above and the note under Tools reference). When switched on, it reads the checkbooknyc.com search page, which usually answers that it is unavailable
whats_changed What changed in this server, newest first, from WHATS-CHANGED.md (filter by date or tag)
about_betanyc Who built this server, where to report a bug in this server or ask for a new feature, and BetaNYC's links
about_data Where each kind of data comes from, from DATA-SOURCES.json: the publisher, whether it is an official record, how current it is, terms and credit line, where to check a figure and where to report an error (filter by topic or tool name)

From the project's README.