SchoolScope
California school data for AI agents — scores, profiles, comparisons, feeder paths, UC pipelines.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (1)
- LOWin similar_schools
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"mcp": {
"url": "https://mcp.schoolscope.co/mcp"
}
}
}Remote-Endpunkte
https://mcp.schoolscope.co/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (7)
🟢find_schools(query, zip, near, radius_miles, level, ...)
Find California schools four ways, whichever fits the question: free text over school/city/district names (`query`), inside a zip code (`zip`), within a radius of a place or coordinate (`near`), or the top-ranked schools at one level (`level` alone). Returns band, Scope Score, archetype and profile URL for each match. Private schools are flagged and never ranked — they have no state testing data. Supply exactly one of query, zip or near; or none plus a level for a top list. Set `tk: true` to limit any of these searches to schools with active transitional kindergarten (TK) enrollment — a filter that composes with query, zip, near and level, and every result carries a `hasTk` field.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"description": "Free text: school, city or district name, e.g. 'lowell', 'palo alto unified'",
"type": "string",
"minLength": 2,
"maxLength": 100
},
"zip": {
"description": "5-digit California zip code, e.g. '94110'",
"type": "string",
"pattern": "^\\d{5}$"
},
"near": {
"description": "A point to search around: 'lat,lng' (e.g. '37.4299,-122.1285'), a 5-digit zip, or a California city name. Zips and city names resolve to the centre of the schools we hold there, so no external geocoding is needed. Radius search crosses district and city lines on purpose — that is the point of asking geographically.",
"type": "string",
"minLength": 2,
"maxLength": 100
},
"radius_miles": {
"description": "Radius for `near`, in miles. Default 5. Ignored unless `near` is set.",
"default": 5,
"type": "number",
"minimum": 0.5,
"maximum": 25
},
"level": {
"description": "Restrict to one level. Elementary, middle and high are scored on separate scales and are never mixed. With no query/zip/near, returns the top-ranked schools at this level.",
"type": "string",
"enum": [
"elementary",
"middle",
"high"
]
},
"tk": {
"description": "true limits results to schools with active transitional kindergarten (TK) enrollment.",
"type": "boolean"
},
"limit": {
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"heading": {
"type": "string"
},
"point": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"resolvedFrom": {
"type": "string"
}
},
"required": [
"lat",
"lng",
"resolvedFrom"
],
"additionalProperties": false
},
"radiusMiles": {
"type": "number"
},
"schools": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"type": "string"
},
"ogImage": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zip": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lat": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"lng": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"county": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"schoolType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"level": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"scored": {
"type": "boolean"
},
"hasTk": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"scopeScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"band": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"statePercentile": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pctExceeded": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pctMetAbove": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"cohortGrowthScalePoints": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"cohortSpan": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"growthIndex": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"chronicAbsentRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"suspensionRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"archetype": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"peerClass": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"matchNote": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"distanceMiles": {
"type": "number"
},
"freeLunchPct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"enrollment": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"slug",
"url",
"ogImage",
"city",
"zip",
"lat",
"lng",
"district",
"county",
"schoolType",
"level",
"scored",
"hasTk",
"scopeScore",
"band",
"statePercentile",
"pctExceeded",
"pctMetAbove",
"cohortGrowthScalePoints",
"cohortSpan",
"growthIndex",
"chronicAbsentRate",
"suspensionRate",
"archetype",
"peerClass"
],
"additionalProperties": false
}
},
"meta": {
"type": "object",
"properties": {
"data_year": {
"type": "number"
},
"source_agency": {
"type": "string"
},
"attribution": {
"type": "string"
},
"methodology_url": {
"type": "string"
},
"comparability": {
"type": "string"
},
"growth_basis": {
"type": "string"
},
"generated_at": {
"type": "string"
}
},
"required": [
"data_year",
"source_agency",
"attribution",
"methodology_url",
"comparability",
"growth_basis",
"generated_at"
],
"additionalProperties": false
}
},
"required": [
"schools",
"meta"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢school_profile(slug)
The full SchoolScope profile for one school by slug: verdict and archetype, Scope Score with band and percentile per level, CAASPP exceeded/met split, cohort growth (the same students two years apart, in SBAC scale-score points, reported as a 0-100 index centred on the state average), climate (absenteeism, suspension, ELPAC), equity gaps by student group, teacher stability, and — for high schools — graduation, college destinations, UC admissions history, AP courses, and IB programmes. Also answers "is this school improving?" with a year-over-year table of statewide percentile and the underlying rates; the Scope Score is excluded there because it is normalised within each year and is not comparable across them. Current data year 2025.
Eingabe-Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"minLength": 1,
"description": "URL slug, e.g. 'lowell-high-san-francisco-unified'. Get it from find_schools."
}
},
"required": [
"slug"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"school": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"type": "string"
},
"ogImage": {
"type": "string"
},
"type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zip": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"county": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"enrollment": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"hasTk": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"dataYear": {
"type": "number"
},
"primaryLevel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"peerClass": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"scored": {
"type": "boolean"
},
"levels": {
"type": "array",
"items": {
"type": "object",
"properties": {
"level": {
"type": "string"
},
"scopeScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"band": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"statePercentile": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pctExceeded": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pctMetAbove": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"oneLiner": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"cohortGrowthScalePoints": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"cohortSpan": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"growthIndex": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"gradeGapThisYearPp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"chronicAbsentRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"suspensionRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"archetype": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"level",
"scopeScore",
"band",
"statePercentile",
"pctExceeded",
"pctMetAbove",
"oneLiner",
"cohortGrowthScalePoints",
"cohortSpan",
"growthIndex",
"gradeGapThisYearPp",
"chronicAbsentRate",
"suspensionRate",
"archetype"
],
"additionalProperties": false
}
},
"highSchool": {
"anyOf": [
{
"type": "object",
"properties": {
"graduationRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"collegeGoing": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"ucLatest": {
"anyOf": [
{
"type": "object",
"properties": {},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"apOwnCourses": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"ib": {
"anyOf": [
{
"type": "object",
"properties": {},
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"required": [
"graduationRate",
"collegeGoing",
"ucLatest",
"apOwnCourses",
"ib"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"slug",
"url",
"ogImage",
"type",
"city",
"district",
"enrollment",
"hasTk"
],
"additionalProperties": false
},
"trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"year": {
"type": "number"
},
"level": {
"type": "string"
},
"statePercentile": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pctExceeded": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pctMetAbove": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"year",
"level",
"statePercentile",
"pctExceeded",
"pctMetAbove"
],
"additionalProperties": false
}
},
"meta": {
"type": "object",
"properties": {
"data_year": {
"type": "number"
},
"source_agency": {
"type": "string"
},
"attribution": {
"type": "string"
},
"methodology_url": {
"type": "string"
},
"comparability": {
"type": "string"
},
"growth_basis": {
"type": "string"
},
"generated_at": {
"type": "string"
}
},
"required": [
"data_year",
"source_agency",
"attribution",
"methodology_url",
"comparability",
"growth_basis",
"generated_at"
],
"additionalProperties": false
}
},
"required": [
"school",
"meta"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢feeder_path(slug)
The K-12 feeder path for a school: which schools students typically arrive from, where they go next, and — for elementary/middle schools — the endpoint high school with its graduation and college-going outcomes. Boundary-based (NCES SABS), shown alongside scores, never inside them.
Eingabe-Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"minLength": 1,
"description": "URL slug of the school"
}
},
"required": [
"slug"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"school": {
"type": "string"
},
"subject": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"ogImage": {
"type": "string"
}
},
"required": [
"name",
"slug",
"url",
"city",
"ogImage"
],
"additionalProperties": false
},
"feedsFrom": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"ogImage": {
"type": "string"
},
"band": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"schoolType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"relationship": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"overlapPct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"levelFrom": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"levelTo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"scopeScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"statePercentile": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"peerClass": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"name",
"url",
"ogImage",
"band",
"schoolType",
"relationship",
"source",
"overlapPct",
"levelFrom",
"levelTo",
"scopeScore",
"statePercentile",
"peerClass"
],
"additionalProperties": false
}
},
"feedsInto": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"ogImage": {
"type": "string"
},
"band": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"schoolType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"relationship": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"overlapPct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"levelFrom": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"levelTo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"scopeScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"statePercentile": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"peerClass": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"name",
"url",
"ogImage",
"band",
"schoolType",
"relationship",
"source",
"overlapPct",
"levelFrom",
"levelTo",
"scopeScore",
"statePercentile",
"peerClass"
],
"additionalProperties": false
}
},
"endpoint": {
"anyOf": [
{
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"ogImage": {
"type": "string"
},
"scopeScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"graduationRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"collegeGoingRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"name",
"url",
"ogImage",
"scopeScore",
"graduationRate",
"collegeGoingRate"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"meta": {
"type": "object",
"properties": {
"data_year": {
"type": "number"
},
"source_agency": {
"type": "string"
},
"attribution": {
"type": "string"
},
"methodology_url": {
"type": "string"
},
"comparability": {
"type": "string"
},
"growth_basis": {
"type": "string"
},
"generated_at": {
"type": "string"
}
},
"required": [
"data_year",
"source_agency",
"attribution",
"methodology_url",
"comparability",
"growth_basis",
"generated_at"
],
"additionalProperties": false
}
},
"required": [
"school",
"subject",
"feedsFrom",
"feedsInto",
"endpoint",
"meta"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢compare_schools(slugs)
Compare 2-4 public schools side by side: band, Scope Score, exceeded/met split, cohort growth (same students across the grade span, as a 0-100 index centred on the state average), climate. A school with no cohort comparison reports no growth figure rather than a substitute — treat that as missing evidence, not flat growth. Schools are only comparable within the same level (elementary/middle/high are separate rankings). Private schools cannot be compared — they have no state testing data.
Eingabe-Schema
{
"type": "object",
"properties": {
"slugs": {
"minItems": 2,
"maxItems": 4,
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "2-4 school slugs from find_schools"
}
},
"required": [
"slugs"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"compared": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"ogImage": {
"type": "string"
},
"level": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"scopeScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"band": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"statePercentile": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"archetype": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"pctExceeded": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pctMetAbove": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"cohortGrowthScalePoints": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"cohortSpan": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"growthIndex": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"gradeGapThisYearPp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"chronicAbsentRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"suspensionRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"peerClass": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"name",
"url",
"city",
"ogImage",
"level",
"scopeScore",
"band",
"statePercentile",
"archetype",
"pctExceeded",
"pctMetAbove",
"cohortGrowthScalePoints",
"cohortSpan",
"growthIndex",
"gradeGapThisYearPp",
"chronicAbsentRate",
"suspensionRate",
"peerClass"
],
"additionalProperties": false
}
},
"excludedPrivate": {
"type": "array",
"items": {
"type": "string"
}
},
"meta": {
"type": "object",
"properties": {
"data_year": {
"type": "number"
},
"source_agency": {
"type": "string"
},
"attribution": {
"type": "string"
},
"methodology_url": {
"type": "string"
},
"comparability": {
"type": "string"
},
"growth_basis": {
"type": "string"
},
"generated_at": {
"type": "string"
}
},
"required": [
"data_year",
"source_agency",
"attribution",
"methodology_url",
"comparability",
"growth_basis",
"generated_at"
],
"additionalProperties": false
}
},
"required": [
"compared",
"excludedPrivate",
"meta"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢district_profile(district)
A California district roll-up: average Scope Score and absenteeism across the district plus every scored school ranked by level. Match by district name.
Eingabe-Schema
{
"type": "object",
"properties": {
"district": {
"type": "string",
"minLength": 2,
"maxLength": 100,
"description": "District name or fragment, e.g. 'palo alto unified'"
}
},
"required": [
"district"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"district": {
"type": "string"
},
"county": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"stats": {
"anyOf": [
{
"type": "object",
"properties": {
"schoolCount": {
"type": "number"
},
"avgScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"avgExceeded": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"avgAbsent": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"schoolCount",
"avgScore",
"avgExceeded",
"avgAbsent"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"schools": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"type": "string"
},
"ogImage": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zip": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lat": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"lng": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"county": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"schoolType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"level": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"scored": {
"type": "boolean"
},
"hasTk": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"scopeScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"band": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"statePercentile": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pctExceeded": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pctMetAbove": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"cohortGrowthScalePoints": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"cohortSpan": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"growthIndex": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"chronicAbsentRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"suspensionRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"archetype": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"peerClass": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"matchNote": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"distanceMiles": {
"type": "number"
},
"freeLunchPct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"enrollment": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"slug",
"url",
"ogImage",
"city",
"zip",
"lat",
"lng",
"district",
"county",
"schoolType",
"level",
"scored",
"hasTk",
"scopeScore",
"band",
"statePercentile",
"pctExceeded",
"pctMetAbove",
"cohortGrowthScalePoints",
"cohortSpan",
"growthIndex",
"chronicAbsentRate",
"suspensionRate",
"archetype",
"peerClass"
],
"additionalProperties": false
}
},
"meta": {
"type": "object",
"properties": {
"data_year": {
"type": "number"
},
"source_agency": {
"type": "string"
},
"attribution": {
"type": "string"
},
"methodology_url": {
"type": "string"
},
"comparability": {
"type": "string"
},
"growth_basis": {
"type": "string"
},
"generated_at": {
"type": "string"
}
},
"required": [
"data_year",
"source_agency",
"attribution",
"methodology_url",
"comparability",
"growth_basis",
"generated_at"
],
"additionalProperties": false
}
},
"required": [
"district",
"county",
"stats",
"schools",
"meta"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢similar_schools(slug, limit)
Schools serving a similar student population to a given school — same level, comparable free/reduced-lunch share and enrollment size — with the subject's standing among them. This is the fair comparison: a raw ranking largely reflects who enrolls, so a school's position against demographic peers says far more about the school itself than its statewide rank does. Public schools only.
Eingabe-Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"minLength": 1,
"description": "URL slug of the school to find peers for. Get it from find_schools."
},
"limit": {
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 25
}
},
"required": [
"slug"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"subject": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"type": "string"
},
"ogImage": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zip": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lat": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"lng": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"county": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"schoolType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"level": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"scored": {
"type": "boolean"
},
"hasTk": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"scopeScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"band": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"statePercentile": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pctExceeded": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pctMetAbove": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"cohortGrowthScalePoints": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"cohortSpan": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"growthIndex": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"chronicAbsentRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"suspensionRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"archetype": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"peerClass": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"matchNote": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"distanceMiles": {
"type": "number"
},
"freeLunchPct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"enrollment": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"slug",
"url",
"ogImage",
"city",
"zip",
"lat",
"lng",
"district",
"county",
"schoolType",
"level",
"scored",
"hasTk",
"scopeScore",
"band",
"statePercentile",
"pctExceeded",
"pctMetAbove",
"cohortGrowthScalePoints",
"cohortSpan",
"growthIndex",
"chronicAbsentRate",
"suspensionRate",
"archetype",
"peerClass"
],
"additionalProperties": false
},
"peers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"type": "string"
},
"ogImage": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zip": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lat": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"lng": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"county": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"schoolType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"level": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"scored": {
"type": "boolean"
},
"hasTk": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"scopeScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"band": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"statePercentile": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pctExceeded": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pctMetAbove": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"cohortGrowthScalePoints": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"cohortSpan": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"growthIndex": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"chronicAbsentRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"suspensionRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"archetype": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"peerClass": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"matchNote": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"distanceMiles": {
"type": "number"
},
"freeLunchPct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"enrollment": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"slug",
"url",
"ogImage",
"city",
"zip",
"lat",
"lng",
"district",
"county",
"schoolType",
"level",
"scored",
"hasTk",
"scopeScore",
"band",
"statePercentile",
"pctExceeded",
"pctMetAbove",
"cohortGrowthScalePoints",
"cohortSpan",
"growthIndex",
"chronicAbsentRate",
"suspensionRate",
"archetype",
"peerClass"
],
"additionalProperties": false
}
},
"freeLunchWindow": {
"anyOf": [
{
"type": "array",
"items": {
"type": "number"
}
},
{
"type": "null"
}
]
},
"outscoredPeers": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"matchedPeerCount": {
"type": "number"
},
"meta": {
"type": "object",
"properties": {
"data_year": {
"type": "number"
},
"source_agency": {
"type": "string"
},
"attribution": {
"type": "string"
},
"methodology_url": {
"type": "string"
},
"comparability": {
"type": "string"
},
"growth_basis": {
"type": "string"
},
"generated_at": {
"type": "string"
}
},
"required": [
"data_year",
"source_agency",
"attribution",
"methodology_url",
"comparability",
"growth_basis",
"generated_at"
],
"additionalProperties": false
}
},
"required": [
"subject",
"peers",
"freeLunchWindow",
"meta"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢my_watchlist
Return the schools the authenticated user has saved on SchoolScope. Requires the `watchlist:read` OAuth scope.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"watchlist": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"name"
],
"additionalProperties": false
}
},
"email": {
"type": "string"
},
"meta": {
"type": "object",
"properties": {
"data_year": {
"type": "number"
},
"source_agency": {
"type": "string"
},
"attribution": {
"type": "string"
},
"methodology_url": {
"type": "string"
},
"comparability": {
"type": "string"
},
"growth_basis": {
"type": "string"
},
"generated_at": {
"type": "string"
}
},
"required": [
"data_year",
"source_agency",
"attribution",
"methodology_url",
"comparability",
"growth_basis",
"generated_at"
],
"additionalProperties": false
}
},
"required": [
"watchlist",
"email",
"meta"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Community
Nachweis