{
  "name": "AbuDhabiSchools.com",
  "description": "Independent, ad-free guide to 225 indexed Abu Dhabi private schools: 212 with a published Irtiqaa rating and 13 awaiting a first inspection.",
  "homepage": "https://abudhabischools.com",
  "documentation": "https://abudhabischools.com/api/",
  "access": "public, read-only, no authentication",
  "api": {
    "endpoint": "https://abudhabischools.com/api/schools",
    "full_dataset": "https://abudhabischools.com/data/schools.json"
  },
  "mcp": {
    "endpoint": "https://abudhabischools.com/mcp",
    "transport": "Streamable HTTP",
    "protocol": "MCP 2026-07-28 with stateless compatibility for 2025-era clients",
    "tools": [
      {
        "name": "search_schools",
        "description": "Search the Abu Dhabi school index by name, area, curriculum, Irtiqaa rating, annual fee and AbuDhabiSchools Score."
      },
      {
        "name": "get_school",
        "description": "Get the complete record for one school by numeric id, slug or exact name."
      },
      {
        "name": "compare_schools",
        "description": "Compare two to five schools using Irtiqaa ratings, fees, enrolment, curriculum, inspection and location fields."
      },
      {
        "name": "list_areas",
        "description": "List ADEK school areas with indexed and ADEK-rated school counts."
      },
      {
        "name": "get_school_statistics",
        "description": "Calculate rating, curriculum and annual-fee statistics for the full index or a filtered area or curriculum."
      }
    ]
  },
  "developer_platform": {
    "documentation": "https://abudhabischools.com/developers/docs/",
    "openapi": "https://abudhabischools.com/developers/openapi.yaml",
    "api_base": "https://abudhabischools.com/v1",
    "mcp_endpoint": "https://abudhabischools.com/v1/mcp",
    "authentication": "X-API-Key or Bearer API key",
    "launch_status": "non-commercial evaluation open; commercial access gated pending source-rights approval"
  },
  "note": "The API and MCP server are read-only. No school can pay to be listed, ranked or featured.",
  "skills": [
    {
      "name": "browse_school",
      "description": "Read the full profile of one school: Irtiqaa rating and six-year history, ADEK average fee and fee category, enrolment trends, National Identity Mark, and location. 225 schools, each with a schema.org/School JSON-LD graph embedded.",
      "method": "GET",
      "route": "https://abudhabischools.com/school/{slug}/",
      "example": "https://abudhabischools.com/school/abc-private-school/",
      "returns": "text/html"
    },
    {
      "name": "find_schools_by_area_curriculum_or_metro",
      "description": "Ranked landing pages for a query like \"British schools in Abu Dhabi\" or \"schools in Yas Island\". 88 pages, each listing matching schools ordered by Irtiqaa rating with a CollectionPage JSON-LD graph.",
      "method": "GET",
      "route": "https://abudhabischools.com/best/{descriptor}/",
      "example": "https://abudhabischools.com/best/british-schools-in-abu-dhabi/",
      "returns": "text/html"
    },
    {
      "name": "compare_two_schools",
      "description": "Head-to-head comparison page for two named schools (rating, fees, curriculum, location). 100 pre-built comparison pages.",
      "method": "GET",
      "route": "https://abudhabischools.com/vs/{slug-a}-vs-{slug-b}/",
      "example": "https://abudhabischools.com/vs/abu-dhabi-indian-school-wathba-vs-bright-riders-school/",
      "returns": "text/html"
    },
    {
      "name": "browse_by_community",
      "description": "Browse schools grouped by Abu Dhabi community / residential area.",
      "method": "GET",
      "route": "https://abudhabischools.com/communities/{slug}/",
      "example": "https://abudhabischools.com/communities/yas-island/",
      "returns": "text/html"
    },
    {
      "name": "rankings",
      "description": "Schools ranked by Irtiqaa rating and the composite AbuDhabiSchools Score.",
      "method": "GET",
      "route": "https://abudhabischools.com/rankings/",
      "example": "https://abudhabischools.com/rankings/",
      "returns": "text/html"
    },
    {
      "name": "nurseries",
      "description": "Licensed early-years settings (224 nurseries).",
      "method": "GET",
      "route": "https://abudhabischools.com/nurseries/",
      "example": "https://abudhabischools.com/nurseries/",
      "returns": "text/html"
    },
    {
      "name": "get_full_dataset",
      "description": "The complete open dataset: 225 schools (Irtiqaa ratings, ADEK average fees, capacity, location, enrolment histories, derived scores). One JSON file, no auth.",
      "method": "GET",
      "route": "https://abudhabischools.com/data/schools.json",
      "example": "https://abudhabischools.com/data/schools.json",
      "returns": "application/json"
    },
    {
      "name": "query_school_api",
      "description": "Filter and paginate school summaries by text, area, curriculum, Irtiqaa rating, annual fee or AbuDhabiSchools Score. Get a complete record by id or slug.",
      "method": "GET",
      "route": "https://abudhabischools.com/api/schools",
      "example": "https://abudhabischools.com/api/schools?curriculum=UK&rating=Outstanding&limit=5",
      "returns": "application/json"
    },
    {
      "name": "use_mcp_server",
      "description": "MCP Streamable HTTP endpoint with 5 read-only tools: search_schools, get_school, compare_schools, list_areas, get_school_statistics.",
      "method": "POST",
      "route": "https://abudhabischools.com/mcp",
      "example": "https://abudhabischools.com/mcp",
      "returns": "application/json"
    },
    {
      "name": "use_versioned_developer_platform",
      "description": "Authenticated, versioned REST API and MCP service for maintained integrations, with stable models, source metadata, field profiles, named keys, quotas and usage reporting. Evaluation keys are non-commercial; commercial access is gated pending source-rights approval.",
      "method": "GET",
      "route": "https://abudhabischools.com/developers/docs/",
      "example": "https://abudhabischools.com/developers/docs/",
      "returns": "text/html"
    },
    {
      "name": "get_nurseries_dataset",
      "description": "Open dataset of 224 nurseries and early-learning centres.",
      "method": "GET",
      "route": "https://abudhabischools.com/data/nurseries.json",
      "example": "https://abudhabischools.com/data/nurseries.json",
      "returns": "application/json"
    },
    {
      "name": "get_area_aliases",
      "description": "Mapping of residential community names to the ADEK area names used across the site.",
      "method": "GET",
      "route": "https://abudhabischools.com/data/area-aliases.json",
      "example": "https://abudhabischools.com/data/area-aliases.json",
      "returns": "application/json"
    },
    {
      "name": "plain_text_export",
      "description": "Condensed plain-text export of the full dataset, sized for LLM context windows.",
      "method": "GET",
      "route": "https://abudhabischools.com/llms-full.txt",
      "example": "https://abudhabischools.com/llms-full.txt",
      "returns": "text/plain"
    }
  ]
}