SchoolScope
California school data for AI agents — scores, profiles, comparisons, feeder paths, UC pipelines.
我该使用它吗
质量与安全性
A
发现（1）
- LOWTool 'similar_schools' description lacks action verb在 similar_schools 中
基于对工具定义和协议合规性的自动分析。
上下文开销
~7,112token 数（工具定义）
~10.2 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 5.56%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `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"
}
]
},
"patterns": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"evidence": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"key",
"label",
"evidence",
"question"
],
"additionalProperties": false
}
},
"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",
"patterns",
"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 (school-by-grade aggregates 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"
}
]
},
"patterns": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"evidence": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"key",
"label",
"evidence",
"question"
],
"additionalProperties": false
}
}
},
"required": [
"level",
"scopeScore",
"band",
"statePercentile",
"pctExceeded",
"pctMetAbove",
"oneLiner",
"cohortGrowthScalePoints",
"cohortSpan",
"growthIndex",
"gradeGapThisYearPp",
"chronicAbsentRate",
"suspensionRate",
"archetype",
"patterns"
],
"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 (aggregate school-by-grade cohorts 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"
}
]
},
"patterns": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"evidence": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"key",
"label",
"evidence",
"question"
],
"additionalProperties": false
}
},
"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",
"patterns",
"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"
}
]
},
"patterns": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"evidence": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"key",
"label",
"evidence",
"question"
],
"additionalProperties": false
}
},
"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",
"patterns",
"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"
}
]
},
"patterns": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"evidence": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"key",
"label",
"evidence",
"question"
],
"additionalProperties": false
}
},
"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",
"patterns",
"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"
}
]
},
"patterns": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"evidence": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"key",
"label",
"evidence",
"question"
],
"additionalProperties": false
}
},
"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",
"patterns",
"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
}社区
证据
最近观测
已验证未记录版本7 个工具
已验证未记录版本7 个工具
已验证未记录版本7 个工具