Skip to content
MCP server

NY Data Registry

Find which New York data portal covers a place or topic, and how to query it

Runs locally
Install
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-mcp

Add 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 index
  • SOCRATA_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.

How AIPoweredBot checks servers