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 個工具