Brainy Prices — UAE Cost of Living

housing_sales

Read-onlyIdempotent

Sale prices by Dubai area: ready/off-plan registered medians. Not listings.

Input Schema

Name	Required	Default
`sort`	No	median_price_aed
`zone`	No
`cursor`	No
`market`	No
`zone_id`	No
`bedrooms`	No
`page_size`	No
`property_type`	No

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 30, 2026
- removedOutput schema / $schema
```
Removed value: -"https://json-schema.org/draft/2020-12/schema"
```
Changed1 schema field changedOct 13, 2026
- removedInput schema / $schema
```
Removed value: -"https://json-schema.org/draft/2020-12/schema"
```

Changed4 schema fields changedOct 6, 2026

removedOutput schema / $defs / Provenance

Removed value: -{
-  "additionalProperties": true,
-  "required": [
-    "source_id",
-    "license_id",
-    "source_url",
-    "observed_on",
-    "observed_at",
-    "published_on",
-    "published_at",
-    "retrieved_at",
-    "stale",
-    "status",
-    "paused_since",
-    "flags"
-  ],
-  "type": "object"
-}

removedOutput schema / $defs / RentSplit

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "contracts": {
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "median_annual_aed": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "p25_annual_aed": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "p75_annual_aed": {
-      "type": [
-        "number",
-        "null"
-      ]
-    }
-  },
-  "required": [
-    "contracts",
-    "median_annual_aed",
-    "p25_annual_aed",
-    "p75_annual_aed"
-  ],
-  "type": "object"
-}

removedOutput schema / $defs / SaleMedian

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "bedrooms": {
-      "type": "integer"
-    },
-    "market": {
-      "enum": [
-        "ready",
-        "off_plan"
-      ]
-    },
-    "median_aed_per_sqft": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "median_price_aed": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "p25_aed_per_sqft": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "p25_price_aed": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "p75_aed_per_sqft": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "p75_price_aed": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "property_type": {
-      "enum": [
-        "apartment",
-        "villa"
-      ]
-    },
-    "provenance": {
-      "$ref": "#/$defs/Provenance"
-    },
-    "transactions": {
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "zone_id": {
-      "type": "string"
-    },
-    "zone_name": {
-      "type": "string"
-    }
-  },
-  "required": [
-    "zone_id",
-    "zone_name",
-    "property_type",
-    "bedrooms",
-    "market",
-    "transactions",
-    "median_price_aed",
-    "p25_price_aed",
-    "p75_price_aed",
-    "median_aed_per_sqft",
-    "p25_aed_per_sqft",
-    "p75_aed_per_sqft",
-    "provenance"
-  ],
-  "type": "object"
-}

changedOutput schema / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "context": {
-        "additionalProperties": false,
-        "properties": {
-          "rents": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "bedrooms": {
-                  "type": "integer"
-                },
-                "contracts": {
-                  "type": "integer"
-                },
-                "display_monthly_aed": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "median_annual_aed": {
-                  "type": "number"
-                },
-                "median_monthly_aed": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "new_contracts": {
-                  "anyOf": [
-                    {
-                      "$ref": "#/$defs/RentSplit"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "p25_annual_aed": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "p75_annual_aed": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "property_type": {
-                  "enum": [
-                    "apartment",
-                    "villa"
-                  ]
-                },
-                "provenance": {
-                  "$ref": "#/$defs/Provenance"
-                },
-                "renewals": {
-                  "anyOf": [
-                    {
-                      "$ref": "#/$defs/RentSplit"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "zone_id": {
-                  "type": "string"
-                },
-                "zone_name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "zone_id",
-                "zone_name",
-                "property_type",
-                "bedrooms",
-                "contracts",
-                "median_annual_aed",
-                "p25_annual_aed",
-                "p75_annual_aed",
-                "median_monthly_aed",
-                "new_contracts",
-                "renewals",
-                "provenance"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "sales": {
-            "items": {
-              "$ref": "#/$defs/SaleMedian"
-            },
-            "type": "array"
-          },
-          "zone": {
-            "additionalProperties": false,
-            "properties": {
-              "communities": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "communities_ar": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "name": {
-                "type": "string"
-              },
-              "name_ar": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "open_in_browser": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "provenance": {
-                "$ref": "#/$defs/Provenance"
-              },
-              "rent_contracts": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              },
-              "sale_transactions": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              },
-              "zone_id": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "zone_id",
-              "name",
-              "name_ar",
-              "communities",
-              "communities_ar",
-              "rent_contracts",
-              "sale_transactions",
-              "open_in_browser",
-              "provenance"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "zone",
-          "rents",
-          "sales"
-        ],
-        "type": "object"
-      },
-      "data": {
-        "items": {
-          "$ref": "#/$defs/SaleMedian"
-        },
-        "type": "array"
-      },
-      "links": {
-        "additionalProperties": false,
-        "properties": {
-          "docs": {
-            "type": "string"
-          },
-          "next": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "open_in_browser": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "self": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "self",
-          "next",
-          "open_in_browser",
-          "docs"
-        ],
-        "type": "object"
-      },
-      "meta": {
-        "additionalProperties": true,
-        "required": [
-          "api_version",
-          "content_language",
-          "generated_at",
-          "currency",
-          "attribution",
-          "disclaimer",
-          "dataset",
-          "page"
-        ],
-        "type": "object"
-      }
-    },
-    "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": {
+        "additionalProperties": true,
+        "required": [
+          "zone",
+          "rents",
+          "sales"
+        ],
+        "type": "object"
+      },
+      "data": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "bedrooms": {
+              "type": "integer"
+            },
+            "market": {
+              "enum": [
+                "ready",
+                "off_plan"
+              ]
+            },
+            "median_aed_per_sqft": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "median_price_aed": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "p25_aed_per_sqft": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "p25_price_aed": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "p75_aed_per_sqft": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "p75_price_aed": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "property_type": {
+              "enum": [
+                "apartment",
+                "villa"
+              ]
+            },
+            "provenance": {
+              "additionalProperties": true,
+              "required": [
+                "source_id",
+                "license_id",
+                "source_url",
+                "observed_on",
+                "observed_at",
+                "published_on",
+                "published_at",
+                "retrieved_at",
+                "stale",
+                "status",
+                "paused_since",
+                "flags"
+              ],
+              "type": "object"
+            },
+            "transactions": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "zone_id": {
+              "type": "string"
+            },
+            "zone_name": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "zone_id",
+            "zone_name",
+            "property_type",
+            "bedrooms",
+            "market",
+            "transactions",
+            "median_price_aed",
+            "p25_price_aed",
+            "p75_price_aed",
+            "median_aed_per_sqft",
+            "p25_aed_per_sqft",
+            "p75_aed_per_sqft",
+            "provenance"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "links": {
+        "additionalProperties": false,
+        "properties": {
+          "docs": {
+            "type": "string"
+          },
+          "next": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "open_in_browser": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "self": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "self",
+          "next",
+          "open_in_browser",
+          "docs"
+        ],
+        "type": "object"
+      },
+      "meta": {
+        "additionalProperties": true,
+        "required": [
+          "api_version",
+          "content_language",
+          "generated_at",
+          "currency",
+          "attribution",
+          "disclaimer",
+          "dataset",
+          "page"
+        ],
+        "type": "object"
+      }
+    },
+    "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"
+  }
+]

Changed12 schema fields changedOct 6, 2026

removedInput schema / properties / market / type
```
Removed value: -"string"
```
removedInput schema / properties / property_type / type
```
Removed value: -"string"
```
removedInput schema / properties / sort / type
```
Removed value: -"string"
```

removedOutput schema / $defs / HousingZone

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "communities": {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "communities_ar": {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "name": {
-      "type": "string"
-    },
-    "name_ar": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "open_in_browser": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "provenance": {
-      "$ref": "#/$defs/Provenance"
-    },
-    "rent_contracts": {
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "sale_transactions": {
-      "type": [
-        "integer",
-        "null"
-      ]
-    },
-    "zone_id": {
-      "type": "string"
-    }
-  },
-  "required": [
-    "zone_id",
-    "name",
-    "name_ar",
-    "communities",
-    "communities_ar",
-    "rent_contracts",
-    "sale_transactions",
-    "open_in_browser",
-    "provenance"
-  ],
-  "type": "object"
-}

removedOutput schema / $defs / Links

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "docs": {
-      "type": "string"
-    },
-    "next": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "open_in_browser": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "self": {
-      "type": "string"
-    }
-  },
-  "required": [
-    "self",
-    "next",
-    "open_in_browser",
-    "docs"
-  ],
-  "type": "object"
-}

removedOutput schema / $defs / RentMedian

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "bedrooms": {
-      "type": "integer"
-    },
-    "contracts": {
-      "type": "integer"
-    },
-    "display_monthly_aed": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "median_annual_aed": {
-      "type": "number"
-    },
-    "median_monthly_aed": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "new_contracts": {
-      "anyOf": [
-        {
-          "$ref": "#/$defs/RentSplit"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "p25_annual_aed": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "p75_annual_aed": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "property_type": {
-      "enum": [
-        "apartment",
-        "villa"
-      ],
-      "type": "string"
-    },
-    "provenance": {
-      "$ref": "#/$defs/Provenance"
-    },
-    "renewals": {
-      "anyOf": [
-        {
-          "$ref": "#/$defs/RentSplit"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "zone_id": {
-      "type": "string"
-    },
-    "zone_name": {
-      "type": "string"
-    }
-  },
-  "required": [
-    "zone_id",
-    "zone_name",
-    "property_type",
-    "bedrooms",
-    "contracts",
-    "median_annual_aed",
-    "p25_annual_aed",
-    "p75_annual_aed",
-    "median_monthly_aed",
-    "new_contracts",
-    "renewals",
-    "provenance"
-  ],
-  "type": "object"
-}

removedOutput schema / $defs / ResponseMeta

Removed value: -{
-  "additionalProperties": true,
-  "required": [
-    "api_version",
-    "content_language",
-    "generated_at",
-    "currency",
-    "attribution",
-    "disclaimer",
-    "dataset",
-    "page"
-  ],
-  "type": "object"
-}

removedOutput schema / $defs / SaleMedian / properties / market / type
```
Removed value: -"string"
```
removedOutput schema / $defs / SaleMedian / properties / property_type / type
```
Removed value: -"string"
```

removedOutput schema / $defs / SaleMedianListResponse

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "context": {
-      "additionalProperties": false,
-      "properties": {
-        "rents": {
-          "items": {
-            "$ref": "#/$defs/RentMedian"
-          },
-          "type": "array"
-        },
-        "sales": {
-          "items": {
-            "$ref": "#/$defs/SaleMedian"
-          },
-          "type": "array"
-        },
-        "zone": {
-          "$ref": "#/$defs/HousingZone"
-        }
-      },
-      "required": [
-        "zone",
-        "rents",
-        "sales"
-      ],
-      "type": "object"
-    },
-    "data": {
-      "items": {
-        "$ref": "#/$defs/SaleMedian"
-      },
-      "type": "array"
-    },
-    "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/SaleMedianListResponse"
-  },
-  {
-    "$ref": "#/$defs/ToolFailure"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "context": {
+        "additionalProperties": false,
+        "properties": {
+          "rents": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "bedrooms": {
+                  "type": "integer"
+                },
+                "contracts": {
+                  "type": "integer"
+                },
+                "display_monthly_aed": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "median_annual_aed": {
+                  "type": "number"
+                },
+                "median_monthly_aed": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "new_contracts": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/$defs/RentSplit"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "p25_annual_aed": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "p75_annual_aed": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "property_type": {
+                  "enum": [
+                    "apartment",
+                    "villa"
+                  ]
+                },
+                "provenance": {
+                  "$ref": "#/$defs/Provenance"
+                },
+                "renewals": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/$defs/RentSplit"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "zone_id": {
+                  "type": "string"
+                },
+                "zone_name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "zone_id",
+                "zone_name",
+                "property_type",
+                "bedrooms",
+                "contracts",
+                "median_annual_aed",
+                "p25_annual_aed",
+                "p75_annual_aed",
+                "median_monthly_aed",
+                "new_contracts",
+                "renewals",
+                "provenance"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "sales": {
+            "items": {
+              "$ref": "#/$defs/SaleMedian"
+            },
+            "type": "array"
+          },
+          "zone": {
+            "additionalProperties": false,
+            "properties": {
+              "communities": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "communities_ar": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "name": {
+                "type": "string"
+              },
+              "name_ar": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "open_in_browser": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "provenance": {
+                "$ref": "#/$defs/Provenance"
+              },
+              "rent_contracts": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "sale_transactions": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "zone_id": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "zone_id",
+              "name",
+              "name_ar",
+              "communities",
+              "communities_ar",
+              "rent_contracts",
+              "sale_transactions",
+              "open_in_browser",
+              "provenance"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "zone",
+          "rents",
+          "sales"
+        ],
+        "type": "object"
+      },
+      "data": {
+        "items": {
+          "$ref": "#/$defs/SaleMedian"
+        },
+        "type": "array"
+      },
+      "links": {
+        "additionalProperties": false,
+        "properties": {
+          "docs": {
+            "type": "string"
+          },
+          "next": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "open_in_browser": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "self": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "self",
+          "next",
+          "open_in_browser",
+          "docs"
+        ],
+        "type": "object"
+      },
+      "meta": {
+        "additionalProperties": true,
+        "required": [
+          "api_version",
+          "content_language",
+          "generated_at",
+          "currency",
+          "attribution",
+          "disclaimer",
+          "dataset",
+          "page"
+        ],
+        "type": "object"
+      }
+    },
+    "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"
+  }
+]

AddedOct 4, 2026

TDQS

B3.2/5.0

Behavior3/5

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

Annotations already establish that this is a read-only, idempotent, non-destructive operation with no open-world access. The description adds useful data semantics by saying these are registered medians and not listings, but it omits pagination, cursor, and sorting behavior beyond what annotations provide.

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

Conciseness5/5

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

Two short sentences, front-loaded with the key distinction and no wasted wording. The exclusion is compact and useful.

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?

Although an output schema exists and annotations cover safety, the tool has 8 parameters with zero schema descriptions. The description does not explain sorting, pagination, filtering by bedrooms/property type, or cursor usage, leaving too much for an agent to infer.

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 0%, so the description must compensate for 8 undocumented parameters. It only implicitly covers zone ('by Dubai area') and market ('ready/off-plan'); it says nothing about sort, cursor, page_size, bedrooms, or property_type.

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 identifies the resource and scope precisely: Dubai-area sale prices, split into ready/off-plan registered medians. 'Not listings' clarifies what the tool is not, though it does not explicitly name the closest sibling, housing_rents.

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 a useful exclusion ('Not listings'), implying this is for aggregated registered sales data rather than active listings. However, it does not say when to use this instead of housing_rents or costs_by_area, nor does it explain any prerequisites.

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

All Brainy Prices — UAE Cost of Living tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?