NY Data Registry
Find which New York data portal covers a place or topic, and how to query it
- Pricing
- Free
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.3.0
- Listing updated
- 4 days ago
Similar MCP servers
About NY Data Registry
NY Data Registry is a free MCP server for legal and government. It runs locally on your machine and is started by your AI client.
Where the data lives is the problem this server solves. It knows 140 sources across state, county, city, agency, library and nonprofit portals from BetaNYC's registry, and it hands the agent the correct Socrata domain or ArcGIS service instead of guessing. Actual querying is left to the socrata MCP and BetaNYC's other servers.
There are eleven tools in three groups. Registry tools work out of the box; index tools need a harvested SQLite index, downloaded on first run unless disabled; and two about-this-server tools report changes and credits. search_datasets matches titles, descriptions, tags and column names, returns the true match count, per-portal counts when results don't fit, and writes a CSV of every match to your cache directory.
For places it says whether a county has a portal, was checked and has none, or is simply not in the registry, so an empty answer is not read as absence.
Install
Run in a terminal
claude mcp add ny-data-registry-mcp --env SOCRATA_APP_TOKEN='<SOCRATA_APP_TOKEN>' -- npx -y @betanyc/ny-data-registry-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"ny-data-registry-mcp": {
"command": "npx",
"args": [
"-y",
"@betanyc/ny-data-registry-mcp"
],
"env": {
"SOCRATA_APP_TOKEN": "<SOCRATA_APP_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ny-data-registry-mcp": {
"command": "npx",
"args": [
"-y",
"@betanyc/ny-data-registry-mcp"
],
"env": {
"SOCRATA_APP_TOKEN": "<SOCRATA_APP_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"ny-data-registry-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@betanyc/ny-data-registry-mcp"
],
"env": {
"SOCRATA_APP_TOKEN": "<SOCRATA_APP_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ny-data-registry-mcp": {
"command": "npx",
"args": [
"-y",
"@betanyc/ny-data-registry-mcp"
],
"env": {
"SOCRATA_APP_TOKEN": "<SOCRATA_APP_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ny-data-registry-mcp": {
"command": "npx",
"args": [
"-y",
"@betanyc/ny-data-registry-mcp"
],
"env": {
"SOCRATA_APP_TOKEN": "<SOCRATA_APP_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
NY_DATA_INDEX_AUTO_DOWNLOADSet to 0 to stop the first-run download of the dataset indexSOCRATA_APP_TOKENOptional Socrata app token, used only when building your own index
Tools this server provides (11)
Taken from the project documentation; the running server may differ.
- find_sources
- Finds portals covering a topic or place.
- list_sources_for_place
- Lists everything for one county, city, borough or region.
- how_to_query
- Gives endpoint, API type, key and example request.
- check_source
- Makes a live request to a portal URL.
- registry_info
- Registry and index statistics.
- search_datasets
- Searches dataset titles, descriptions, tags and columns.
- get_dataset_columns
- Fields, types, formats, license and publisher.
- find_joinable
- Datasets sharing a join key.
- whats_new
- Datasets added, changed or removed since a date.
- whats_changed
- What changed in this server.
- about_betanyc
- Who built the server and where to report issues.
What it does
- Portal registry
- Find portals by topic, place, platform, API availability or key requirement.
- Query guidance
- Returns the endpoint verbatim, API type and example request.
- Dataset search
- Search names, tags and column names across Socrata and ArcGIS portals.
- Join finder
- Datasets sharing a key such as BBL, BIN or census tract.
- CSV export
- Writes every match to a CSV file locally.
- Live source check
- Tests a portal URL and compares with the registry.
Good for
- Locate open data for a New York county
- Find datasets with a given column
- Discover what is new on the portals
- Plan joins between city datasets
Pricing
Free
NY Data Registry FAQ
How many sources does it cover?
140 state, county, city, agency, library and nonprofit sources.
Does it query the data itself?
No; it points to the right portal and hands off to the socrata MCP.
Does it need a key?
No; SOCRATA_APP_TOKEN is optional and only for building your own index.
Where do CSV exports go?
In ~/.cache/betanyc/ny-data-registry/exports/ by default.
Is NY Data Registry free?
Yes. NY Data Registry is free to use.
How do I add NY Data Registry to Claude Code?
Run this command in your terminal: claude mcp add ny-data-registry-mcp --env SOCRATA_APP_TOKEN='<SOCRATA_APP_TOKEN>' -- npx -y @betanyc/ny-data-registry-mcp
What are the best alternatives to NY Data Registry?
The closest alternatives to NY Data Registry are NYC 311, Openregistry, SOS.city public record, MORVS and NYC Property Facts.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.