{
  "$schema": "https://schoolsnearme.ai/.well-known/agent-skills/index.json",
  "name": "Schools Near Me",
  "description": "Find, compare and research 26,976 schools and education establishments across England and Wales using official DfE, Ofsted, Estyn and ISI data.",
  "homepage": "https://schoolsnearme.ai",
  "documentation": "https://schoolsnearme.ai/skill.md",
  "llms": "https://schoolsnearme.ai/llms.txt",
  "contact": "https://schoolsnearme.ai/about",
  "termsOfService": "https://schoolsnearme.ai/terms",
  "lastUpdated": "2026-07-29",
  "openapi": "https://schoolsnearme.ai/openapi.json",
  "mcp": {
    "transport": "streamable-http",
    "url": "https://schoolsnearme.ai/mcp",
    "readOnly": true,
    "protocolVersions": ["2026-07-28", "2025-11-25", "2025-06-18", "2025-03-26"]
  },
  "skills": [
    {
      "name": "search_schools",
      "description": "Search open schools by name or local authority, or find nearest schools to a UK postcode. Supports phase, radius and result-limit filters.",
      "method": "GET",
      "url": "https://schoolsnearme.ai/api/v1/search",
      "parameters": {
        "query": "School name, local authority or type",
        "postcode": "Full UK postcode or outward code",
        "phase": "Optional: primary, secondary, nursery, sixth form or all-through",
        "radius_miles": "Optional maximum distance, 0.1 to 100",
        "limit": "Optional result limit, 1 to 25"
      },
      "example": "https://schoolsnearme.ai/api/v1/search?postcode=M20%204BX&phase=secondary&limit=5",
      "responseType": "application/json"
    },
    {
      "name": "search_schools_by_area",
      "description": "Browse all schools in a town, city or local authority area, with Ofsted ratings and key data. Replace the area slug with a kebab-case place name (e.g. leeds, manchester, islington).",
      "method": "GET",
      "url": "https://schoolsnearme.ai/schools-in/{area}/",
      "parameters": { "area": "Kebab-case place name, e.g. 'leeds'" },
      "example": "https://schoolsnearme.ai/schools-in/leeds/"
    },
    {
      "name": "search_schools_near_area",
      "description": "Browse schools near a named place, ordered by proximity.",
      "method": "GET",
      "url": "https://schoolsnearme.ai/schools-near/{area}/",
      "parameters": { "area": "Kebab-case place name, e.g. 'manchester'" },
      "example": "https://schoolsnearme.ai/schools-near/manchester/"
    },
    {
      "name": "view_school_profile",
      "description": "View the full profile for one school by its DfE Unique Reference Number (URN): Ofsted history, exam results (KS2/GCSE/A-level), attendance, demographics, workforce, finances, catchment and an AI summary. The page also embeds schema.org JSON-LD for parsing.",
      "method": "GET",
      "url": "https://schoolsnearme.ai/school/{urn}",
      "parameters": { "urn": "6-digit DfE URN, e.g. 100000" },
      "example": "https://schoolsnearme.ai/school/100000",
      "note": "URN-only URLs 301-redirect to the slugged form (e.g. /school/100000-the-aldgate-school)."
    },
    {
      "name": "get_school_data",
      "description": "Fetch the current public structured data record for one school as JSON. Available fields vary by phase, source coverage and suppression rules; premium-only fields are not returned anonymously.",
      "method": "GET",
      "url": "https://schoolsnearme.ai/api/v1/schools/{urn}",
      "parameters": { "urn": "6-digit DfE URN, e.g. 100000" },
      "example": "https://schoolsnearme.ai/api/v1/schools/100000",
      "responseType": "application/json"
    },
    {
      "name": "compare_schools",
      "description": "Side-by-side comparison of multiple schools across Ofsted, results, attendance and other measures.",
      "method": "GET",
      "url": "https://schoolsnearme.ai/compare",
      "example": "https://schoolsnearme.ai/compare"
    },
    {
      "name": "browse_rankings",
      "description": "Curated, data-driven rankings of English schools. Each is a sortable, filterable table built from official data.",
      "method": "GET",
      "url": "https://schoolsnearme.ai/rankings",
      "routes": [
        "https://schoolsnearme.ai/rankings/beating-the-postcode",
        "https://schoolsnearme.ai/rankings/improving-fastest",
        "https://schoolsnearme.ai/rankings/financial-trouble",
        "https://schoolsnearme.ai/rankings/explore"
      ]
    },
    {
      "name": "browse_curated_lists",
      "description": "Themed school lists by type or characteristic, each with Ofsted and performance data.",
      "method": "GET",
      "url": "https://schoolsnearme.ai/school-types",
      "routes": [
        "https://schoolsnearme.ai/independent-schools",
        "https://schoolsnearme.ai/grammar-schools",
        "https://schoolsnearme.ai/faith-schools",
        "https://schoolsnearme.ai/hidden-gems",
        "https://schoolsnearme.ai/value-add",
        "https://schoolsnearme.ai/university-destinations",
        "https://schoolsnearme.ai/best-primary-schools-in/{area}/",
        "https://schoolsnearme.ai/best-secondary-schools-in/{area}/"
      ]
    }
  ],
  "dataSources": [
    "Ofsted inspection reports and ratings",
    "Estyn inspection reports",
    "Independent Schools Inspectorate reports",
    "DfE School Performance Tables (KS2, KS4, KS5)",
    "Get Information About Schools (GIAS)",
    "School Census",
    "Ofsted Parent View"
  ]
}
