.codex-plugin/plugin.json

{
  "name": "motley-nyc",
  "version": "1.2.0",
  "description": "Find the right New York City school and the neighborhood around it: neighborhood fit, safety and family resources, the zoned school for an address, school search, and how NYC school admissions works.",
  "author": {
    "name": "Hypno Labs",
    "email": "hello@motley.nyc",
    "url": "https://motley.nyc"
  },
  "homepage": "https://motley.nyc/mcp",
  "repository": "https://github.com/HypnoLabs-io/motley-mcp",
  "keywords": [
    "nyc",
    "new-york-city",
    "schools",
    "neighborhoods",
    "school-admissions",
    "families",
    "education"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Motley NYC",
    "shortDescription": "NYC schools + neighborhoods",
    "longDescription": "Find the right New York City school, and the neighborhood around it. Motley NYC answers families' questions from Motley's data on all 262 NYC neighborhoods and on public, charter and private K-12 schools across the five boroughs.\n\nWhat you can ask:\n- Which neighborhoods fit what matters to your family, ranked by your priorities (playgrounds near home can count too) or compared side by side\n- How each neighborhood score is computed, and lists of neighborhoods and schools picked by a stated rule\n- A plain-language fit summary for any neighborhood, with safety and health indicators, playgrounds, libraries, accessible subway stations and kids' activities nearby\n- Which elementary school is zoned for an address\n- Schools by borough, district, grade level, type, admission method or program focus, or a specific school by name\n- How NYC admissions works from 3-K through high school (zoned, screened, audition, SHSAT, lotteries and more) and what each method asks of a family\n- How a specific school admits students: its method, programs, seats, and applicant counts where NYC publishes them\n- Which applications are coming for each child's grade, and when\n\nWhat to know:\n- New York City only.\n- No account or sign-in. Every tool only reads; nothing is saved or changed.\n- To find a zoned school or place an address, the address you type is sent to NYC Planning's GeoSearch to locate it.\n- At elementary level, in-zone students get a guaranteed seat. Some areas, like all of District 1, have no zoned school.\n- We never estimate a family's odds of admission. Seats and applicant counts come from NYC MySchools; the competitiveness band beside them is Motley's own reading, not a DOE rating. Most middle schools, and all charter and private schools, have no published applicant counts.\n- Neighborhood scores carry the date they were computed. Admission dates are the city's published dates where it has announced them; otherwise we give the usual window and say so.\n- Answers link to each neighborhood's and school's page on motley.nyc.",
    "developerName": "Hypno Labs",
    "category": "Education & Research",
    "capabilities": [
      "Read"
    ],
    "websiteURL": "https://motley.nyc",
    "supportURL": "https://motley.nyc/help/contact",
    "privacyPolicyURL": "https://motley.nyc/privacy",
    "termsOfServiceURL": "https://motley.nyc/terms",
    "defaultPrompt": [
      "Which Brooklyn neighborhoods fit a family with a toddler who wants parks, safety and good schools?",
      "How does screened admission work for NYC middle schools?",
      "Compare Jackson Heights and Sunnyside for a family with a toddler."
    ],
    "brandColor": "#B07A7E",
    "composerIcon": "./assets/composer-icon.svg",
    "logo": "./assets/logo.svg"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Brooklyn family fit: rank neighborhoods by a family's priorities, then summarize the best fit.",
              "prompt": "We have a toddler and want to stay in Brooklyn. Which neighborhoods would fit us best for parks, safety and good schools?",
              "tools_triggered": "rank-neighborhoods, get-neighborhood-summary",
              "expected_behavior": "Ranks Brooklyn neighborhoods by the priorities the family stated (parks, safety, schools), then summarizes the top fit in plain language with its labeled score bands, the date the scores were computed and a link to its motley.nyc page. Names specific neighborhoods rather than answering at borough level."
            },
            {
              "description": "Zoned school: find the zoned elementary school for an address the user typed.",
              "prompt": "What elementary school is zoned for 123 7th Ave, Brooklyn?",
              "tools_triggered": "get-zoned-school",
              "expected_behavior": "Returns P.S. 321 William Penn (DBN 15K321) as the zoned school, its neighborhood (Park Slope) and how zoned admission works, including that in-zone students get a guaranteed seat at elementary level, with a link to the school's motley.nyc page."
            },
            {
              "description": "School selectivity: resolve a school by name, then explain how it admits students without estimating odds.",
              "prompt": "How hard is it to get into Townsend Harris High School?",
              "tools_triggered": "find-school, get-admissions-demand",
              "expected_behavior": "Resolves the name to Townsend Harris High School (DBN 25Q525), then explains that it admits by screened admission: what that asks of a family, its programs and seats, and its applicant counts where NYC MySchools publishes them. Attributes the counts to MySchools and the competitiveness band to Motley, never to the DOE, and gives no odds, chance or percentage."
            },
            {
              "description": "Admissions knowledge: explain how one admission method works and what it asks of a family.",
              "prompt": "How does screened admission work for NYC middle schools, and what do they ask families for?",
              "tools_triggered": "explain-admissions-method",
              "expected_behavior": "Explains screened admission in plain language: how schools rank applicants, the typical application window (noting that the city announces exact dates each year), and what a screened program asks of a family beyond the standard application."
            },
            {
              "description": "Neighborhood comparison: resolve two neighborhoods by name and compare them side by side.",
              "prompt": "Compare Jackson Heights and Sunnyside for a family with a toddler.",
              "tools_triggered": "search-neighborhoods, compare-neighborhoods",
              "expected_behavior": "Finds both Queens neighborhoods (Jackson Heights, Sunnyside), then compares them across the family-fit metrics such as schools, safety, transit and affordability, says which one leads on each, and sums up the trade-offs for a family with a young child."
            }
          ],
          "negative": [
            {
              "description": "Outside New York City: the plugin covers NYC only and should not answer for another city.",
              "prompt": "What are the best elementary schools in Los Angeles?",
              "expected_behavior": "Does not present Motley NYC data as an answer about Los Angeles. Says the plugin only covers New York City."
            },
            {
              "description": "Admission odds: the plugin may look up the school but must never estimate a family's chances.",
              "prompt": "What are our odds of getting into Stuyvesant? Give me a percentage.",
              "tools_triggered": "find-school, get-admissions-demand",
              "expected_behavior": "May look up Stuyvesant High School to explain that it admits by SHSAT score and what its published seats and applicant counts show, but states no odds, chance or percentage for this family and says why."
            },
            {
              "description": "Apartment listings: out of scope, since Motley NYC has no listings.",
              "prompt": "Find me a two-bedroom apartment for rent in Park Slope.",
              "expected_behavior": "Says Motley NYC has no apartment listings and doesn't present neighborhood data as listings. May offer to describe Park Slope as a neighborhood instead."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Motley NYC does not sell anything, take payments, or offer purchases. Every tool is a read-only lookup.",
        "demo_recording_url": "https://youtu.be/51UrYpPQb24"
      },
      "publication": {
        "countries": [],
        "release_notes": "Every school now carries a Motley rating on the grades it serves: elementary and middle schools on the state ELA and math tests, high schools on graduation and Regents results, so school lookups return each school's ratings and high schools rank by theirs. Neighborhood school scores count high schools too, and commute times read as a range from typical to high."
      }
    }
  },
  "apps": "./.app.json"
}