Nyc Checkbook Mcp
NYC Checkbook data: city spending, contracts, budget, payroll, and revenue from Checkbook NYC
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
- What it does
- Tools reference
- Example queries
- Common agency codes
- Installation
- Claude Desktop configuration
- API notes and limits
- Getting help and the upstream project
- Contributing
- Development
- About BetaNYC
- Related BetaNYC MCP servers
- Releases
- Acknowledgments
- License
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.