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 (JVC). Year ≠ Grade; uniforms paused.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "schools"
  }
}

Input 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

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • removedOutput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
  2. Changed1 schema field changed
    • removedInput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
  3. 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"
      +  }
      +]
  4. 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"
      +  }
      +]
  5. Added

TDQS

B3.3/5.0
Behavior3/5

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

Annotations already declare the safe read-only, idempotent, closed-world profile, so the bar is lower. The description does add unique data caveats ('Year ≠ Grade', 'uniforms paused') that annotations cannot express, but they are so terse that the agent cannot tell whether uniform fees are omitted entirely or just not yet returned.

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

Conciseness3/5

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

It is compact and front-loads the domain, but the telegraphic style ('Year ≠ Grade; uniforms paused') leaves dangling fragments that cost more in inference than they save in tokens. No structural separation between data scope and parameter hints.

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

Completeness5/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 need not be described.

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 carries the burden and largely fails: it explains only q and near (near duplicating the schema's own 'Zone, not school.'), plus loose hints at grade, distance and fees. Nothing explains area, rating, curriculum, school_id, sort, cursor, page_size, radius_km, or max_fee_aed.

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?

States a specific resource and payload: Dubai school fees, KHDA tuition by grade/year, bus fees, distance. An agent immediately knows this is a school-fee lookup rather than a generic calculator, though no sibling (e.g. costs_by_area, commute_cost) is named to disambiguate.

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?

Usage is implied by the data enumerated (tuition by grade, bus fees, distance), and the 'q: school name; near: zone (JVC)' note hints at two lookup modes. But there is no explicit when-to-use/when-not, no prerequisites, and no pointer to alternatives for distance or area cost questions.

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