Motley

MCP Server

Put NYC family data inside your assistant.

Motley speaks the Model Context Protocol — the open standard for connecting assistants to live data. Point a compatible client at our server and ask, in plain language, which NYC neighborhoods and schools fit your family.

What it is

The same dataset, as tools.

MCP is an open protocol that lets an assistant (Claude Desktop, and a growing set of other clients) call external tools mid- conversation. Our server exposes the data behind every Motley page — the 262 neighborhoods (197 of them residential), 2,900+ K-12 schools, safety and health indicators, and family resources — as a small set of typed tools the assistant can query directly.

Every tool reads the same sources described on Our Data — public records, plus licensed listings for places. No scraping our pages, no guessing — structured answers, straight from the source.

Every answer comes back typed — structured data alongside the text, so an assistant parses it directly. Beyond the tools, we publish browseable resources (a catalog of all 262 neighborhoods, 197 of them residential, and the full NYC admissions reference) and ready-to-run prompts for common family questions, with auto-completion as you type a neighborhood code or admission method.

Clients that render MCP Apps show rankings, neighborhood searches, places and school lookups as result cards; others get the same text and structured data.

The tools

Twenty-one ways to ask.

  • search-neighborhoodsSearch NYC neighborhoods by borough, by name (typos and nicknames like "Bed-Stuy" included), or by what a family wants nearby ("near the water"). Returns NTA codes, names, boroughs, and centroids, each match with what it matched on.
  • get-neighborhoodFull profile for one neighborhood — demographics, raw scores, location, plus a family-readable interpretation (labeled score bands + cached blurbs).
  • get-neighborhood-summaryDecision-ready summary of one neighborhood — a one-paragraph fit verdict, labeled score bands, cached blurbs, and weekday-morning commute times to the main job centers, with raw scores still available.
  • get-schoolsSchools within a neighborhood — public, charter, and private — with quality ratings and grade levels.
  • browse-schoolsFind schools citywide by what a family wants — borough, school district, grade band, school type, admissions method, program focus (arts, STEM, language, sports), or the family's own words ("Spanish dual language", "Montessori") — each with its Motley rating, and for words, what it matched on.
  • find-schoolLook up a school by name — its official name, a common short form like "Brooklyn Tech", a misspelling ("Stuyvesent"), or its DBN — and get the matching schools with their district, neighborhood, admission method, and Motley rating.
  • get-zoned-schoolThe zoned elementary school for an NYC address — a street address in, the zoned K-5 school and its neighborhood out.
  • get-resourcesFamily resource counts — playgrounds, libraries, hospitals, recreation centers, farmers markets, ADA subway stations.
  • get-activitiesKids' activities and businesses — classes, sports, arts, tutoring.
  • get-safetySafety and health indicators — crime, collisions, housing violations, air quality, lead, asthma.
  • get-comparableNeighborhoods most similar to a given one, by a 9-dimension score vector.
  • find-neighborhoodWhich neighborhood an address or coordinate is in — pass a NYC address or lat/lng and get the neighborhood plus a family-fit summary.
  • rank-neighborhoodsRank neighborhoods by what your family cares about — safety, schools, affordability, playgrounds near home, and more, optionally within one borough — the same ranking as Best fit on our Neighborhoods page. Or sort by one score alone, like the safest in Queens or Brooklyn by things to do.
  • compare-neighborhoodsCompare two to six neighborhoods side by side across the nine family-fit metrics, with the leader called out on each, plus commute times from each.
  • explain-scoreHow one of our scores, or the school rating, is computed — its inputs and weights, its limits, its sources, and how it moves with neighborhood income.
  • find-collectionsLists of schools or neighborhoods picked by a stated rule — like zoned schools that beat their district while serving high-need students — citywide or in one borough.
  • find-placesThe places inside one neighborhood — a library, playgrounds, subway stations, coffee, a pediatrician, its public schools — found by name, street or kind, grouped by category.
  • get-admissions-methodsEvery NYC admission entry point — 3-K and Pre-K, Kindergarten, Gifted & Talented, and the 8 middle/high methods — each with its typical application window.
  • explain-admissions-methodOne NYC admission entry point or method in full — the plain-English explainer, its typical deadline window, and what the method actually asks of a family: an audition or portfolio, SHSAT registration, an open-house sign-in, a private school's own test and interview.
  • get-admissions-demandHow one school admits students — its admission method in full, its programs with seats and who may apply, and, where the city publishes them, seats vs. applicants with a competitiveness band.
  • get-admissions-timelineWhat's coming for a child, by grade — every NYC school application in the next two years, with the city's published dates where it has announced them.

Connect it

We host it. Point your client at one URL.

No install, no database, no key — point any MCP-compatible client at our hosted endpoint:

https://mcp.motley.nyc/mcp

Most clients take it from there. In ones with native remote-MCP support, open Settings → Connectors, add a custom connector, and paste that URL — the twenty-one tools appear, no restart required.

In ChatGPT

Motley NYC is in ChatGPT’s plugin directory. Open Motley NYC in ChatGPT and add it, then type @ in a new chat and pick it.

Or add it by URL as a custom MCP server, if your account or workspace allows them:

  1. Open ChatGPT Plugins, select the plus button, then Add custom MCP server.
  2. Name it Motley NYC, enter https://mcp.motley.nyc/mcp as the server URL, and set authentication to No authentication.
  3. Confirm the risk warning, select Create as a plugin, and install it.
  4. In a new chat, type @ and pick Motley NYC.

On a client that only loads servers over stdio through a config file, bridge to the same URL with mcp-remote instead. For Claude Desktop, add this to your claude_desktop_config.json and restart:

{
  "mcpServers": {
    "motley": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.motley.nyc/mcp"]
    }
  }
}

Either way, ask something like “Compare Park Slope and Carroll Gardens for a family with young kids” — the assistant pulls the answer through the tools.

We also publish to the open MCP directories — the official MCP registry , Smithery, PulseMCP and Glama — so clients that browse those catalogs can add Motley with one click.

Advanced · run it yourself

Prefer to run the server on your own machine? It speaks stdio too. You'll need Node.js 22+ and your own DATABASE_URL for the data. Build it once:

cd mcp-server
npm install
npm install --prefix widgets   # the result cards' build tools
npm run build      # builds the cards, then bundles to dist/index.js

Then point your client at the built file instead of the hosted URL:

{
  "mcpServers": {
    "motley": {
      "command": "node",
      "args": ["/path/to/motley/mcp-server/dist/index.js"],
      "env": {
        "DATABASE_URL": "<your-connection-string>"
      }
    }
  }
}

For providers

Run a tutoring or family service for NYC families? You can manage your Motley listing — draft it, verify, subscribe — from your own AI assistant too, over a private endpoint scoped to your account.

Open data, open protocol.

Prefer to explore it yourself? Everything the tools return is on the site — start with the neighborhoods, or see exactly where the numbers come from.