Skip to main content
Glama

Brainy Prices — UAE Cost of Living

schools

Read-onlyIdempotent

Dubai school fees: KHDA tuition by grade/year, bus fees, distance. q: school name; near: zone; school_id: detail. Year ≠ Grade; uniforms paused.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
qNoschool name or part of it
areaNo
nearNoZone, not school.
sortNoname
gradeNo
cursorNo
ratingNo
page_sizeNo
radius_kmNo
school_idNo
curriculumNo
max_fee_aedNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • removedInput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
  2. Changed4 schema fields changed
    • removedOutput schema / $defs / SchoolFeePolicy
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "note": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "rules": {
      -      "items": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "academic_year": {
      -            "type": "string"
      -          },
      -          "announced": {
      -            "type": "string"
      -          },
      -          "cap_pct": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "id": {
      -            "type": "string"
      -          },
      -          "kind": {
      -            "enum": [
      -              "cap",
      -              "no-increase"
      -            ]
      -          },
      -          "publisher": {
      -            "type": "string"
      -          },
      -          "quote": {
      -            "type": "string"
      -          },
      -          "summary": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "academic_year",
      -          "kind",
      -          "cap_pct",
      -          "announced",
      -          "publisher",
      -          "url",
      -          "quote",
      -          "summary"
      -        ],
      -        "type": "object"
      -      },
      -      "type": "array"
      -    }
      -  },
      -  "required": [
      -    "note",
      -    "rules"
      -  ],
      -  "type": "object"
      -}
    • addedOutput schema / $defs / SchoolFeePolicySummary
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "note": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "rules": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "academic_year": {
      +                "type": "string"
      +              },
      +              "announced": {
      +                "type": "string"
      +              },
      +              "cap_pct": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "id": {
      +                "type": "string"
      +              },
      +              "kind": {
      +                "enum": [
      +                  "cap",
      +                  "no-increase"
      +                ]
      +              },
      +              "publisher": {
      +                "type": "string"
      +              },
      +              "quote": {
      +                "type": "string"
      +              },
      +              "summary": {
      +                "type": "string"
      +              },
      +              "url": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "id",
      +              "academic_year",
      +              "kind",
      +              "cap_pct",
      +              "announced",
      +              "publisher",
      +              "url",
      +              "quote",
      +              "summary"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        }
      +      },
      +      "required": [
      +        "note",
      +        "rules"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / SchoolSearchContext
      Added value: +{
      +  "additionalProperties": true,
      +  "required": [
      +    "search"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "context": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "search": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "displayed_count": {
      -                "type": "integer"
      -              },
      -              "near": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "radius_km": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "remaining_count": {
      -                "type": "integer"
      -              },
      -              "returned_remaining_count": {
      -                "type": "integer"
      -              },
      -              "total_schools": {
      -                "type": "integer"
      -              },
      -              "unlocated": {
      -                "type": [
      -                  "integer",
      -                  "null"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "total_schools",
      -              "near",
      -              "radius_km",
      -              "unlocated"
      -            ],
      -            "type": "object"
      -          }
      -        },
      -        "required": [
      -          "search"
      -        ],
      -        "type": "object"
      -      },
      -      "data": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "academic_year": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "annual_fee_range": {
      -              "anyOf": [
      -                {
      -                  "$ref": "#/$defs/AedRange"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "area": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "bus": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "academic_year": {
      -                      "type": "string"
      -                    },
      -                    "operator": {
      -                      "type": "string"
      -                    },
      -                    "source_url": {
      -                      "type": "string"
      -                    },
      -                    "zones": {
      -                      "items": {
      -                        "additionalProperties": false,
      -                        "properties": {
      -                          "annual_aed": {
      -                            "type": "number"
      -                          },
      -                          "zone": {
      -                            "type": "integer"
      -                          }
      -                        },
      -                        "required": [
      -                          "zone",
      -                          "annual_aed"
      -                        ],
      -                        "type": "object"
      -                      },
      -                      "type": "array"
      -                    }
      -                  },
      -                  "required": [
      -                    "operator",
      -                    "academic_year",
      -                    "zones",
      -                    "source_url"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "curricula": {
      -              "items": {
      -                "type": "string"
      -              },
      -              "type": "array"
      -            },
      -            "distance_km": {
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "grade_fee_aed": {
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "location_approximate": {
      -              "type": [
      -                "boolean",
      -                "null"
      -              ]
      -            },
      -            "name": {
      -              "type": "string"
      -            },
      -            "open_in_browser": {
      -              "type": "string"
      -            },
      -            "provenance": {
      -              "$ref": "#/$defs/Provenance"
      -            },
      -            "rating": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "school_id": {
      -              "type": "string"
      -            },
      -            "source_url": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "uniforms_status": {
      -              "enum": [
      -                "available",
      -                "paused",
      -                "not_published"
      -              ]
      -            },
      -            "website": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            }
      -          },
      -          "required": [
      -            "school_id",
      -            "name",
      -            "area",
      -            "curricula",
      -            "rating",
      -            "academic_year",
      -            "annual_fee_range",
      -            "grade_fee_aed",
      -            "website",
      -            "source_url",
      -            "distance_km",
      -            "location_approximate",
      -            "bus",
      -            "uniforms_status",
      -            "open_in_browser",
      -            "provenance"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "fee_policy": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/SchoolFeePolicy"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "links": {
      -        "$ref": "#/$defs/Links"
      -      },
      -      "meta": {
      -        "$ref": "#/$defs/ResponseMeta"
      -      }
      -    },
      -    "required": [
      -      "meta",
      -      "data",
      -      "links"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "context": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "search": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "displayed_count": {
      -                "type": "integer"
      -              },
      -              "near": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "radius_km": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "remaining_count": {
      -                "type": "integer"
      -              },
      -              "returned_remaining_count": {
      -                "type": "integer"
      -              },
      -              "total_schools": {
      -                "type": "integer"
      -              },
      -              "unlocated": {
      -                "type": [
      -                  "integer",
      -                  "null"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "total_schools",
      -              "near",
      -              "radius_km",
      -              "unlocated"
      -            ],
      -            "type": "object"
      -          }
      -        },
      -        "required": [
      -          "search"
      -        ],
      -        "type": "object"
      -      },
      -      "data": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "academic_year": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "annual_fee_range": {
      -                "anyOf": [
      -                  {
      -                    "$ref": "#/$defs/AedRange"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "area": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "bus": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "academic_year": {
      -                        "type": "string"
      -                      },
      -                      "operator": {
      -                        "type": "string"
      -                      },
      -                      "source_url": {
      -                        "type": "string"
      -                      },
      -                      "zones": {
      -                        "items": {
      -                          "additionalProperties": false,
      -                          "properties": {
      -                            "annual_aed": {
      -                              "type": "number"
      -                            },
      -                            "areas": {
      -                              "items": {
      -                                "type": "string"
      -                              },
      -                              "type": "array"
      -                            },
      -                            "zone": {
      -                              "type": "integer"
      -                            }
      -                          },
      -                          "required": [
      -                            "zone",
      -                            "annual_aed",
      -                            "areas"
      -                          ],
      -                          "type": "object"
      -                        },
      -                        "type": "array"
      -                      }
      -                    },
      -                    "required": [
      -                      "operator",
      -                      "academic_year",
      -                      "zones",
      -                      "source_url"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "curricula": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "distance_km": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "fees": {
      -                "items": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "annual_fee_aed": {
      -                      "type": "number"
      -                    },
      -                    "grade": {
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "grade",
      -                    "annual_fee_aed"
      -                  ],
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              },
      -              "grade_fee_aed": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "location_approximate": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "name": {
      -                "type": "string"
      -              },
      -              "open_in_browser": {
      -                "type": "string"
      -              },
      -              "provenance": {
      -                "$ref": "#/$defs/Provenance"
      -              },
      -              "rating": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "school_id": {
      -                "type": "string"
      -              },
      -              "source_url": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "uniforms_status": {
      -                "enum": [
      -                  "available",
      -                  "paused",
      -                  "not_published"
      -                ]
      -              },
      -              "website": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "school_id",
      -              "name",
      -              "area",
      -              "curricula",
      -              "rating",
      -              "academic_year",
      -              "fees",
      -              "annual_fee_range",
      -              "grade_fee_aed",
      -              "website",
      -              "source_url",
      -              "distance_km",
      -              "location_approximate",
      -              "bus",
      -              "uniforms_status",
      -              "open_in_browser",
      -              "provenance"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "fee_policy": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/SchoolFeePolicy"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "links": {
      -        "$ref": "#/$defs/Links"
      -      },
      -      "meta": {
      -        "$ref": "#/$defs/ResponseMeta"
      -      }
      -    },
      -    "required": [
      -      "meta",
      -      "data",
      -      "links"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "code": {
      -            "type": "string"
      -          },
      -          "message": {
      -            "type": "string"
      -          },
      -          "retry_after_s": {
      -            "type": [
      -              "integer",
      -              "null"
      -            ]
      -          },
      -          "retryable": {
      -            "type": "boolean"
      -          }
      -        },
      -        "required": [
      -          "code",
      -          "message",
      -          "retryable",
      -          "retry_after_s"
      -        ],
      -        "type": "object"
      -      },
      -      "request_id": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "error",
      -      "request_id"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "context": {
      +        "$ref": "#/$defs/SchoolSearchContext"
      +      },
      +      "data": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "academic_year": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "annual_fee_range": {
      +              "anyOf": [
      +                {
      +                  "$ref": "#/$defs/AedRange"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "area": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "bus": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "academic_year": {
      +                      "type": "string"
      +                    },
      +                    "operator": {
      +                      "type": "string"
      +                    },
      +                    "source_url": {
      +                      "type": "string"
      +                    },
      +                    "zones": {
      +                      "items": {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "annual_aed": {
      +                            "type": "number"
      +                          },
      +                          "zone": {
      +                            "type": "integer"
      +                          }
      +                        },
      +                        "required": [
      +                          "zone",
      +                          "annual_aed"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    }
      +                  },
      +                  "required": [
      +                    "operator",
      +                    "academic_year",
      +                    "zones",
      +                    "source_url"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "curricula": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "distance_km": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "grade_fee_aed": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "location_approximate": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "name": {
      +              "type": "string"
      +            },
      +            "open_in_browser": {
      +              "type": "string"
      +            },
      +            "provenance": {
      +              "$ref": "#/$defs/Provenance"
      +            },
      +            "rating": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "school_id": {
      +              "type": "string"
      +            },
      +            "source_url": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "uniforms_status": {
      +              "enum": [
      +                "available",
      +                "paused",
      +                "not_published"
      +              ]
      +            },
      +            "website": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "school_id",
      +            "name",
      +            "area",
      +            "curricula",
      +            "rating",
      +            "academic_year",
      +            "annual_fee_range",
      +            "grade_fee_aed",
      +            "website",
      +            "source_url",
      +            "distance_km",
      +            "location_approximate",
      +            "bus",
      +            "uniforms_status",
      +            "open_in_browser",
      +            "provenance"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "fee_policy": {
      +        "$ref": "#/$defs/SchoolFeePolicySummary"
      +      },
      +      "links": {
      +        "$ref": "#/$defs/Links"
      +      },
      +      "meta": {
      +        "$ref": "#/$defs/ResponseMeta"
      +      }
      +    },
      +    "required": [
      +      "meta",
      +      "data",
      +      "links"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "context": {
      +        "$ref": "#/$defs/SchoolSearchContext"
      +      },
      +      "data": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "academic_year": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "annual_fee_range": {
      +                "anyOf": [
      +                  {
      +                    "$ref": "#/$defs/AedRange"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "area": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "bus": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "academic_year": {
      +                        "type": "string"
      +                      },
      +                      "operator": {
      +                        "type": "string"
      +                      },
      +                      "source_url": {
      +                        "type": "string"
      +                      },
      +                      "zones": {
      +                        "items": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "annual_aed": {
      +                              "type": "number"
      +                            },
      +                            "areas": {
      +                              "items": {
      +                                "type": "string"
      +                              },
      +                              "type": "array"
      +                            },
      +                            "zone": {
      +                              "type": "integer"
      +                            }
      +                          },
      +                          "required": [
      +                            "zone",
      +                            "annual_aed",
      +                            "areas"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "type": "array"
      +                      }
      +                    },
      +                    "required": [
      +                      "operator",
      +                      "academic_year",
      +                      "zones",
      +                      "source_url"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "curricula": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "distance_km": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "fees": {
      +                "items": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "annual_fee_aed": {
      +                      "type": "number"
      +                    },
      +                    "grade": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "grade",
      +                    "annual_fee_aed"
      +                  ],
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              "grade_fee_aed": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "location_approximate": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "name": {
      +                "type": "string"
      +              },
      +              "open_in_browser": {
      +                "type": "string"
      +              },
      +              "provenance": {
      +                "$ref": "#/$defs/Provenance"
      +              },
      +              "rating": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "school_id": {
      +                "type": "string"
      +              },
      +              "source_url": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "uniforms_status": {
      +                "enum": [
      +                  "available",
      +                  "paused",
      +                  "not_published"
      +                ]
      +              },
      +              "website": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "school_id",
      +              "name",
      +              "area",
      +              "curricula",
      +              "rating",
      +              "academic_year",
      +              "fees",
      +              "annual_fee_range",
      +              "grade_fee_aed",
      +              "website",
      +              "source_url",
      +              "distance_km",
      +              "location_approximate",
      +              "bus",
      +              "uniforms_status",
      +              "open_in_browser",
      +              "provenance"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "fee_policy": {
      +        "$ref": "#/$defs/SchoolFeePolicySummary"
      +      },
      +      "links": {
      +        "$ref": "#/$defs/Links"
      +      },
      +      "meta": {
      +        "$ref": "#/$defs/ResponseMeta"
      +      }
      +    },
      +    "required": [
      +      "meta",
      +      "data",
      +      "links"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "type": "string"
      +          },
      +          "message": {
      +            "type": "string"
      +          },
      +          "retry_after_s": {
      +            "type": [
      +              "integer",
      +              "null"
      +            ]
      +          },
      +          "retryable": {
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message",
      +          "retryable",
      +          "retry_after_s"
      +        ],
      +        "type": "object"
      +      },
      +      "request_id": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "error",
      +      "request_id"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed12 schema fields changed
    • removedInput schema / properties / radius_km / type
      Removed value: -"integer"
    • removedInput schema / properties / sort / type
      Removed value: -"string"
    • removedOutput schema / $defs / CompactSchool
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "academic_year": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "annual_fee_range": {
      -      "anyOf": [
      -        {
      -          "$ref": "#/$defs/AedRange"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "area": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "bus": {
      -      "anyOf": [
      -        {
      -          "$ref": "#/$defs/CompactSchoolBus"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "curricula": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "distance_km": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "grade_fee_aed": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "location_approximate": {
      -      "type": [
      -        "boolean",
      -        "null"
      -      ]
      -    },
      -    "name": {
      -      "type": "string"
      -    },
      -    "open_in_browser": {
      -      "type": "string"
      -    },
      -    "provenance": {
      -      "$ref": "#/$defs/Provenance"
      -    },
      -    "rating": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "school_id": {
      -      "type": "string"
      -    },
      -    "source_url": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "uniforms_status": {
      -      "enum": [
      -        "available",
      -        "paused",
      -        "not_published"
      -      ],
      -      "type": "string"
      -    },
      -    "website": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "required": [
      -    "school_id",
      -    "name",
      -    "area",
      -    "curricula",
      -    "rating",
      -    "academic_year",
      -    "annual_fee_range",
      -    "grade_fee_aed",
      -    "website",
      -    "source_url",
      -    "distance_km",
      -    "location_approximate",
      -    "bus",
      -    "uniforms_status",
      -    "open_in_browser",
      -    "provenance"
      -  ],
      -  "type": "object"
      -}
    • removedOutput schema / $defs / CompactSchoolBus
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "academic_year": {
      -      "type": "string"
      -    },
      -    "operator": {
      -      "type": "string"
      -    },
      -    "source_url": {
      -      "type": "string"
      -    },
      -    "zones": {
      -      "items": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "annual_aed": {
      -            "type": "number"
      -          },
      -          "zone": {
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "zone",
      -          "annual_aed"
      -        ],
      -        "type": "object"
      -      },
      -      "type": "array"
      -    }
      -  },
      -  "required": [
      -    "operator",
      -    "academic_year",
      -    "zones",
      -    "source_url"
      -  ],
      -  "type": "object"
      -}
    • removedOutput schema / $defs / CompactSchoolListResponse
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "context": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "search": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "displayed_count": {
      -              "type": "integer"
      -            },
      -            "near": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "radius_km": {
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "remaining_count": {
      -              "type": "integer"
      -            },
      -            "returned_remaining_count": {
      -              "type": "integer"
      -            },
      -            "total_schools": {
      -              "type": "integer"
      -            },
      -            "unlocated": {
      -              "type": [
      -                "integer",
      -                "null"
      -              ]
      -            }
      -          },
      -          "required": [
      -            "total_schools",
      -            "near",
      -            "radius_km",
      -            "unlocated"
      -          ],
      -          "type": "object"
      -        }
      -      },
      -      "required": [
      -        "search"
      -      ],
      -      "type": "object"
      -    },
      -    "data": {
      -      "items": {
      -        "$ref": "#/$defs/CompactSchool"
      -      },
      -      "type": "array"
      -    },
      -    "fee_policy": {
      -      "anyOf": [
      -        {
      -          "$ref": "#/$defs/SchoolFeePolicy"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "links": {
      -      "$ref": "#/$defs/Links"
      -    },
      -    "meta": {
      -      "$ref": "#/$defs/ResponseMeta"
      -    }
      -  },
      -  "required": [
      -    "meta",
      -    "data",
      -    "links"
      -  ],
      -  "type": "object"
      -}
    • removedOutput schema / $defs / GradeFee
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "annual_fee_aed": {
      -      "type": "number"
      -    },
      -    "grade": {
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "grade",
      -    "annual_fee_aed"
      -  ],
      -  "type": "object"
      -}
    • removedOutput schema / $defs / School
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "academic_year": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "annual_fee_range": {
      -      "anyOf": [
      -        {
      -          "$ref": "#/$defs/AedRange"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "area": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "bus": {
      -      "anyOf": [
      -        {
      -          "$ref": "#/$defs/SchoolBus"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "curricula": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "distance_km": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "fees": {
      -      "items": {
      -        "$ref": "#/$defs/GradeFee"
      -      },
      -      "type": "array"
      -    },
      -    "grade_fee_aed": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "location_approximate": {
      -      "type": [
      -        "boolean",
      -        "null"
      -      ]
      -    },
      -    "name": {
      -      "type": "string"
      -    },
      -    "open_in_browser": {
      -      "type": "string"
      -    },
      -    "provenance": {
      -      "$ref": "#/$defs/Provenance"
      -    },
      -    "rating": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "school_id": {
      -      "type": "string"
      -    },
      -    "source_url": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "uniforms_status": {
      -      "enum": [
      -        "available",
      -        "paused",
      -        "not_published"
      -      ],
      -      "type": "string"
      -    },
      -    "website": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "required": [
      -    "school_id",
      -    "name",
      -    "area",
      -    "curricula",
      -    "rating",
      -    "academic_year",
      -    "fees",
      -    "annual_fee_range",
      -    "grade_fee_aed",
      -    "website",
      -    "source_url",
      -    "distance_km",
      -    "location_approximate",
      -    "bus",
      -    "uniforms_status",
      -    "open_in_browser",
      -    "provenance"
      -  ],
      -  "type": "object"
      -}
    • removedOutput schema / $defs / SchoolBus
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "academic_year": {
      -      "type": "string"
      -    },
      -    "operator": {
      -      "type": "string"
      -    },
      -    "source_url": {
      -      "type": "string"
      -    },
      -    "zones": {
      -      "items": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "annual_aed": {
      -            "type": "number"
      -          },
      -          "areas": {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "zone": {
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "zone",
      -          "annual_aed",
      -          "areas"
      -        ],
      -        "type": "object"
      -      },
      -      "type": "array"
      -    }
      -  },
      -  "required": [
      -    "operator",
      -    "academic_year",
      -    "zones",
      -    "source_url"
      -  ],
      -  "type": "object"
      -}
    • removedOutput schema / $defs / SchoolFeePolicy / properties / rules / items / properties / kind / type
      Removed value: -"string"
    • removedOutput schema / $defs / SchoolResponse
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "context": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "search": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "displayed_count": {
      -              "type": "integer"
      -            },
      -            "near": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "radius_km": {
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "remaining_count": {
      -              "type": "integer"
      -            },
      -            "returned_remaining_count": {
      -              "type": "integer"
      -            },
      -            "total_schools": {
      -              "type": "integer"
      -            },
      -            "unlocated": {
      -              "type": [
      -                "integer",
      -                "null"
      -              ]
      -            }
      -          },
      -          "required": [
      -            "total_schools",
      -            "near",
      -            "radius_km",
      -            "unlocated"
      -          ],
      -          "type": "object"
      -        }
      -      },
      -      "required": [
      -        "search"
      -      ],
      -      "type": "object"
      -    },
      -    "data": {
      -      "anyOf": [
      -        {
      -          "$ref": "#/$defs/School"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "fee_policy": {
      -      "anyOf": [
      -        {
      -          "$ref": "#/$defs/SchoolFeePolicy"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "links": {
      -      "$ref": "#/$defs/Links"
      -    },
      -    "meta": {
      -      "$ref": "#/$defs/ResponseMeta"
      -    }
      -  },
      -  "required": [
      -    "meta",
      -    "data",
      -    "links"
      -  ],
      -  "type": "object"
      -}
    • removedOutput schema / $defs / ToolFailure
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "error": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "code": {
      -          "type": "string"
      -        },
      -        "message": {
      -          "type": "string"
      -        },
      -        "retry_after_s": {
      -          "type": [
      -            "integer",
      -            "null"
      -          ]
      -        },
      -        "retryable": {
      -          "type": "boolean"
      -        }
      -      },
      -      "required": [
      -        "code",
      -        "message",
      -        "retryable",
      -        "retry_after_s"
      -      ],
      -      "type": "object"
      -    },
      -    "request_id": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "required": [
      -    "error",
      -    "request_id"
      -  ],
      -  "type": "object"
      -}
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "$ref": "#/$defs/CompactSchoolListResponse"
      -  },
      -  {
      -    "$ref": "#/$defs/SchoolResponse"
      -  },
      -  {
      -    "$ref": "#/$defs/ToolFailure"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "context": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "search": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "displayed_count": {
      +                "type": "integer"
      +              },
      +              "near": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "radius_km": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "remaining_count": {
      +                "type": "integer"
      +              },
      +              "returned_remaining_count": {
      +                "type": "integer"
      +              },
      +              "total_schools": {
      +                "type": "integer"
      +              },
      +              "unlocated": {
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "total_schools",
      +              "near",
      +              "radius_km",
      +              "unlocated"
      +            ],
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "search"
      +        ],
      +        "type": "object"
      +      },
      +      "data": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "academic_year": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "annual_fee_range": {
      +              "anyOf": [
      +                {
      +                  "$ref": "#/$defs/AedRange"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "area": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "bus": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "academic_year": {
      +                      "type": "string"
      +                    },
      +                    "operator": {
      +                      "type": "string"
      +                    },
      +                    "source_url": {
      +                      "type": "string"
      +                    },
      +                    "zones": {
      +                      "items": {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "annual_aed": {
      +                            "type": "number"
      +                          },
      +                          "zone": {
      +                            "type": "integer"
      +                          }
      +                        },
      +                        "required": [
      +                          "zone",
      +                          "annual_aed"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    }
      +                  },
      +                  "required": [
      +                    "operator",
      +                    "academic_year",
      +                    "zones",
      +                    "source_url"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "curricula": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "distance_km": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "grade_fee_aed": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "location_approximate": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "name": {
      +              "type": "string"
      +            },
      +            "open_in_browser": {
      +              "type": "string"
      +            },
      +            "provenance": {
      +              "$ref": "#/$defs/Provenance"
      +            },
      +            "rating": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "school_id": {
      +              "type": "string"
      +            },
      +            "source_url": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "uniforms_status": {
      +              "enum": [
      +                "available",
      +                "paused",
      +                "not_published"
      +              ]
      +            },
      +            "website": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "school_id",
      +            "name",
      +            "area",
      +            "curricula",
      +            "rating",
      +            "academic_year",
      +            "annual_fee_range",
      +            "grade_fee_aed",
      +            "website",
      +            "source_url",
      +            "distance_km",
      +            "location_approximate",
      +            "bus",
      +            "uniforms_status",
      +            "open_in_browser",
      +            "provenance"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "fee_policy": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/SchoolFeePolicy"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "links": {
      +        "$ref": "#/$defs/Links"
      +      },
      +      "meta": {
      +        "$ref": "#/$defs/ResponseMeta"
      +      }
      +    },
      +    "required": [
      +      "meta",
      +      "data",
      +      "links"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "context": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "search": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "displayed_count": {
      +                "type": "integer"
      +              },
      +              "near": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "radius_km": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "remaining_count": {
      +                "type": "integer"
      +              },
      +              "returned_remaining_count": {
      +                "type": "integer"
      +              },
      +              "total_schools": {
      +                "type": "integer"
      +              },
      +              "unlocated": {
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "total_schools",
      +              "near",
      +              "radius_km",
      +              "unlocated"
      +            ],
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "search"
      +        ],
      +        "type": "object"
      +      },
      +      "data": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "academic_year": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "annual_fee_range": {
      +                "anyOf": [
      +                  {
      +                    "$ref": "#/$defs/AedRange"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "area": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "bus": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "academic_year": {
      +                        "type": "string"
      +                      },
      +                      "operator": {
      +                        "type": "string"
      +                      },
      +                      "source_url": {
      +                        "type": "string"
      +                      },
      +                      "zones": {
      +                        "items": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "annual_aed": {
      +                              "type": "number"
      +                            },
      +                            "areas": {
      +                              "items": {
      +                                "type": "string"
      +                              },
      +                              "type": "array"
      +                            },
      +                            "zone": {
      +                              "type": "integer"
      +                            }
      +                          },
      +                          "required": [
      +                            "zone",
      +                            "annual_aed",
      +                            "areas"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "type": "array"
      +                      }
      +                    },
      +                    "required": [
      +                      "operator",
      +                      "academic_year",
      +                      "zones",
      +                      "source_url"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "curricula": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "distance_km": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "fees": {
      +                "items": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "annual_fee_aed": {
      +                      "type": "number"
      +                    },
      +                    "grade": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "grade",
      +                    "annual_fee_aed"
      +                  ],
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              "grade_fee_aed": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "location_approximate": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "name": {
      +                "type": "string"
      +              },
      +              "open_in_browser": {
      +                "type": "string"
      +              },
      +              "provenance": {
      +                "$ref": "#/$defs/Provenance"
      +              },
      +              "rating": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "school_id": {
      +                "type": "string"
      +              },
      +              "source_url": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "uniforms_status": {
      +                "enum": [
      +                  "available",
      +                  "paused",
      +                  "not_published"
      +                ]
      +              },
      +              "website": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "school_id",
      +              "name",
      +              "area",
      +              "curricula",
      +              "rating",
      +              "academic_year",
      +              "fees",
      +              "annual_fee_range",
      +              "grade_fee_aed",
      +              "website",
      +              "source_url",
      +              "distance_km",
      +              "location_approximate",
      +              "bus",
      +              "uniforms_status",
      +              "open_in_browser",
      +              "provenance"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "fee_policy": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/SchoolFeePolicy"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "links": {
      +        "$ref": "#/$defs/Links"
      +      },
      +      "meta": {
      +        "$ref": "#/$defs/ResponseMeta"
      +      }
      +    },
      +    "required": [
      +      "meta",
      +      "data",
      +      "links"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "type": "string"
      +          },
      +          "message": {
      +            "type": "string"
      +          },
      +          "retry_after_s": {
      +            "type": [
      +              "integer",
      +              "null"
      +            ]
      +          },
      +          "retryable": {
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message",
      +          "retryable",
      +          "retry_after_s"
      +        ],
      +        "type": "object"
      +      },
      +      "request_id": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "error",
      +      "request_id"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. Added

TDQS

B3.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish read-only, idempotent, non-destructive behavior, so the safety burden is offloaded. The description adds genuinely useful non-schema context — the KHDA source, that uniform data is currently paused, and the year/grade distinction. It says nothing about pagination via cursor or result limits, which is the remaining behavioral gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Very short and front-loaded: domain first, then parameter hints, then caveats. The telegraphic fragment style ('uniforms paused') saves space but slightly sacrifices clarity, and 'bus fees, distance' is awkwardly spliced into the domain sentence.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values are covered, but for a 12-parameter, 0-required query tool with 17% schema coverage the description is far too sparse. Most filters and the pagination parameter are left for the agent to infer from bare property names.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 17% across 12 parameters, so the description must carry the load but does not. It clarifies only q, near (zone, not school), and school_id (detail mode), while area, sort, grade, cursor, rating, page_size, radius_km, curriculum, and max_fee_aed are undocumented in both schema and description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a concrete resource and data domain: Dubai (KHDA) school fees, tuition by grade/year, bus fees, distance. There is no sibling school tool in the list, so no explicit differentiation is needed, but the tool's own action ('look up/report school fees') is only implied by the noun phrase rather than stated with a verb.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives parameter-selection hints ('q: school name; near: zone; school_id: detail') and two important caveats ('Year ≠ Grade', 'uniforms paused'), which imply usage. However, it never states when to use this tool versus another, nor explains how the parameter modes interact (e.g. that school_id returns detail and conflicts with list-style filtering).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources