SchoolScope
California school data for AI agents — scores, profiles, comparisons, feeder paths, UC pipelines.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWsimilar_schools에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"mcp": {
"url": "https://mcp.schoolscope.co/mcp"
}
}
}원격 엔드포인트
https://mcp.schoolscope.co/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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.
입력 스키마
{
"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#"
}출력 스키마
{
"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.
입력 스키마
{
"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#"
}출력 스키마
{
"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.
입력 스키마
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"minLength": 1,
"description": "URL slug of the school"
}
},
"required": [
"slug"
],
"$schema": "http://json-schema.org/draft-07/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.
입력 스키마
{
"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#"
}출력 스키마
{
"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.
입력 스키마
{
"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#"
}출력 스키마
{
"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.
입력 스키마
{
"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#"
}출력 스키마
{
"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.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/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
}커뮤니티
증거