# NY Data Registry

> NY Data Registry is a free MCP server for legal and government. Find which New York data portal covers a place or topic, and how to query it. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/betanyc/ny-data-registry-mcp
- **MCP Registry name:** io.github.BetaNYC/ny-data-registry-mcp
- **Categories:** [legal and government](https://ai-powered.com/categories/legal-and-government), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add ny-data-registry-mcp --env SOCRATA_APP_TOKEN='<SOCRATA_APP_TOKEN>' -- npx -y @betanyc/ny-data-registry-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ny-data-registry-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@betanyc/ny-data-registry-mcp"
      ],
      "env": {
        "SOCRATA_APP_TOKEN": "<SOCRATA_APP_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ny-data-registry-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@betanyc/ny-data-registry-mcp"
      ],
      "env": {
        "SOCRATA_APP_TOKEN": "<SOCRATA_APP_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ny-data-registry-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@betanyc/ny-data-registry-mcp"
      ],
      "env": {
        "SOCRATA_APP_TOKEN": "<SOCRATA_APP_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ny-data-registry-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@betanyc/ny-data-registry-mcp"
      ],
      "env": {
        "SOCRATA_APP_TOKEN": "<SOCRATA_APP_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ny-data-registry-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@betanyc/ny-data-registry-mcp"
      ],
      "env": {
        "SOCRATA_APP_TOKEN": "<SOCRATA_APP_TOKEN>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [NYC 311](https://ai-powered.com/mcp/nyc-311): NYC 311 is an open-source MCP server for legal and government.
- [Openregistry](https://ai-powered.com/mcp/openregistry): Openregistry is a freemium MCP server for legal and government.
- [SOS.city public record](https://ai-powered.com/mcp/sos-city-public-record): SOS.city public record is a freemium MCP server for legal and government.
- [MORVS](https://ai-powered.com/mcp/morvs): MORVS is a free MCP server for legal and government.
- [NYC Property Facts](https://ai-powered.com/mcp/nyc-property-facts): NYC Property Facts is a free MCP server for analytics and data.
- [NYS Open Legislation](https://ai-powered.com/mcp/nys-open-legislation): NYS Open Legislation is a free MCP server for legal and government.
- [OpenSOSData – US Business Entity Search](https://ai-powered.com/mcp/opensosdata-us-business-entity-search): OpenSOSData – US Business Entity Search is a freemium MCP server for legal and government.
- [publicdata.au](https://ai-powered.com/mcp/publicdata-au): publicdata.au is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/ny-data-registry
