Rafid Intelligence Network

analyze_oman_property

Read-onlyIdempotent

Analyze an Oman residential property using local rental comparables, market context and investment metrics, including partner-supplied historical and recent Al Mouj Muscat property sales records with provenance and freshness metadata when coverage is available. When: Use when an agent needs Oman-specific rental, yield, sale price positioning or operating-cost analysis, especially for an Al Mouj Muscat property. Selection: primary; prefer for Oman-specific property analysis with local comparables or Al Mouj or Muscat rental and sale positioning. Do not use for a property outside the supported Oman market or a simple yield calculation with supplied numbers. Input is a strict JSON object; see the schema. Price: $0.25 USD per call. A free preview is available through preview_capability before payment. Full execution is paid per call via x402; an unpaid MCP call returns payment instructions.

Input Schema

Name	Required	Description	Default
`area`	Yes
`sizeSqm`	Yes
`wilayat`	No
`bedrooms`	No
`bathrooms`	No
`furnished`	No
`governorate`	Yes
`propertyType`	Yes
`askingPriceOMR`	Yes
`optionalAnnualMaintenanceOMR`	No
`optionalAnnualServiceChargeOMR`	No

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedNov 1, 2026

removedOutput schema / additionalProperties
```
Removed value: -false
```

addedOutput schema / anyOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "assumptions": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "comparablesSummary": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "highRentPerSqm": {
+                "type": "number"
+              },
+              "lowRentPerSqm": {
+                "type": "number"
+              },
+              "medianRentPerSqm": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "medianRentPerSqm",
+              "lowRentPerSqm",
+              "highRentPerSqm"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "confidence": {
+        "additionalProperties": false,
+        "properties": {
+          "level": {
+            "enum": [
+              "insufficient",
+              "low",
+              "medium",
+              "high"
+            ],
+            "type": "string"
+          },
+          "reasons": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "score": {
+            "maximum": 1,
+            "minimum": 0,
+            "type": "number"
+          }
+        },
+        "required": [
+          "score",
+          "level",
+          "reasons"
+        ],
+        "type": "object"
+      },
+      "currency": {
+        "const": "OMR",
+        "type": "string"
+      },
+      "dataQuality": {
+        "additionalProperties": false,
+        "properties": {
+          "dataFreshnessDays": {
+            "anyOf": [
+              {
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "latestDataDate": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "sampleSize": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          "sourceTypes": {
+            "items": {
+              "enum": [
+                "official_statistics",
+                "listing_asking_price",
+                "manual_benchmark",
+                "partner_feed"
+              ],
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "staleMarketData": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "latestDataDate",
+          "dataFreshnessDays",
+          "sampleSize",
+          "sourceTypes",
+          "staleMarketData"
+        ],
+        "type": "object"
+      },
+      "historicalSalesContext": {
+        "additionalProperties": false,
+        "properties": {
+          "available": {
+            "type": "boolean"
+          },
+          "latestRecordDate": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "medianHistoricalPricePerSqmOMR": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "oldestRecordDate": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "phaseBreakdown": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "latestRecordDate": {
+                  "type": "string"
+                },
+                "medianPriceOMR": {
+                  "type": "number"
+                },
+                "medianPricePerSqmOMR": {
+                  "type": "number"
+                },
+                "oldestRecordDate": {
+                  "type": "string"
+                },
+                "phaseName": {
+                  "type": "string"
+                },
+                "recordCount": {
+                  "maximum": 9007199254740991,
+                  "minimum": -9007199254740991,
+                  "type": "integer"
+                }
+              },
+              "required": [
+                "phaseName",
+                "recordCount",
+                "medianPriceOMR",
+                "medianPricePerSqmOMR",
+                "oldestRecordDate",
+                "latestRecordDate"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "priceSemantics": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "recentComparableSales": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          "recentMedianPricePerSqmOMR": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "recordsAvailable": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          "sourceTypes": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "available",
+          "recordsAvailable",
+          "recentComparableSales",
+          "medianHistoricalPricePerSqmOMR",
+          "recentMedianPricePerSqmOMR",
+          "oldestRecordDate",
+          "latestRecordDate",
+          "sourceTypes",
+          "priceSemantics",
+          "phaseBreakdown"
+        ],
+        "type": "object"
+      },
+      "insufficientMarketData": {
+        "type": "boolean"
+      },
+      "investment": {
+        "additionalProperties": false,
+        "properties": {
+          "estimatedNetIncomeOMR": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "estimatedOperatingCostOMR": {
+            "type": "number"
+          },
+          "grossYieldPct": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "netYieldPct": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "grossYieldPct",
+          "estimatedOperatingCostOMR",
+          "estimatedNetIncomeOMR",
+          "netYieldPct"
+        ],
+        "type": "object"
+      },
+      "market": {
+        "additionalProperties": false,
+        "properties": {
+          "comparableCount": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          "dataFreshnessDays": {
+            "anyOf": [
+              {
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "estimatedAnnualRentOMR": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "estimatedMonthlyRentOMR": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "high": {
+                    "type": "number"
+                  },
+                  "low": {
+                    "type": "number"
+                  },
+                  "median": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "low",
+                  "median",
+                  "high"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "sampleSizeUsed": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "estimatedMonthlyRentOMR",
+          "estimatedAnnualRentOMR",
+          "comparableCount",
+          "sampleSizeUsed",
+          "dataFreshnessDays"
+        ],
+        "type": "object"
+      },
+      "normalizedLocation": {
+        "additionalProperties": false,
+        "properties": {
+          "area": {
+            "type": "string"
+          },
+          "governorate": {
+            "type": "string"
+          },
+          "inputArea": {
+            "type": "string"
+          },
+          "matchType": {
+            "enum": [
+              "exact",
+              "alias",
+              "unmatched"
+            ],
+            "type": "string"
+          },
+          "supported": {
+            "type": "boolean"
+          },
+          "wilayat": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "governorate",
+          "wilayat",
+          "area",
+          "inputArea",
+          "matchType",
+          "supported"
+        ],
+        "type": "object"
+      },
+      "officialMarketContext": {
+        "additionalProperties": false,
+        "properties": {
+          "available": {
+            "type": "boolean"
+          },
+          "confidence": {
+            "additionalProperties": false,
+            "properties": {
+              "level": {
+                "enum": [
+                  "unavailable",
+                  "low",
+                  "medium",
+                  "high"
+                ],
+                "type": "string"
+              },
+              "reasons": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "level",
+              "reasons"
+            ],
+            "type": "object"
+          },
+          "dataFreshnessDays": {
+            "anyOf": [
+              {
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "governorate": {
+            "type": "string"
+          },
+          "marketActivity": {
+            "additionalProperties": false,
+            "properties": {
+              "mortgageContracts": {
+                "anyOf": [
+                  {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "saleContracts": {
+                "anyOf": [
+                  {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "tradedValueOMR": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "tradedValueOMR",
+              "saleContracts",
+              "mortgageContracts"
+            ],
+            "type": "object"
+          },
+          "period": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "provenance": {
+            "additionalProperties": false,
+            "properties": {
+              "datasetId": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "datasetTitle": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "license": {
+                "type": "string"
+              },
+              "publishedAt": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "retrievedAt": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source": {
+                "type": "string"
+              },
+              "sourceType": {
+                "const": "official_statistics",
+                "type": "string"
+              },
+              "sourceUrl": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "source",
+              "sourceType",
+              "datasetId",
+              "datasetTitle",
+              "retrievedAt",
+              "publishedAt",
+              "sourceUrl",
+              "license"
+            ],
+            "type": "object"
+          },
+          "realEstatePriceIndex": {
+            "additionalProperties": false,
+            "properties": {
+              "period": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "value": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "value",
+              "period"
+            ],
+            "type": "object"
+          },
+          "reason": {
+            "anyOf": [
+              {
+                "enum": [
+                  "ncsi_not_configured",
+                  "no_data_for_governorate",
+                  "ncsi_timeout",
+                  "ncsi_malformed_response",
+                  "official_source_temporarily_unavailable"
+                ],
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "source": {
+            "type": "string"
+          },
+          "sourceType": {
+            "const": "official_statistics",
+            "type": "string"
+          }
+        },
+        "required": [
+          "available",
+          "reason",
+          "source",
+          "sourceType",
+          "governorate",
+          "period",
+          "realEstatePriceIndex",
+          "marketActivity",
+          "dataFreshnessDays",
+          "confidence",
+          "provenance"
+        ],
+        "type": "object"
+      },
+      "pricePosition": {
+        "additionalProperties": false,
+        "properties": {
+          "askingPricePerSqmOMR": {
+            "type": "number"
+          },
+          "marketPosition": {
+            "enum": [
+              "below_market",
+              "at_market",
+              "above_market",
+              "insufficient_data"
+            ],
+            "type": "string"
+          },
+          "observedComparableRange": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "high": {
+                    "type": "number"
+                  },
+                  "low": {
+                    "type": "number"
+                  },
+                  "median": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "low",
+                  "median",
+                  "high"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "askingPricePerSqmOMR",
+          "observedComparableRange",
+          "marketPosition"
+        ],
+        "type": "object"
+      },
+      "provenance": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "recordCount": {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            },
+            "sourceDate": {
+              "type": "string"
+            },
+            "sourceName": {
+              "type": "string"
+            },
+            "sourceType": {
+              "enum": [
+                "official_statistics",
+                "listing_asking_price",
+                "manual_benchmark",
+                "partner_feed"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "sourceType",
+            "sourceName",
+            "sourceDate",
+            "recordCount"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "riskFlags": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "subjectProperty": {
+        "additionalProperties": false,
+        "properties": {
+          "askingPriceOMR": {
+            "type": "number"
+          },
+          "bathrooms": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "bedrooms": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "furnished": {
+            "enum": [
+              "furnished",
+              "semi_furnished",
+              "unfurnished",
+              "unspecified"
+            ],
+            "type": "string"
+          },
+          "propertyType": {
+            "enum": [
+              "apartment",
+              "villa",
+              "townhouse"
+            ],
+            "type": "string"
+          },
+          "sizeSqm": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "propertyType",
+          "bedrooms",
+          "bathrooms",
+          "sizeSqm",
+          "askingPriceOMR",
+          "furnished"
+        ],
+        "type": "object"
+      },
+      "unavailableOutputs": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "normalizedLocation",
+      "subjectProperty",
+      "market",
+      "investment",
+      "pricePosition",
+      "comparablesSummary",
+      "riskFlags",
+      "confidence",
+      "provenance",
+      "assumptions",
+      "insufficientMarketData",
+      "unavailableOutputs",
+      "currency",
+      "dataQuality",
+      "historicalSalesContext",
+      "officialMarketContext"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "nextAction": {
+        "additionalProperties": false,
+        "properties": {
+          "instruction": {
+            "type": "string"
+          },
+          "target": {
+            "enum": [
+              "x402_endpoint",
+              "mcp_credits_endpoint",
+              "payment_endpoint",
+              "unavailable"
+            ],
+            "type": "string"
+          },
+          "type": {
+            "enum": [
+              "pay_and_retry",
+              "authorize_and_use_mcp_credits",
+              "payment_unavailable"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "target",
+          "instruction"
+        ],
+        "type": "object"
+      },
+      "payment": {
+        "additionalProperties": false,
+        "properties": {
+          "endpoint": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "method": {
+            "const": "POST",
+            "type": "string"
+          },
+          "retrySameBody": {
+            "const": true,
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "endpoint",
+          "method",
+          "retrySameBody"
+        ],
+        "type": "object"
+      },
+      "paymentGuidance": {},
+      "preview": {
+        "additionalProperties": false,
+        "properties": {
+          "fullResultAvailable": {
+            "const": true,
+            "type": "boolean"
+          },
+          "inputAccepted": {
+            "const": true,
+            "type": "boolean"
+          },
+          "summary": {
+            "type": "string"
+          },
+          "useCases": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "inputAccepted",
+          "fullResultAvailable",
+          "summary",
+          "useCases"
+        ],
+        "type": "object"
+      },
+      "price": {
+        "additionalProperties": false,
+        "properties": {
+          "amount": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "currency": {
+            "type": "string"
+          },
+          "protocol": {
+            "enum": [
+              "x402",
+              "api_credits",
+              "subscription",
+              "l402",
+              "mpp",
+              "unavailable"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "amount",
+          "currency",
+          "protocol"
+        ],
+        "type": "object"
+      },
+      "requestId": {
+        "type": "string"
+      },
+      "status": {
+        "const": "payment_required",
+        "type": "string"
+      },
+      "tool": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "tool",
+      "requestId",
+      "price",
+      "preview",
+      "payment",
+      "nextAction"
+    ],
+    "type": "object"
+  }
+]

removedOutput schema / properties

Removed value: -{
-  "assumptions": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "comparablesSummary": {
-    "anyOf": [
-      {
-        "additionalProperties": false,
-        "properties": {
-          "highRentPerSqm": {
-            "type": "number"
-          },
-          "lowRentPerSqm": {
-            "type": "number"
-          },
-          "medianRentPerSqm": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "medianRentPerSqm",
-          "lowRentPerSqm",
-          "highRentPerSqm"
-        ],
-        "type": "object"
-      },
-      {
-        "type": "null"
-      }
-    ]
-  },
-  "confidence": {
-    "additionalProperties": false,
-    "properties": {
-      "level": {
-        "enum": [
-          "insufficient",
-          "low",
-          "medium",
-          "high"
-        ],
-        "type": "string"
-      },
-      "reasons": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "score": {
-        "maximum": 1,
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "score",
-      "level",
-      "reasons"
-    ],
-    "type": "object"
-  },
-  "currency": {
-    "const": "OMR",
-    "type": "string"
-  },
-  "dataQuality": {
-    "additionalProperties": false,
-    "properties": {
-      "dataFreshnessDays": {
-        "anyOf": [
-          {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "latestDataDate": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "sampleSize": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      },
-      "sourceTypes": {
-        "items": {
-          "enum": [
-            "official_statistics",
-            "listing_asking_price",
-            "manual_benchmark",
-            "partner_feed"
-          ],
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "staleMarketData": {
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "latestDataDate",
-      "dataFreshnessDays",
-      "sampleSize",
-      "sourceTypes",
-      "staleMarketData"
-    ],
-    "type": "object"
-  },
-  "historicalSalesContext": {
-    "additionalProperties": false,
-    "properties": {
-      "available": {
-        "type": "boolean"
-      },
-      "latestRecordDate": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "medianHistoricalPricePerSqmOMR": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "oldestRecordDate": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "phaseBreakdown": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "latestRecordDate": {
-              "type": "string"
-            },
-            "medianPriceOMR": {
-              "type": "number"
-            },
-            "medianPricePerSqmOMR": {
-              "type": "number"
-            },
-            "oldestRecordDate": {
-              "type": "string"
-            },
-            "phaseName": {
-              "type": "string"
-            },
-            "recordCount": {
-              "maximum": 9007199254740991,
-              "minimum": -9007199254740991,
-              "type": "integer"
-            }
-          },
-          "required": [
-            "phaseName",
-            "recordCount",
-            "medianPriceOMR",
-            "medianPricePerSqmOMR",
-            "oldestRecordDate",
-            "latestRecordDate"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "priceSemantics": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "recentComparableSales": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      },
-      "recentMedianPricePerSqmOMR": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "recordsAvailable": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      },
-      "sourceTypes": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "available",
-      "recordsAvailable",
-      "recentComparableSales",
-      "medianHistoricalPricePerSqmOMR",
-      "recentMedianPricePerSqmOMR",
-      "oldestRecordDate",
-      "latestRecordDate",
-      "sourceTypes",
-      "priceSemantics",
-      "phaseBreakdown"
-    ],
-    "type": "object"
-  },
-  "insufficientMarketData": {
-    "type": "boolean"
-  },
-  "investment": {
-    "additionalProperties": false,
-    "properties": {
-      "estimatedNetIncomeOMR": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "estimatedOperatingCostOMR": {
-        "type": "number"
-      },
-      "grossYieldPct": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "netYieldPct": {
-        "type": [
-          "number",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "grossYieldPct",
-      "estimatedOperatingCostOMR",
-      "estimatedNetIncomeOMR",
-      "netYieldPct"
-    ],
-    "type": "object"
-  },
-  "market": {
-    "additionalProperties": false,
-    "properties": {
-      "comparableCount": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      },
-      "dataFreshnessDays": {
-        "anyOf": [
-          {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "estimatedAnnualRentOMR": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "estimatedMonthlyRentOMR": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "high": {
-                "type": "number"
-              },
-              "low": {
-                "type": "number"
-              },
-              "median": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "low",
-              "median",
-              "high"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "sampleSizeUsed": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "estimatedMonthlyRentOMR",
-      "estimatedAnnualRentOMR",
-      "comparableCount",
-      "sampleSizeUsed",
-      "dataFreshnessDays"
-    ],
-    "type": "object"
-  },
-  "normalizedLocation": {
-    "additionalProperties": false,
-    "properties": {
-      "area": {
-        "type": "string"
-      },
-      "governorate": {
-        "type": "string"
-      },
-      "inputArea": {
-        "type": "string"
-      },
-      "matchType": {
-        "enum": [
-          "exact",
-          "alias",
-          "unmatched"
-        ],
-        "type": "string"
-      },
-      "supported": {
-        "type": "boolean"
-      },
-      "wilayat": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "governorate",
-      "wilayat",
-      "area",
-      "inputArea",
-      "matchType",
-      "supported"
-    ],
-    "type": "object"
-  },
-  "officialMarketContext": {
-    "additionalProperties": false,
-    "properties": {
-      "available": {
-        "type": "boolean"
-      },
-      "confidence": {
-        "additionalProperties": false,
-        "properties": {
-          "level": {
-            "enum": [
-              "unavailable",
-              "low",
-              "medium",
-              "high"
-            ],
-            "type": "string"
-          },
-          "reasons": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "level",
-          "reasons"
-        ],
-        "type": "object"
-      },
-      "dataFreshnessDays": {
-        "anyOf": [
-          {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "governorate": {
-        "type": "string"
-      },
-      "marketActivity": {
-        "additionalProperties": false,
-        "properties": {
-          "mortgageContracts": {
-            "anyOf": [
-              {
-                "maximum": 9007199254740991,
-                "minimum": -9007199254740991,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "saleContracts": {
-            "anyOf": [
-              {
-                "maximum": 9007199254740991,
-                "minimum": -9007199254740991,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "tradedValueOMR": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "tradedValueOMR",
-          "saleContracts",
-          "mortgageContracts"
-        ],
-        "type": "object"
-      },
-      "period": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "provenance": {
-        "additionalProperties": false,
-        "properties": {
-          "datasetId": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "datasetTitle": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "license": {
-            "type": "string"
-          },
-          "publishedAt": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "retrievedAt": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "source": {
-            "type": "string"
-          },
-          "sourceType": {
-            "const": "official_statistics",
-            "type": "string"
-          },
-          "sourceUrl": {
-            "type": [
-              "string",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "source",
-          "sourceType",
-          "datasetId",
-          "datasetTitle",
-          "retrievedAt",
-          "publishedAt",
-          "sourceUrl",
-          "license"
-        ],
-        "type": "object"
-      },
-      "realEstatePriceIndex": {
-        "additionalProperties": false,
-        "properties": {
-          "period": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "value": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "value",
-          "period"
-        ],
-        "type": "object"
-      },
-      "reason": {
-        "anyOf": [
-          {
-            "enum": [
-              "ncsi_not_configured",
-              "no_data_for_governorate",
-              "ncsi_timeout",
-              "ncsi_malformed_response",
-              "official_source_temporarily_unavailable"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "source": {
-        "type": "string"
-      },
-      "sourceType": {
-        "const": "official_statistics",
-        "type": "string"
-      }
-    },
-    "required": [
-      "available",
-      "reason",
-      "source",
-      "sourceType",
-      "governorate",
-      "period",
-      "realEstatePriceIndex",
-      "marketActivity",
-      "dataFreshnessDays",
-      "confidence",
-      "provenance"
-    ],
-    "type": "object"
-  },
-  "pricePosition": {
-    "additionalProperties": false,
-    "properties": {
-      "askingPricePerSqmOMR": {
-        "type": "number"
-      },
-      "marketPosition": {
-        "enum": [
-          "below_market",
-          "at_market",
-          "above_market",
-          "insufficient_data"
-        ],
-        "type": "string"
-      },
-      "observedComparableRange": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "high": {
-                "type": "number"
-              },
-              "low": {
-                "type": "number"
-              },
-              "median": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "low",
-              "median",
-              "high"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "askingPricePerSqmOMR",
-      "observedComparableRange",
-      "marketPosition"
-    ],
-    "type": "object"
-  },
-  "provenance": {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "recordCount": {
-          "maximum": 9007199254740991,
-          "minimum": -9007199254740991,
-          "type": "integer"
-        },
-        "sourceDate": {
-          "type": "string"
-        },
-        "sourceName": {
-          "type": "string"
-        },
-        "sourceType": {
-          "enum": [
-            "official_statistics",
-            "listing_asking_price",
-            "manual_benchmark",
-            "partner_feed"
-          ],
-          "type": "string"
-        }
-      },
-      "required": [
-        "sourceType",
-        "sourceName",
-        "sourceDate",
-        "recordCount"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "riskFlags": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "subjectProperty": {
-    "additionalProperties": false,
-    "properties": {
-      "askingPriceOMR": {
-        "type": "number"
-      },
-      "bathrooms": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "bedrooms": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "furnished": {
-        "enum": [
-          "furnished",
-          "semi_furnished",
-          "unfurnished",
-          "unspecified"
-        ],
-        "type": "string"
-      },
-      "propertyType": {
-        "enum": [
-          "apartment",
-          "villa",
-          "townhouse"
-        ],
-        "type": "string"
-      },
-      "sizeSqm": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "propertyType",
-      "bedrooms",
-      "bathrooms",
-      "sizeSqm",
-      "askingPriceOMR",
-      "furnished"
-    ],
-    "type": "object"
-  },
-  "unavailableOutputs": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  }
-}

removedOutput schema / required

Removed value: -[
-  "normalizedLocation",
-  "subjectProperty",
-  "market",
-  "investment",
-  "pricePosition",
-  "comparablesSummary",
-  "riskFlags",
-  "confidence",
-  "provenance",
-  "assumptions",
-  "insufficientMarketData",
-  "unavailableOutputs",
-  "currency",
-  "dataQuality",
-  "historicalSalesContext",
-  "officialMarketContext"
-]

Changed4 schema fields changedOct 28, 2026

addedOutput schema / additionalProperties
```
Added value: +false
```

removedOutput schema / anyOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "assumptions": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "comparablesSummary": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "highRentPerSqm": {
-                "type": "number"
-              },
-              "lowRentPerSqm": {
-                "type": "number"
-              },
-              "medianRentPerSqm": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "medianRentPerSqm",
-              "lowRentPerSqm",
-              "highRentPerSqm"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "confidence": {
-        "additionalProperties": false,
-        "properties": {
-          "level": {
-            "enum": [
-              "insufficient",
-              "low",
-              "medium",
-              "high"
-            ],
-            "type": "string"
-          },
-          "reasons": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "score": {
-            "maximum": 1,
-            "minimum": 0,
-            "type": "number"
-          }
-        },
-        "required": [
-          "score",
-          "level",
-          "reasons"
-        ],
-        "type": "object"
-      },
-      "currency": {
-        "const": "OMR",
-        "type": "string"
-      },
-      "dataQuality": {
-        "additionalProperties": false,
-        "properties": {
-          "dataFreshnessDays": {
-            "anyOf": [
-              {
-                "maximum": 9007199254740991,
-                "minimum": -9007199254740991,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "latestDataDate": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "sampleSize": {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          "sourceTypes": {
-            "items": {
-              "enum": [
-                "official_statistics",
-                "listing_asking_price",
-                "manual_benchmark",
-                "partner_feed"
-              ],
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "staleMarketData": {
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "latestDataDate",
-          "dataFreshnessDays",
-          "sampleSize",
-          "sourceTypes",
-          "staleMarketData"
-        ],
-        "type": "object"
-      },
-      "historicalSalesContext": {
-        "additionalProperties": false,
-        "properties": {
-          "available": {
-            "type": "boolean"
-          },
-          "latestRecordDate": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "medianHistoricalPricePerSqmOMR": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "oldestRecordDate": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "phaseBreakdown": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "latestRecordDate": {
-                  "type": "string"
-                },
-                "medianPriceOMR": {
-                  "type": "number"
-                },
-                "medianPricePerSqmOMR": {
-                  "type": "number"
-                },
-                "oldestRecordDate": {
-                  "type": "string"
-                },
-                "phaseName": {
-                  "type": "string"
-                },
-                "recordCount": {
-                  "maximum": 9007199254740991,
-                  "minimum": -9007199254740991,
-                  "type": "integer"
-                }
-              },
-              "required": [
-                "phaseName",
-                "recordCount",
-                "medianPriceOMR",
-                "medianPricePerSqmOMR",
-                "oldestRecordDate",
-                "latestRecordDate"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "priceSemantics": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "recentComparableSales": {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          "recentMedianPricePerSqmOMR": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "recordsAvailable": {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          "sourceTypes": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "available",
-          "recordsAvailable",
-          "recentComparableSales",
-          "medianHistoricalPricePerSqmOMR",
-          "recentMedianPricePerSqmOMR",
-          "oldestRecordDate",
-          "latestRecordDate",
-          "sourceTypes",
-          "priceSemantics",
-          "phaseBreakdown"
-        ],
-        "type": "object"
-      },
-      "insufficientMarketData": {
-        "type": "boolean"
-      },
-      "investment": {
-        "additionalProperties": false,
-        "properties": {
-          "estimatedNetIncomeOMR": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "estimatedOperatingCostOMR": {
-            "type": "number"
-          },
-          "grossYieldPct": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "netYieldPct": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "grossYieldPct",
-          "estimatedOperatingCostOMR",
-          "estimatedNetIncomeOMR",
-          "netYieldPct"
-        ],
-        "type": "object"
-      },
-      "market": {
-        "additionalProperties": false,
-        "properties": {
-          "comparableCount": {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          "dataFreshnessDays": {
-            "anyOf": [
-              {
-                "maximum": 9007199254740991,
-                "minimum": -9007199254740991,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "estimatedAnnualRentOMR": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "estimatedMonthlyRentOMR": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "high": {
-                    "type": "number"
-                  },
-                  "low": {
-                    "type": "number"
-                  },
-                  "median": {
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "low",
-                  "median",
-                  "high"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "sampleSizeUsed": {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          }
-        },
-        "required": [
-          "estimatedMonthlyRentOMR",
-          "estimatedAnnualRentOMR",
-          "comparableCount",
-          "sampleSizeUsed",
-          "dataFreshnessDays"
-        ],
-        "type": "object"
-      },
-      "normalizedLocation": {
-        "additionalProperties": false,
-        "properties": {
-          "area": {
-            "type": "string"
-          },
-          "governorate": {
-            "type": "string"
-          },
-          "inputArea": {
-            "type": "string"
-          },
-          "matchType": {
-            "enum": [
-              "exact",
-              "alias",
-              "unmatched"
-            ],
-            "type": "string"
-          },
-          "supported": {
-            "type": "boolean"
-          },
-          "wilayat": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "governorate",
-          "wilayat",
-          "area",
-          "inputArea",
-          "matchType",
-          "supported"
-        ],
-        "type": "object"
-      },
-      "officialMarketContext": {
-        "additionalProperties": false,
-        "properties": {
-          "available": {
-            "type": "boolean"
-          },
-          "confidence": {
-            "additionalProperties": false,
-            "properties": {
-              "level": {
-                "enum": [
-                  "unavailable",
-                  "low",
-                  "medium",
-                  "high"
-                ],
-                "type": "string"
-              },
-              "reasons": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              }
-            },
-            "required": [
-              "level",
-              "reasons"
-            ],
-            "type": "object"
-          },
-          "dataFreshnessDays": {
-            "anyOf": [
-              {
-                "maximum": 9007199254740991,
-                "minimum": -9007199254740991,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "governorate": {
-            "type": "string"
-          },
-          "marketActivity": {
-            "additionalProperties": false,
-            "properties": {
-              "mortgageContracts": {
-                "anyOf": [
-                  {
-                    "maximum": 9007199254740991,
-                    "minimum": -9007199254740991,
-                    "type": "integer"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "saleContracts": {
-                "anyOf": [
-                  {
-                    "maximum": 9007199254740991,
-                    "minimum": -9007199254740991,
-                    "type": "integer"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "tradedValueOMR": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              }
-            },
-            "required": [
-              "tradedValueOMR",
-              "saleContracts",
-              "mortgageContracts"
-            ],
-            "type": "object"
-          },
-          "period": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "provenance": {
-            "additionalProperties": false,
-            "properties": {
-              "datasetId": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "datasetTitle": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "license": {
-                "type": "string"
-              },
-              "publishedAt": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "retrievedAt": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source": {
-                "type": "string"
-              },
-              "sourceType": {
-                "const": "official_statistics",
-                "type": "string"
-              },
-              "sourceUrl": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              }
-            },
-            "required": [
-              "source",
-              "sourceType",
-              "datasetId",
-              "datasetTitle",
-              "retrievedAt",
-              "publishedAt",
-              "sourceUrl",
-              "license"
-            ],
-            "type": "object"
-          },
-          "realEstatePriceIndex": {
-            "additionalProperties": false,
-            "properties": {
-              "period": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "value": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              }
-            },
-            "required": [
-              "value",
-              "period"
-            ],
-            "type": "object"
-          },
-          "reason": {
-            "anyOf": [
-              {
-                "enum": [
-                  "ncsi_not_configured",
-                  "no_data_for_governorate",
-                  "ncsi_timeout",
-                  "ncsi_malformed_response",
-                  "official_source_temporarily_unavailable"
-                ],
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "source": {
-            "type": "string"
-          },
-          "sourceType": {
-            "const": "official_statistics",
-            "type": "string"
-          }
-        },
-        "required": [
-          "available",
-          "reason",
-          "source",
-          "sourceType",
-          "governorate",
-          "period",
-          "realEstatePriceIndex",
-          "marketActivity",
-          "dataFreshnessDays",
-          "confidence",
-          "provenance"
-        ],
-        "type": "object"
-      },
-      "pricePosition": {
-        "additionalProperties": false,
-        "properties": {
-          "askingPricePerSqmOMR": {
-            "type": "number"
-          },
-          "marketPosition": {
-            "enum": [
-              "below_market",
-              "at_market",
-              "above_market",
-              "insufficient_data"
-            ],
-            "type": "string"
-          },
-          "observedComparableRange": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "high": {
-                    "type": "number"
-                  },
-                  "low": {
-                    "type": "number"
-                  },
-                  "median": {
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "low",
-                  "median",
-                  "high"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "required": [
-          "askingPricePerSqmOMR",
-          "observedComparableRange",
-          "marketPosition"
-        ],
-        "type": "object"
-      },
-      "provenance": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "recordCount": {
-              "maximum": 9007199254740991,
-              "minimum": -9007199254740991,
-              "type": "integer"
-            },
-            "sourceDate": {
-              "type": "string"
-            },
-            "sourceName": {
-              "type": "string"
-            },
-            "sourceType": {
-              "enum": [
-                "official_statistics",
-                "listing_asking_price",
-                "manual_benchmark",
-                "partner_feed"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "sourceType",
-            "sourceName",
-            "sourceDate",
-            "recordCount"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "riskFlags": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "subjectProperty": {
-        "additionalProperties": false,
-        "properties": {
-          "askingPriceOMR": {
-            "type": "number"
-          },
-          "bathrooms": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "bedrooms": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "furnished": {
-            "enum": [
-              "furnished",
-              "semi_furnished",
-              "unfurnished",
-              "unspecified"
-            ],
-            "type": "string"
-          },
-          "propertyType": {
-            "enum": [
-              "apartment",
-              "villa",
-              "townhouse"
-            ],
-            "type": "string"
-          },
-          "sizeSqm": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "propertyType",
-          "bedrooms",
-          "bathrooms",
-          "sizeSqm",
-          "askingPriceOMR",
-          "furnished"
-        ],
-        "type": "object"
-      },
-      "unavailableOutputs": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "normalizedLocation",
-      "subjectProperty",
-      "market",
-      "investment",
-      "pricePosition",
-      "comparablesSummary",
-      "riskFlags",
-      "confidence",
-      "provenance",
-      "assumptions",
-      "insufficientMarketData",
-      "unavailableOutputs",
-      "currency",
-      "dataQuality",
-      "historicalSalesContext",
-      "officialMarketContext"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "nextAction": {
-        "additionalProperties": false,
-        "properties": {
-          "instruction": {
-            "type": "string"
-          },
-          "target": {
-            "enum": [
-              "x402_endpoint",
-              "mcp_credits_endpoint",
-              "payment_endpoint",
-              "unavailable"
-            ],
-            "type": "string"
-          },
-          "type": {
-            "enum": [
-              "pay_and_retry",
-              "authorize_and_use_mcp_credits",
-              "payment_unavailable"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "target",
-          "instruction"
-        ],
-        "type": "object"
-      },
-      "payment": {
-        "additionalProperties": false,
-        "properties": {
-          "endpoint": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "method": {
-            "const": "POST",
-            "type": "string"
-          },
-          "retrySameBody": {
-            "const": true,
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "endpoint",
-          "method",
-          "retrySameBody"
-        ],
-        "type": "object"
-      },
-      "paymentGuidance": {},
-      "preview": {
-        "additionalProperties": false,
-        "properties": {
-          "fullResultAvailable": {
-            "const": true,
-            "type": "boolean"
-          },
-          "inputAccepted": {
-            "const": true,
-            "type": "boolean"
-          },
-          "summary": {
-            "type": "string"
-          },
-          "useCases": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "inputAccepted",
-          "fullResultAvailable",
-          "summary",
-          "useCases"
-        ],
-        "type": "object"
-      },
-      "price": {
-        "additionalProperties": false,
-        "properties": {
-          "amount": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "currency": {
-            "type": "string"
-          },
-          "protocol": {
-            "enum": [
-              "x402",
-              "api_credits",
-              "subscription",
-              "l402",
-              "mpp",
-              "unavailable"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "amount",
-          "currency",
-          "protocol"
-        ],
-        "type": "object"
-      },
-      "requestId": {
-        "type": "string"
-      },
-      "status": {
-        "const": "payment_required",
-        "type": "string"
-      },
-      "tool": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "tool",
-      "requestId",
-      "price",
-      "preview",
-      "payment",
-      "nextAction"
-    ],
-    "type": "object"
-  }
-]

addedOutput schema / properties

Added value: +{
+  "assumptions": {
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "comparablesSummary": {
+    "anyOf": [
+      {
+        "additionalProperties": false,
+        "properties": {
+          "highRentPerSqm": {
+            "type": "number"
+          },
+          "lowRentPerSqm": {
+            "type": "number"
+          },
+          "medianRentPerSqm": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "medianRentPerSqm",
+          "lowRentPerSqm",
+          "highRentPerSqm"
+        ],
+        "type": "object"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "confidence": {
+    "additionalProperties": false,
+    "properties": {
+      "level": {
+        "enum": [
+          "insufficient",
+          "low",
+          "medium",
+          "high"
+        ],
+        "type": "string"
+      },
+      "reasons": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "score": {
+        "maximum": 1,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "score",
+      "level",
+      "reasons"
+    ],
+    "type": "object"
+  },
+  "currency": {
+    "const": "OMR",
+    "type": "string"
+  },
+  "dataQuality": {
+    "additionalProperties": false,
+    "properties": {
+      "dataFreshnessDays": {
+        "anyOf": [
+          {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "latestDataDate": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "sampleSize": {
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "sourceTypes": {
+        "items": {
+          "enum": [
+            "official_statistics",
+            "listing_asking_price",
+            "manual_benchmark",
+            "partner_feed"
+          ],
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "staleMarketData": {
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "latestDataDate",
+      "dataFreshnessDays",
+      "sampleSize",
+      "sourceTypes",
+      "staleMarketData"
+    ],
+    "type": "object"
+  },
+  "historicalSalesContext": {
+    "additionalProperties": false,
+    "properties": {
+      "available": {
+        "type": "boolean"
+      },
+      "latestRecordDate": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "medianHistoricalPricePerSqmOMR": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "oldestRecordDate": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "phaseBreakdown": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "latestRecordDate": {
+              "type": "string"
+            },
+            "medianPriceOMR": {
+              "type": "number"
+            },
+            "medianPricePerSqmOMR": {
+              "type": "number"
+            },
+            "oldestRecordDate": {
+              "type": "string"
+            },
+            "phaseName": {
+              "type": "string"
+            },
+            "recordCount": {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            }
+          },
+          "required": [
+            "phaseName",
+            "recordCount",
+            "medianPriceOMR",
+            "medianPricePerSqmOMR",
+            "oldestRecordDate",
+            "latestRecordDate"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "priceSemantics": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "recentComparableSales": {
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "recentMedianPricePerSqmOMR": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "recordsAvailable": {
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "sourceTypes": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "available",
+      "recordsAvailable",
+      "recentComparableSales",
+      "medianHistoricalPricePerSqmOMR",
+      "recentMedianPricePerSqmOMR",
+      "oldestRecordDate",
+      "latestRecordDate",
+      "sourceTypes",
+      "priceSemantics",
+      "phaseBreakdown"
+    ],
+    "type": "object"
+  },
+  "insufficientMarketData": {
+    "type": "boolean"
+  },
+  "investment": {
+    "additionalProperties": false,
+    "properties": {
+      "estimatedNetIncomeOMR": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "estimatedOperatingCostOMR": {
+        "type": "number"
+      },
+      "grossYieldPct": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "netYieldPct": {
+        "type": [
+          "number",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "grossYieldPct",
+      "estimatedOperatingCostOMR",
+      "estimatedNetIncomeOMR",
+      "netYieldPct"
+    ],
+    "type": "object"
+  },
+  "market": {
+    "additionalProperties": false,
+    "properties": {
+      "comparableCount": {
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "dataFreshnessDays": {
+        "anyOf": [
+          {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "estimatedAnnualRentOMR": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "estimatedMonthlyRentOMR": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "high": {
+                "type": "number"
+              },
+              "low": {
+                "type": "number"
+              },
+              "median": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "low",
+              "median",
+              "high"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "sampleSizeUsed": {
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "estimatedMonthlyRentOMR",
+      "estimatedAnnualRentOMR",
+      "comparableCount",
+      "sampleSizeUsed",
+      "dataFreshnessDays"
+    ],
+    "type": "object"
+  },
+  "normalizedLocation": {
+    "additionalProperties": false,
+    "properties": {
+      "area": {
+        "type": "string"
+      },
+      "governorate": {
+        "type": "string"
+      },
+      "inputArea": {
+        "type": "string"
+      },
+      "matchType": {
+        "enum": [
+          "exact",
+          "alias",
+          "unmatched"
+        ],
+        "type": "string"
+      },
+      "supported": {
+        "type": "boolean"
+      },
+      "wilayat": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "governorate",
+      "wilayat",
+      "area",
+      "inputArea",
+      "matchType",
+      "supported"
+    ],
+    "type": "object"
+  },
+  "officialMarketContext": {
+    "additionalProperties": false,
+    "properties": {
+      "available": {
+        "type": "boolean"
+      },
+      "confidence": {
+        "additionalProperties": false,
+        "properties": {
+          "level": {
+            "enum": [
+              "unavailable",
+              "low",
+              "medium",
+              "high"
+            ],
+            "type": "string"
+          },
+          "reasons": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "level",
+          "reasons"
+        ],
+        "type": "object"
+      },
+      "dataFreshnessDays": {
+        "anyOf": [
+          {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "governorate": {
+        "type": "string"
+      },
+      "marketActivity": {
+        "additionalProperties": false,
+        "properties": {
+          "mortgageContracts": {
+            "anyOf": [
+              {
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "saleContracts": {
+            "anyOf": [
+              {
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "tradedValueOMR": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "tradedValueOMR",
+          "saleContracts",
+          "mortgageContracts"
+        ],
+        "type": "object"
+      },
+      "period": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "provenance": {
+        "additionalProperties": false,
+        "properties": {
+          "datasetId": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "datasetTitle": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "license": {
+            "type": "string"
+          },
+          "publishedAt": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "retrievedAt": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source": {
+            "type": "string"
+          },
+          "sourceType": {
+            "const": "official_statistics",
+            "type": "string"
+          },
+          "sourceUrl": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "source",
+          "sourceType",
+          "datasetId",
+          "datasetTitle",
+          "retrievedAt",
+          "publishedAt",
+          "sourceUrl",
+          "license"
+        ],
+        "type": "object"
+      },
+      "realEstatePriceIndex": {
+        "additionalProperties": false,
+        "properties": {
+          "period": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "value": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "value",
+          "period"
+        ],
+        "type": "object"
+      },
+      "reason": {
+        "anyOf": [
+          {
+            "enum": [
+              "ncsi_not_configured",
+              "no_data_for_governorate",
+              "ncsi_timeout",
+              "ncsi_malformed_response",
+              "official_source_temporarily_unavailable"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "source": {
+        "type": "string"
+      },
+      "sourceType": {
+        "const": "official_statistics",
+        "type": "string"
+      }
+    },
+    "required": [
+      "available",
+      "reason",
+      "source",
+      "sourceType",
+      "governorate",
+      "period",
+      "realEstatePriceIndex",
+      "marketActivity",
+      "dataFreshnessDays",
+      "confidence",
+      "provenance"
+    ],
+    "type": "object"
+  },
+  "pricePosition": {
+    "additionalProperties": false,
+    "properties": {
+      "askingPricePerSqmOMR": {
+        "type": "number"
+      },
+      "marketPosition": {
+        "enum": [
+          "below_market",
+          "at_market",
+          "above_market",
+          "insufficient_data"
+        ],
+        "type": "string"
+      },
+      "observedComparableRange": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "high": {
+                "type": "number"
+              },
+              "low": {
+                "type": "number"
+              },
+              "median": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "low",
+              "median",
+              "high"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "askingPricePerSqmOMR",
+      "observedComparableRange",
+      "marketPosition"
+    ],
+    "type": "object"
+  },
+  "provenance": {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "recordCount": {
+          "maximum": 9007199254740991,
+          "minimum": -9007199254740991,
+          "type": "integer"
+        },
+        "sourceDate": {
+          "type": "string"
+        },
+        "sourceName": {
+          "type": "string"
+        },
+        "sourceType": {
+          "enum": [
+            "official_statistics",
+            "listing_asking_price",
+            "manual_benchmark",
+            "partner_feed"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "sourceType",
+        "sourceName",
+        "sourceDate",
+        "recordCount"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "riskFlags": {
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "subjectProperty": {
+    "additionalProperties": false,
+    "properties": {
+      "askingPriceOMR": {
+        "type": "number"
+      },
+      "bathrooms": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "bedrooms": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "furnished": {
+        "enum": [
+          "furnished",
+          "semi_furnished",
+          "unfurnished",
+          "unspecified"
+        ],
+        "type": "string"
+      },
+      "propertyType": {
+        "enum": [
+          "apartment",
+          "villa",
+          "townhouse"
+        ],
+        "type": "string"
+      },
+      "sizeSqm": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "propertyType",
+      "bedrooms",
+      "bathrooms",
+      "sizeSqm",
+      "askingPriceOMR",
+      "furnished"
+    ],
+    "type": "object"
+  },
+  "unavailableOutputs": {
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  }
+}

addedOutput schema / required

Added value: +[
+  "normalizedLocation",
+  "subjectProperty",
+  "market",
+  "investment",
+  "pricePosition",
+  "comparablesSummary",
+  "riskFlags",
+  "confidence",
+  "provenance",
+  "assumptions",
+  "insufficientMarketData",
+  "unavailableOutputs",
+  "currency",
+  "dataQuality",
+  "historicalSalesContext",
+  "officialMarketContext"
+]

Changed1 schema field changedOct 10, 2026

changedOutput schema / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "assumptions": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "comparablesSummary": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "highRentPerSqm": {
-                "type": "number"
-              },
-              "lowRentPerSqm": {
-                "type": "number"
-              },
-              "medianRentPerSqm": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "medianRentPerSqm",
-              "lowRentPerSqm",
-              "highRentPerSqm"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "confidence": {
-        "additionalProperties": false,
-        "properties": {
-          "level": {
-            "enum": [
-              "insufficient",
-              "low",
-              "medium",
-              "high"
-            ],
-            "type": "string"
-          },
-          "reasons": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "score": {
-            "maximum": 1,
-            "minimum": 0,
-            "type": "number"
-          }
-        },
-        "required": [
-          "score",
-          "level",
-          "reasons"
-        ],
-        "type": "object"
-      },
-      "currency": {
-        "const": "OMR",
-        "type": "string"
-      },
-      "dataQuality": {
-        "additionalProperties": false,
-        "properties": {
-          "dataFreshnessDays": {
-            "anyOf": [
-              {
-                "maximum": 9007199254740991,
-                "minimum": -9007199254740991,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "latestDataDate": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "sampleSize": {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          "sourceTypes": {
-            "items": {
-              "enum": [
-                "official_statistics",
-                "listing_asking_price",
-                "manual_benchmark",
-                "partner_feed"
-              ],
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "staleMarketData": {
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "latestDataDate",
-          "dataFreshnessDays",
-          "sampleSize",
-          "sourceTypes",
-          "staleMarketData"
-        ],
-        "type": "object"
-      },
-      "historicalSalesContext": {
-        "additionalProperties": false,
-        "properties": {
-          "available": {
-            "type": "boolean"
-          },
-          "latestRecordDate": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "medianHistoricalPricePerSqmOMR": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "oldestRecordDate": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "phaseBreakdown": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "latestRecordDate": {
-                  "type": "string"
-                },
-                "medianPriceOMR": {
-                  "type": "number"
-                },
-                "medianPricePerSqmOMR": {
-                  "type": "number"
-                },
-                "oldestRecordDate": {
-                  "type": "string"
-                },
-                "phaseName": {
-                  "type": "string"
-                },
-                "recordCount": {
-                  "maximum": 9007199254740991,
-                  "minimum": -9007199254740991,
-                  "type": "integer"
-                }
-              },
-              "required": [
-                "phaseName",
-                "recordCount",
-                "medianPriceOMR",
-                "medianPricePerSqmOMR",
-                "oldestRecordDate",
-                "latestRecordDate"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "priceSemantics": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "recentComparableSales": {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          "recentMedianPricePerSqmOMR": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "recordsAvailable": {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          "sourceTypes": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "available",
-          "recordsAvailable",
-          "recentComparableSales",
-          "medianHistoricalPricePerSqmOMR",
-          "recentMedianPricePerSqmOMR",
-          "oldestRecordDate",
-          "latestRecordDate",
-          "sourceTypes",
-          "priceSemantics",
-          "phaseBreakdown"
-        ],
-        "type": "object"
-      },
-      "insufficientMarketData": {
-        "type": "boolean"
-      },
-      "investment": {
-        "additionalProperties": false,
-        "properties": {
-          "estimatedNetIncomeOMR": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "estimatedOperatingCostOMR": {
-            "type": "number"
-          },
-          "grossYieldPct": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "netYieldPct": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "grossYieldPct",
-          "estimatedOperatingCostOMR",
-          "estimatedNetIncomeOMR",
-          "netYieldPct"
-        ],
-        "type": "object"
-      },
-      "market": {
-        "additionalProperties": false,
-        "properties": {
-          "comparableCount": {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          "dataFreshnessDays": {
-            "anyOf": [
-              {
-                "maximum": 9007199254740991,
-                "minimum": -9007199254740991,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "estimatedAnnualRentOMR": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "estimatedMonthlyRentOMR": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "high": {
-                    "type": "number"
-                  },
-                  "low": {
-                    "type": "number"
-                  },
-                  "median": {
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "low",
-                  "median",
-                  "high"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "sampleSizeUsed": {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          }
-        },
-        "required": [
-          "estimatedMonthlyRentOMR",
-          "estimatedAnnualRentOMR",
-          "comparableCount",
-          "sampleSizeUsed",
-          "dataFreshnessDays"
-        ],
-        "type": "object"
-      },
-      "normalizedLocation": {
-        "additionalProperties": false,
-        "properties": {
-          "area": {
-            "type": "string"
-          },
-          "governorate": {
-            "type": "string"
-          },
-          "inputArea": {
-            "type": "string"
-          },
-          "matchType": {
-            "enum": [
-              "exact",
-              "alias",
-              "unmatched"
-            ],
-            "type": "string"
-          },
-          "supported": {
-            "type": "boolean"
-          },
-          "wilayat": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "governorate",
-          "wilayat",
-          "area",
-          "inputArea",
-          "matchType",
-          "supported"
-        ],
-        "type": "object"
-      },
-      "officialMarketContext": {
-        "additionalProperties": false,
-        "properties": {
-          "available": {
-            "type": "boolean"
-          },
-          "confidence": {
-            "additionalProperties": false,
-            "properties": {
-              "level": {
-                "enum": [
-                  "unavailable",
-                  "low",
-                  "medium",
-                  "high"
-                ],
-                "type": "string"
-              },
-              "reasons": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              }
-            },
-            "required": [
-              "level",
-              "reasons"
-            ],
-            "type": "object"
-          },
-          "dataFreshnessDays": {
-            "anyOf": [
-              {
-                "maximum": 9007199254740991,
-                "minimum": -9007199254740991,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "governorate": {
-            "type": "string"
-          },
-          "marketActivity": {
-            "additionalProperties": false,
-            "properties": {
-              "mortgageContracts": {
-                "anyOf": [
-                  {
-                    "maximum": 9007199254740991,
-                    "minimum": -9007199254740991,
-                    "type": "integer"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "saleContracts": {
-                "anyOf": [
-                  {
-                    "maximum": 9007199254740991,
-                    "minimum": -9007199254740991,
-                    "type": "integer"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "tradedValueOMR": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              }
-            },
-            "required": [
-              "tradedValueOMR",
-              "saleContracts",
-              "mortgageContracts"
-            ],
-            "type": "object"
-          },
-          "period": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "provenance": {
-            "additionalProperties": false,
-            "properties": {
-              "datasetId": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "datasetTitle": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "license": {
-                "type": "string"
-              },
-              "publishedAt": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "retrievedAt": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source": {
-                "type": "string"
-              },
-              "sourceType": {
-                "const": "official_statistics",
-                "type": "string"
-              },
-              "sourceUrl": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              }
-            },
-            "required": [
-              "source",
-              "sourceType",
-              "datasetId",
-              "datasetTitle",
-              "retrievedAt",
-              "publishedAt",
-              "sourceUrl",
-              "license"
-            ],
-            "type": "object"
-          },
-          "realEstatePriceIndex": {
-            "additionalProperties": false,
-            "properties": {
-              "period": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "value": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              }
-            },
-            "required": [
-              "value",
-              "period"
-            ],
-            "type": "object"
-          },
-          "reason": {
-            "anyOf": [
-              {
-                "enum": [
-                  "ncsi_not_configured",
-                  "no_data_for_governorate",
-                  "ncsi_timeout",
-                  "ncsi_malformed_response",
-                  "official_source_temporarily_unavailable"
-                ],
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "source": {
-            "type": "string"
-          },
-          "sourceType": {
-            "const": "official_statistics",
-            "type": "string"
-          }
-        },
-        "required": [
-          "available",
-          "reason",
-          "source",
-          "sourceType",
-          "governorate",
-          "period",
-          "realEstatePriceIndex",
-          "marketActivity",
-          "dataFreshnessDays",
-          "confidence",
-          "provenance"
-        ],
-        "type": "object"
-      },
-      "pricePosition": {
-        "additionalProperties": false,
-        "properties": {
-          "askingPricePerSqmOMR": {
-            "type": "number"
-          },
-          "marketPosition": {
-            "enum": [
-              "below_market",
-              "at_market",
-              "above_market",
-              "insufficient_data"
-            ],
-            "type": "string"
-          },
-          "observedComparableRange": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "high": {
-                    "type": "number"
-                  },
-                  "low": {
-                    "type": "number"
-                  },
-                  "median": {
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "low",
-                  "median",
-                  "high"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "required": [
-          "askingPricePerSqmOMR",
-          "observedComparableRange",
-          "marketPosition"
-        ],
-        "type": "object"
-      },
-      "provenance": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "recordCount": {
-              "maximum": 9007199254740991,
-              "minimum": -9007199254740991,
-              "type": "integer"
-            },
-            "sourceDate": {
-              "type": "string"
-            },
-            "sourceName": {
-              "type": "string"
-            },
-            "sourceType": {
-              "enum": [
-                "official_statistics",
-                "listing_asking_price",
-                "manual_benchmark",
-                "partner_feed"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "sourceType",
-            "sourceName",
-            "sourceDate",
-            "recordCount"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "riskFlags": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "subjectProperty": {
-        "additionalProperties": false,
-        "properties": {
-          "askingPriceOMR": {
-            "type": "number"
-          },
-          "bathrooms": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "bedrooms": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "furnished": {
-            "enum": [
-              "furnished",
-              "semi_furnished",
-              "unfurnished",
-              "unspecified"
-            ],
-            "type": "string"
-          },
-          "propertyType": {
-            "enum": [
-              "apartment",
-              "villa",
-              "townhouse"
-            ],
-            "type": "string"
-          },
-          "sizeSqm": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "propertyType",
-          "bedrooms",
-          "bathrooms",
-          "sizeSqm",
-          "askingPriceOMR",
-          "furnished"
-        ],
-        "type": "object"
-      },
-      "unavailableOutputs": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "normalizedLocation",
-      "subjectProperty",
-      "market",
-      "investment",
-      "pricePosition",
-      "comparablesSummary",
-      "riskFlags",
-      "confidence",
-      "provenance",
-      "assumptions",
-      "insufficientMarketData",
-      "unavailableOutputs",
-      "currency",
-      "dataQuality",
-      "historicalSalesContext",
-      "officialMarketContext"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "nextAction": {
-        "additionalProperties": false,
-        "properties": {
-          "instruction": {
-            "type": "string"
-          },
-          "target": {
-            "const": "x402_endpoint",
-            "type": "string"
-          },
-          "type": {
-            "const": "pay_and_retry",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "target",
-          "instruction"
-        ],
-        "type": "object"
-      },
-      "payment": {
-        "additionalProperties": false,
-        "properties": {
-          "endpoint": {
-            "type": "string"
-          },
-          "method": {
-            "const": "POST",
-            "type": "string"
-          },
-          "retrySameBody": {
-            "const": true,
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "endpoint",
-          "method",
-          "retrySameBody"
-        ],
-        "type": "object"
-      },
-      "preview": {
-        "additionalProperties": false,
-        "properties": {
-          "fullResultAvailable": {
-            "const": true,
-            "type": "boolean"
-          },
-          "inputAccepted": {
-            "const": true,
-            "type": "boolean"
-          },
-          "summary": {
-            "type": "string"
-          },
-          "useCases": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "inputAccepted",
-          "fullResultAvailable",
-          "summary",
-          "useCases"
-        ],
-        "type": "object"
-      },
-      "price": {
-        "additionalProperties": false,
-        "properties": {
-          "amount": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "currency": {
-            "type": "string"
-          },
-          "protocol": {
-            "const": "x402",
-            "type": "string"
-          }
-        },
-        "required": [
-          "amount",
-          "currency",
-          "protocol"
-        ],
-        "type": "object"
-      },
-      "requestId": {
-        "type": "string"
-      },
-      "status": {
-        "const": "payment_required",
-        "type": "string"
-      },
-      "tool": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "tool",
-      "requestId",
-      "price",
-      "preview",
-      "payment",
-      "nextAction"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "assumptions": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "comparablesSummary": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "highRentPerSqm": {
+                "type": "number"
+              },
+              "lowRentPerSqm": {
+                "type": "number"
+              },
+              "medianRentPerSqm": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "medianRentPerSqm",
+              "lowRentPerSqm",
+              "highRentPerSqm"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "confidence": {
+        "additionalProperties": false,
+        "properties": {
+          "level": {
+            "enum": [
+              "insufficient",
+              "low",
+              "medium",
+              "high"
+            ],
+            "type": "string"
+          },
+          "reasons": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "score": {
+            "maximum": 1,
+            "minimum": 0,
+            "type": "number"
+          }
+        },
+        "required": [
+          "score",
+          "level",
+          "reasons"
+        ],
+        "type": "object"
+      },
+      "currency": {
+        "const": "OMR",
+        "type": "string"
+      },
+      "dataQuality": {
+        "additionalProperties": false,
+        "properties": {
+          "dataFreshnessDays": {
+            "anyOf": [
+              {
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "latestDataDate": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "sampleSize": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          "sourceTypes": {
+            "items": {
+              "enum": [
+                "official_statistics",
+                "listing_asking_price",
+                "manual_benchmark",
+                "partner_feed"
+              ],
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "staleMarketData": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "latestDataDate",
+          "dataFreshnessDays",
+          "sampleSize",
+          "sourceTypes",
+          "staleMarketData"
+        ],
+        "type": "object"
+      },
+      "historicalSalesContext": {
+        "additionalProperties": false,
+        "properties": {
+          "available": {
+            "type": "boolean"
+          },
+          "latestRecordDate": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "medianHistoricalPricePerSqmOMR": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "oldestRecordDate": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "phaseBreakdown": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "latestRecordDate": {
+                  "type": "string"
+                },
+                "medianPriceOMR": {
+                  "type": "number"
+                },
+                "medianPricePerSqmOMR": {
+                  "type": "number"
+                },
+                "oldestRecordDate": {
+                  "type": "string"
+                },
+                "phaseName": {
+                  "type": "string"
+                },
+                "recordCount": {
+                  "maximum": 9007199254740991,
+                  "minimum": -9007199254740991,
+                  "type": "integer"
+                }
+              },
+              "required": [
+                "phaseName",
+                "recordCount",
+                "medianPriceOMR",
+                "medianPricePerSqmOMR",
+                "oldestRecordDate",
+                "latestRecordDate"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "priceSemantics": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "recentComparableSales": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          "recentMedianPricePerSqmOMR": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "recordsAvailable": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          "sourceTypes": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "available",
+          "recordsAvailable",
+          "recentComparableSales",
+          "medianHistoricalPricePerSqmOMR",
+          "recentMedianPricePerSqmOMR",
+          "oldestRecordDate",
+          "latestRecordDate",
+          "sourceTypes",
+          "priceSemantics",
+          "phaseBreakdown"
+        ],
+        "type": "object"
+      },
+      "insufficientMarketData": {
+        "type": "boolean"
+      },
+      "investment": {
+        "additionalProperties": false,
+        "properties": {
+          "estimatedNetIncomeOMR": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "estimatedOperatingCostOMR": {
+            "type": "number"
+          },
+          "grossYieldPct": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "netYieldPct": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "grossYieldPct",
+          "estimatedOperatingCostOMR",
+          "estimatedNetIncomeOMR",
+          "netYieldPct"
+        ],
+        "type": "object"
+      },
+      "market": {
+        "additionalProperties": false,
+        "properties": {
+          "comparableCount": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          "dataFreshnessDays": {
+            "anyOf": [
+              {
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "estimatedAnnualRentOMR": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "estimatedMonthlyRentOMR": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "high": {
+                    "type": "number"
+                  },
+                  "low": {
+                    "type": "number"
+                  },
+                  "median": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "low",
+                  "median",
+                  "high"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "sampleSizeUsed": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "estimatedMonthlyRentOMR",
+          "estimatedAnnualRentOMR",
+          "comparableCount",
+          "sampleSizeUsed",
+          "dataFreshnessDays"
+        ],
+        "type": "object"
+      },
+      "normalizedLocation": {
+        "additionalProperties": false,
+        "properties": {
+          "area": {
+            "type": "string"
+          },
+          "governorate": {
+            "type": "string"
+          },
+          "inputArea": {
+            "type": "string"
+          },
+          "matchType": {
+            "enum": [
+              "exact",
+              "alias",
+              "unmatched"
+            ],
+            "type": "string"
+          },
+          "supported": {
+            "type": "boolean"
+          },
+          "wilayat": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "governorate",
+          "wilayat",
+          "area",
+          "inputArea",
+          "matchType",
+          "supported"
+        ],
+        "type": "object"
+      },
+      "officialMarketContext": {
+        "additionalProperties": false,
+        "properties": {
+          "available": {
+            "type": "boolean"
+          },
+          "confidence": {
+            "additionalProperties": false,
+            "properties": {
+              "level": {
+                "enum": [
+                  "unavailable",
+                  "low",
+                  "medium",
+                  "high"
+                ],
+                "type": "string"
+              },
+              "reasons": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "level",
+              "reasons"
+            ],
+            "type": "object"
+          },
+          "dataFreshnessDays": {
+            "anyOf": [
+              {
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "governorate": {
+            "type": "string"
+          },
+          "marketActivity": {
+            "additionalProperties": false,
+            "properties": {
+              "mortgageContracts": {
+                "anyOf": [
+                  {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "saleContracts": {
+                "anyOf": [
+                  {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "tradedValueOMR": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "tradedValueOMR",
+              "saleContracts",
+              "mortgageContracts"
+            ],
+            "type": "object"
+          },
+          "period": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "provenance": {
+            "additionalProperties": false,
+            "properties": {
+              "datasetId": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "datasetTitle": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "license": {
+                "type": "string"
+              },
+              "publishedAt": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "retrievedAt": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source": {
+                "type": "string"
+              },
+              "sourceType": {
+                "const": "official_statistics",
+                "type": "string"
+              },
+              "sourceUrl": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "source",
+              "sourceType",
+              "datasetId",
+              "datasetTitle",
+              "retrievedAt",
+              "publishedAt",
+              "sourceUrl",
+              "license"
+            ],
+            "type": "object"
+          },
+          "realEstatePriceIndex": {
+            "additionalProperties": false,
+            "properties": {
+              "period": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "value": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "value",
+              "period"
+            ],
+            "type": "object"
+          },
+          "reason": {
+            "anyOf": [
+              {
+                "enum": [
+                  "ncsi_not_configured",
+                  "no_data_for_governorate",
+                  "ncsi_timeout",
+                  "ncsi_malformed_response",
+                  "official_source_temporarily_unavailable"
+                ],
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "source": {
+            "type": "string"
+          },
+          "sourceType": {
+            "const": "official_statistics",
+            "type": "string"
+          }
+        },
+        "required": [
+          "available",
+          "reason",
+          "source",
+          "sourceType",
+          "governorate",
+          "period",
+          "realEstatePriceIndex",
+          "marketActivity",
+          "dataFreshnessDays",
+          "confidence",
+          "provenance"
+        ],
+        "type": "object"
+      },
+      "pricePosition": {
+        "additionalProperties": false,
+        "properties": {
+          "askingPricePerSqmOMR": {
+            "type": "number"
+          },
+          "marketPosition": {
+            "enum": [
+              "below_market",
+              "at_market",
+              "above_market",
+              "insufficient_data"
+            ],
+            "type": "string"
+          },
+          "observedComparableRange": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "high": {
+                    "type": "number"
+                  },
+                  "low": {
+                    "type": "number"
+                  },
+                  "median": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "low",
+                  "median",
+                  "high"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "askingPricePerSqmOMR",
+          "observedComparableRange",
+          "marketPosition"
+        ],
+        "type": "object"
+      },
+      "provenance": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "recordCount": {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            },
+            "sourceDate": {
+              "type": "string"
+            },
+            "sourceName": {
+              "type": "string"
+            },
+            "sourceType": {
+              "enum": [
+                "official_statistics",
+                "listing_asking_price",
+                "manual_benchmark",
+                "partner_feed"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "sourceType",
+            "sourceName",
+            "sourceDate",
+            "recordCount"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "riskFlags": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "subjectProperty": {
+        "additionalProperties": false,
+        "properties": {
+          "askingPriceOMR": {
+            "type": "number"
+          },
+          "bathrooms": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "bedrooms": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "furnished": {
+            "enum": [
+              "furnished",
+              "semi_furnished",
+              "unfurnished",
+              "unspecified"
+            ],
+            "type": "string"
+          },
+          "propertyType": {
+            "enum": [
+              "apartment",
+              "villa",
+              "townhouse"
+            ],
+            "type": "string"
+          },
+          "sizeSqm": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "propertyType",
+          "bedrooms",
+          "bathrooms",
+          "sizeSqm",
+          "askingPriceOMR",
+          "furnished"
+        ],
+        "type": "object"
+      },
+      "unavailableOutputs": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "normalizedLocation",
+      "subjectProperty",
+      "market",
+      "investment",
+      "pricePosition",
+      "comparablesSummary",
+      "riskFlags",
+      "confidence",
+      "provenance",
+      "assumptions",
+      "insufficientMarketData",
+      "unavailableOutputs",
+      "currency",
+      "dataQuality",
+      "historicalSalesContext",
+      "officialMarketContext"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "nextAction": {
+        "additionalProperties": false,
+        "properties": {
+          "instruction": {
+            "type": "string"
+          },
+          "target": {
+            "enum": [
+              "x402_endpoint",
+              "mcp_credits_endpoint",
+              "payment_endpoint",
+              "unavailable"
+            ],
+            "type": "string"
+          },
+          "type": {
+            "enum": [
+              "pay_and_retry",
+              "authorize_and_use_mcp_credits",
+              "payment_unavailable"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "target",
+          "instruction"
+        ],
+        "type": "object"
+      },
+      "payment": {
+        "additionalProperties": false,
+        "properties": {
+          "endpoint": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "method": {
+            "const": "POST",
+            "type": "string"
+          },
+          "retrySameBody": {
+            "const": true,
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "endpoint",
+          "method",
+          "retrySameBody"
+        ],
+        "type": "object"
+      },
+      "paymentGuidance": {},
+      "preview": {
+        "additionalProperties": false,
+        "properties": {
+          "fullResultAvailable": {
+            "const": true,
+            "type": "boolean"
+          },
+          "inputAccepted": {
+            "const": true,
+            "type": "boolean"
+          },
+          "summary": {
+            "type": "string"
+          },
+          "useCases": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "inputAccepted",
+          "fullResultAvailable",
+          "summary",
+          "useCases"
+        ],
+        "type": "object"
+      },
+      "price": {
+        "additionalProperties": false,
+        "properties": {
+          "amount": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "currency": {
+            "type": "string"
+          },
+          "protocol": {
+            "enum": [
+              "x402",
+              "api_credits",
+              "subscription",
+              "l402",
+              "mpp",
+              "unavailable"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "amount",
+          "currency",
+          "protocol"
+        ],
+        "type": "object"
+      },
+      "requestId": {
+        "type": "string"
+      },
+      "status": {
+        "const": "payment_required",
+        "type": "string"
+      },
+      "tool": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "tool",
+      "requestId",
+      "price",
+      "preview",
+      "payment",
+      "nextAction"
+    ],
+    "type": "object"
+  }
+]

Changed4 schema fields changedOct 7, 2026

removedOutput schema / additionalProperties
```
Removed value: -false
```

addedOutput schema / anyOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "assumptions": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "comparablesSummary": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "highRentPerSqm": {
+                "type": "number"
+              },
+              "lowRentPerSqm": {
+                "type": "number"
+              },
+              "medianRentPerSqm": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "medianRentPerSqm",
+              "lowRentPerSqm",
+              "highRentPerSqm"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "confidence": {
+        "additionalProperties": false,
+        "properties": {
+          "level": {
+            "enum": [
+              "insufficient",
+              "low",
+              "medium",
+              "high"
+            ],
+            "type": "string"
+          },
+          "reasons": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "score": {
+            "maximum": 1,
+            "minimum": 0,
+            "type": "number"
+          }
+        },
+        "required": [
+          "score",
+          "level",
+          "reasons"
+        ],
+        "type": "object"
+      },
+      "currency": {
+        "const": "OMR",
+        "type": "string"
+      },
+      "dataQuality": {
+        "additionalProperties": false,
+        "properties": {
+          "dataFreshnessDays": {
+            "anyOf": [
+              {
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "latestDataDate": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "sampleSize": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          "sourceTypes": {
+            "items": {
+              "enum": [
+                "official_statistics",
+                "listing_asking_price",
+                "manual_benchmark",
+                "partner_feed"
+              ],
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "staleMarketData": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "latestDataDate",
+          "dataFreshnessDays",
+          "sampleSize",
+          "sourceTypes",
+          "staleMarketData"
+        ],
+        "type": "object"
+      },
+      "historicalSalesContext": {
+        "additionalProperties": false,
+        "properties": {
+          "available": {
+            "type": "boolean"
+          },
+          "latestRecordDate": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "medianHistoricalPricePerSqmOMR": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "oldestRecordDate": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "phaseBreakdown": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "latestRecordDate": {
+                  "type": "string"
+                },
+                "medianPriceOMR": {
+                  "type": "number"
+                },
+                "medianPricePerSqmOMR": {
+                  "type": "number"
+                },
+                "oldestRecordDate": {
+                  "type": "string"
+                },
+                "phaseName": {
+                  "type": "string"
+                },
+                "recordCount": {
+                  "maximum": 9007199254740991,
+                  "minimum": -9007199254740991,
+                  "type": "integer"
+                }
+              },
+              "required": [
+                "phaseName",
+                "recordCount",
+                "medianPriceOMR",
+                "medianPricePerSqmOMR",
+                "oldestRecordDate",
+                "latestRecordDate"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "priceSemantics": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "recentComparableSales": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          "recentMedianPricePerSqmOMR": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "recordsAvailable": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          "sourceTypes": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "available",
+          "recordsAvailable",
+          "recentComparableSales",
+          "medianHistoricalPricePerSqmOMR",
+          "recentMedianPricePerSqmOMR",
+          "oldestRecordDate",
+          "latestRecordDate",
+          "sourceTypes",
+          "priceSemantics",
+          "phaseBreakdown"
+        ],
+        "type": "object"
+      },
+      "insufficientMarketData": {
+        "type": "boolean"
+      },
+      "investment": {
+        "additionalProperties": false,
+        "properties": {
+          "estimatedNetIncomeOMR": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "estimatedOperatingCostOMR": {
+            "type": "number"
+          },
+          "grossYieldPct": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "netYieldPct": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "grossYieldPct",
+          "estimatedOperatingCostOMR",
+          "estimatedNetIncomeOMR",
+          "netYieldPct"
+        ],
+        "type": "object"
+      },
+      "market": {
+        "additionalProperties": false,
+        "properties": {
+          "comparableCount": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          "dataFreshnessDays": {
+            "anyOf": [
+              {
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "estimatedAnnualRentOMR": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "estimatedMonthlyRentOMR": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "high": {
+                    "type": "number"
+                  },
+                  "low": {
+                    "type": "number"
+                  },
+                  "median": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "low",
+                  "median",
+                  "high"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "sampleSizeUsed": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "estimatedMonthlyRentOMR",
+          "estimatedAnnualRentOMR",
+          "comparableCount",
+          "sampleSizeUsed",
+          "dataFreshnessDays"
+        ],
+        "type": "object"
+      },
+      "normalizedLocation": {
+        "additionalProperties": false,
+        "properties": {
+          "area": {
+            "type": "string"
+          },
+          "governorate": {
+            "type": "string"
+          },
+          "inputArea": {
+            "type": "string"
+          },
+          "matchType": {
+            "enum": [
+              "exact",
+              "alias",
+              "unmatched"
+            ],
+            "type": "string"
+          },
+          "supported": {
+            "type": "boolean"
+          },
+          "wilayat": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "governorate",
+          "wilayat",
+          "area",
+          "inputArea",
+          "matchType",
+          "supported"
+        ],
+        "type": "object"
+      },
+      "officialMarketContext": {
+        "additionalProperties": false,
+        "properties": {
+          "available": {
+            "type": "boolean"
+          },
+          "confidence": {
+            "additionalProperties": false,
+            "properties": {
+              "level": {
+                "enum": [
+                  "unavailable",
+                  "low",
+                  "medium",
+                  "high"
+                ],
+                "type": "string"
+              },
+              "reasons": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "level",
+              "reasons"
+            ],
+            "type": "object"
+          },
+          "dataFreshnessDays": {
+            "anyOf": [
+              {
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "governorate": {
+            "type": "string"
+          },
+          "marketActivity": {
+            "additionalProperties": false,
+            "properties": {
+              "mortgageContracts": {
+                "anyOf": [
+                  {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "saleContracts": {
+                "anyOf": [
+                  {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "tradedValueOMR": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "tradedValueOMR",
+              "saleContracts",
+              "mortgageContracts"
+            ],
+            "type": "object"
+          },
+          "period": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "provenance": {
+            "additionalProperties": false,
+            "properties": {
+              "datasetId": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "datasetTitle": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "license": {
+                "type": "string"
+              },
+              "publishedAt": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "retrievedAt": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source": {
+                "type": "string"
+              },
+              "sourceType": {
+                "const": "official_statistics",
+                "type": "string"
+              },
+              "sourceUrl": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "source",
+              "sourceType",
+              "datasetId",
+              "datasetTitle",
+              "retrievedAt",
+              "publishedAt",
+              "sourceUrl",
+              "license"
+            ],
+            "type": "object"
+          },
+          "realEstatePriceIndex": {
+            "additionalProperties": false,
+            "properties": {
+              "period": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "value": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "value",
+              "period"
+            ],
+            "type": "object"
+          },
+          "reason": {
+            "anyOf": [
+              {
+                "enum": [
+                  "ncsi_not_configured",
+                  "no_data_for_governorate",
+                  "ncsi_timeout",
+                  "ncsi_malformed_response",
+                  "official_source_temporarily_unavailable"
+                ],
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "source": {
+            "type": "string"
+          },
+          "sourceType": {
+            "const": "official_statistics",
+            "type": "string"
+          }
+        },
+        "required": [
+          "available",
+          "reason",
+          "source",
+          "sourceType",
+          "governorate",
+          "period",
+          "realEstatePriceIndex",
+          "marketActivity",
+          "dataFreshnessDays",
+          "confidence",
+          "provenance"
+        ],
+        "type": "object"
+      },
+      "pricePosition": {
+        "additionalProperties": false,
+        "properties": {
+          "askingPricePerSqmOMR": {
+            "type": "number"
+          },
+          "marketPosition": {
+            "enum": [
+              "below_market",
+              "at_market",
+              "above_market",
+              "insufficient_data"
+            ],
+            "type": "string"
+          },
+          "observedComparableRange": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "high": {
+                    "type": "number"
+                  },
+                  "low": {
+                    "type": "number"
+                  },
+                  "median": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "low",
+                  "median",
+                  "high"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "askingPricePerSqmOMR",
+          "observedComparableRange",
+          "marketPosition"
+        ],
+        "type": "object"
+      },
+      "provenance": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "recordCount": {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            },
+            "sourceDate": {
+              "type": "string"
+            },
+            "sourceName": {
+              "type": "string"
+            },
+            "sourceType": {
+              "enum": [
+                "official_statistics",
+                "listing_asking_price",
+                "manual_benchmark",
+                "partner_feed"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "sourceType",
+            "sourceName",
+            "sourceDate",
+            "recordCount"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "riskFlags": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "subjectProperty": {
+        "additionalProperties": false,
+        "properties": {
+          "askingPriceOMR": {
+            "type": "number"
+          },
+          "bathrooms": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "bedrooms": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "furnished": {
+            "enum": [
+              "furnished",
+              "semi_furnished",
+              "unfurnished",
+              "unspecified"
+            ],
+            "type": "string"
+          },
+          "propertyType": {
+            "enum": [
+              "apartment",
+              "villa",
+              "townhouse"
+            ],
+            "type": "string"
+          },
+          "sizeSqm": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "propertyType",
+          "bedrooms",
+          "bathrooms",
+          "sizeSqm",
+          "askingPriceOMR",
+          "furnished"
+        ],
+        "type": "object"
+      },
+      "unavailableOutputs": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "normalizedLocation",
+      "subjectProperty",
+      "market",
+      "investment",
+      "pricePosition",
+      "comparablesSummary",
+      "riskFlags",
+      "confidence",
+      "provenance",
+      "assumptions",
+      "insufficientMarketData",
+      "unavailableOutputs",
+      "currency",
+      "dataQuality",
+      "historicalSalesContext",
+      "officialMarketContext"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "nextAction": {
+        "additionalProperties": false,
+        "properties": {
+          "instruction": {
+            "type": "string"
+          },
+          "target": {
+            "const": "x402_endpoint",
+            "type": "string"
+          },
+          "type": {
+            "const": "pay_and_retry",
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "target",
+          "instruction"
+        ],
+        "type": "object"
+      },
+      "payment": {
+        "additionalProperties": false,
+        "properties": {
+          "endpoint": {
+            "type": "string"
+          },
+          "method": {
+            "const": "POST",
+            "type": "string"
+          },
+          "retrySameBody": {
+            "const": true,
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "endpoint",
+          "method",
+          "retrySameBody"
+        ],
+        "type": "object"
+      },
+      "preview": {
+        "additionalProperties": false,
+        "properties": {
+          "fullResultAvailable": {
+            "const": true,
+            "type": "boolean"
+          },
+          "inputAccepted": {
+            "const": true,
+            "type": "boolean"
+          },
+          "summary": {
+            "type": "string"
+          },
+          "useCases": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "inputAccepted",
+          "fullResultAvailable",
+          "summary",
+          "useCases"
+        ],
+        "type": "object"
+      },
+      "price": {
+        "additionalProperties": false,
+        "properties": {
+          "amount": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "currency": {
+            "type": "string"
+          },
+          "protocol": {
+            "const": "x402",
+            "type": "string"
+          }
+        },
+        "required": [
+          "amount",
+          "currency",
+          "protocol"
+        ],
+        "type": "object"
+      },
+      "requestId": {
+        "type": "string"
+      },
+      "status": {
+        "const": "payment_required",
+        "type": "string"
+      },
+      "tool": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "tool",
+      "requestId",
+      "price",
+      "preview",
+      "payment",
+      "nextAction"
+    ],
+    "type": "object"
+  }
+]

removedOutput schema / properties

Removed value: -{
-  "assumptions": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "comparablesSummary": {
-    "anyOf": [
-      {
-        "additionalProperties": false,
-        "properties": {
-          "highRentPerSqm": {
-            "type": "number"
-          },
-          "lowRentPerSqm": {
-            "type": "number"
-          },
-          "medianRentPerSqm": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "medianRentPerSqm",
-          "lowRentPerSqm",
-          "highRentPerSqm"
-        ],
-        "type": "object"
-      },
-      {
-        "type": "null"
-      }
-    ]
-  },
-  "confidence": {
-    "additionalProperties": false,
-    "properties": {
-      "level": {
-        "enum": [
-          "insufficient",
-          "low",
-          "medium",
-          "high"
-        ],
-        "type": "string"
-      },
-      "reasons": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "score": {
-        "maximum": 1,
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "score",
-      "level",
-      "reasons"
-    ],
-    "type": "object"
-  },
-  "currency": {
-    "const": "OMR",
-    "type": "string"
-  },
-  "dataQuality": {
-    "additionalProperties": false,
-    "properties": {
-      "dataFreshnessDays": {
-        "anyOf": [
-          {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "latestDataDate": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "sampleSize": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      },
-      "sourceTypes": {
-        "items": {
-          "enum": [
-            "official_statistics",
-            "listing_asking_price",
-            "manual_benchmark",
-            "partner_feed"
-          ],
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "staleMarketData": {
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "latestDataDate",
-      "dataFreshnessDays",
-      "sampleSize",
-      "sourceTypes",
-      "staleMarketData"
-    ],
-    "type": "object"
-  },
-  "historicalSalesContext": {
-    "additionalProperties": false,
-    "properties": {
-      "available": {
-        "type": "boolean"
-      },
-      "latestRecordDate": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "medianHistoricalPricePerSqmOMR": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "oldestRecordDate": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "phaseBreakdown": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "latestRecordDate": {
-              "type": "string"
-            },
-            "medianPriceOMR": {
-              "type": "number"
-            },
-            "medianPricePerSqmOMR": {
-              "type": "number"
-            },
-            "oldestRecordDate": {
-              "type": "string"
-            },
-            "phaseName": {
-              "type": "string"
-            },
-            "recordCount": {
-              "maximum": 9007199254740991,
-              "minimum": -9007199254740991,
-              "type": "integer"
-            }
-          },
-          "required": [
-            "phaseName",
-            "recordCount",
-            "medianPriceOMR",
-            "medianPricePerSqmOMR",
-            "oldestRecordDate",
-            "latestRecordDate"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "priceSemantics": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "recentComparableSales": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      },
-      "recentMedianPricePerSqmOMR": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "recordsAvailable": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      },
-      "sourceTypes": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "available",
-      "recordsAvailable",
-      "recentComparableSales",
-      "medianHistoricalPricePerSqmOMR",
-      "recentMedianPricePerSqmOMR",
-      "oldestRecordDate",
-      "latestRecordDate",
-      "sourceTypes",
-      "priceSemantics",
-      "phaseBreakdown"
-    ],
-    "type": "object"
-  },
-  "insufficientMarketData": {
-    "type": "boolean"
-  },
-  "investment": {
-    "additionalProperties": false,
-    "properties": {
-      "estimatedNetIncomeOMR": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "estimatedOperatingCostOMR": {
-        "type": "number"
-      },
-      "grossYieldPct": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "netYieldPct": {
-        "type": [
-          "number",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "grossYieldPct",
-      "estimatedOperatingCostOMR",
-      "estimatedNetIncomeOMR",
-      "netYieldPct"
-    ],
-    "type": "object"
-  },
-  "market": {
-    "additionalProperties": false,
-    "properties": {
-      "comparableCount": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      },
-      "dataFreshnessDays": {
-        "anyOf": [
-          {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "estimatedAnnualRentOMR": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "estimatedMonthlyRentOMR": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "high": {
-                "type": "number"
-              },
-              "low": {
-                "type": "number"
-              },
-              "median": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "low",
-              "median",
-              "high"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "sampleSizeUsed": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "estimatedMonthlyRentOMR",
-      "estimatedAnnualRentOMR",
-      "comparableCount",
-      "sampleSizeUsed",
-      "dataFreshnessDays"
-    ],
-    "type": "object"
-  },
-  "normalizedLocation": {
-    "additionalProperties": false,
-    "properties": {
-      "area": {
-        "type": "string"
-      },
-      "governorate": {
-        "type": "string"
-      },
-      "inputArea": {
-        "type": "string"
-      },
-      "matchType": {
-        "enum": [
-          "exact",
-          "alias",
-          "unmatched"
-        ],
-        "type": "string"
-      },
-      "supported": {
-        "type": "boolean"
-      },
-      "wilayat": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "governorate",
-      "wilayat",
-      "area",
-      "inputArea",
-      "matchType",
-      "supported"
-    ],
-    "type": "object"
-  },
-  "officialMarketContext": {
-    "additionalProperties": false,
-    "properties": {
-      "available": {
-        "type": "boolean"
-      },
-      "confidence": {
-        "additionalProperties": false,
-        "properties": {
-          "level": {
-            "enum": [
-              "unavailable",
-              "low",
-              "medium",
-              "high"
-            ],
-            "type": "string"
-          },
-          "reasons": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "level",
-          "reasons"
-        ],
-        "type": "object"
-      },
-      "dataFreshnessDays": {
-        "anyOf": [
-          {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "governorate": {
-        "type": "string"
-      },
-      "marketActivity": {
-        "additionalProperties": false,
-        "properties": {
-          "mortgageContracts": {
-            "anyOf": [
-              {
-                "maximum": 9007199254740991,
-                "minimum": -9007199254740991,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "saleContracts": {
-            "anyOf": [
-              {
-                "maximum": 9007199254740991,
-                "minimum": -9007199254740991,
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "tradedValueOMR": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "tradedValueOMR",
-          "saleContracts",
-          "mortgageContracts"
-        ],
-        "type": "object"
-      },
-      "period": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "provenance": {
-        "additionalProperties": false,
-        "properties": {
-          "datasetId": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "datasetTitle": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "license": {
-            "type": "string"
-          },
-          "publishedAt": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "retrievedAt": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "source": {
-            "type": "string"
-          },
-          "sourceType": {
-            "const": "official_statistics",
-            "type": "string"
-          },
-          "sourceUrl": {
-            "type": [
-              "string",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "source",
-          "sourceType",
-          "datasetId",
-          "datasetTitle",
-          "retrievedAt",
-          "publishedAt",
-          "sourceUrl",
-          "license"
-        ],
-        "type": "object"
-      },
-      "realEstatePriceIndex": {
-        "additionalProperties": false,
-        "properties": {
-          "period": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "value": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "value",
-          "period"
-        ],
-        "type": "object"
-      },
-      "reason": {
-        "anyOf": [
-          {
-            "enum": [
-              "ncsi_not_configured",
-              "no_data_for_governorate",
-              "ncsi_timeout",
-              "ncsi_malformed_response",
-              "official_source_temporarily_unavailable"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "source": {
-        "type": "string"
-      },
-      "sourceType": {
-        "const": "official_statistics",
-        "type": "string"
-      }
-    },
-    "required": [
-      "available",
-      "reason",
-      "source",
-      "sourceType",
-      "governorate",
-      "period",
-      "realEstatePriceIndex",
-      "marketActivity",
-      "dataFreshnessDays",
-      "confidence",
-      "provenance"
-    ],
-    "type": "object"
-  },
-  "pricePosition": {
-    "additionalProperties": false,
-    "properties": {
-      "askingPricePerSqmOMR": {
-        "type": "number"
-      },
-      "marketPosition": {
-        "enum": [
-          "below_market",
-          "at_market",
-          "above_market",
-          "insufficient_data"
-        ],
-        "type": "string"
-      },
-      "observedComparableRange": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "high": {
-                "type": "number"
-              },
-              "low": {
-                "type": "number"
-              },
-              "median": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "low",
-              "median",
-              "high"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "askingPricePerSqmOMR",
-      "observedComparableRange",
-      "marketPosition"
-    ],
-    "type": "object"
-  },
-  "provenance": {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "recordCount": {
-          "maximum": 9007199254740991,
-          "minimum": -9007199254740991,
-          "type": "integer"
-        },
-        "sourceDate": {
-          "type": "string"
-        },
-        "sourceName": {
-          "type": "string"
-        },
-        "sourceType": {
-          "enum": [
-            "official_statistics",
-            "listing_asking_price",
-            "manual_benchmark",
-            "partner_feed"
-          ],
-          "type": "string"
-        }
-      },
-      "required": [
-        "sourceType",
-        "sourceName",
-        "sourceDate",
-        "recordCount"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "riskFlags": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "subjectProperty": {
-    "additionalProperties": false,
-    "properties": {
-      "askingPriceOMR": {
-        "type": "number"
-      },
-      "bathrooms": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "bedrooms": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "furnished": {
-        "enum": [
-          "furnished",
-          "semi_furnished",
-          "unfurnished",
-          "unspecified"
-        ],
-        "type": "string"
-      },
-      "propertyType": {
-        "enum": [
-          "apartment",
-          "villa",
-          "townhouse"
-        ],
-        "type": "string"
-      },
-      "sizeSqm": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "propertyType",
-      "bedrooms",
-      "bathrooms",
-      "sizeSqm",
-      "askingPriceOMR",
-      "furnished"
-    ],
-    "type": "object"
-  },
-  "unavailableOutputs": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  }
-}

removedOutput schema / required

Removed value: -[
-  "normalizedLocation",
-  "subjectProperty",
-  "market",
-  "investment",
-  "pricePosition",
-  "comparablesSummary",
-  "riskFlags",
-  "confidence",
-  "provenance",
-  "assumptions",
-  "insufficientMarketData",
-  "unavailableOutputs",
-  "currency",
-  "dataQuality",
-  "historicalSalesContext",
-  "officialMarketContext"
-]

First observedSep 22, 2026

TDQS

A4.4/5.0

Behavior5/5

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

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, closed-world), and the description goes well beyond them: $0.25/call pricing, x402 paid-execution flow, unpaid calls returning payment instructions, a free preview_capability path, and caveats about data coverage with provenance/freshness metadata. This is rich operational context an agent needs.

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

Conciseness4/5

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

Front-loads purpose then uses labeled sections (When/Selection/Do not use/Input/Price) that make scanning easy. The one long sentence listing partner-supplied sales records and provenance metadata is somewhat dense but still earns its place by signaling data provenance.

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

Completeness4/5

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

For a paid, complex 11-parameter analytical tool, it covers decision context, exclusions, pricing, preview routing, and payment behavior; an output schema exists so return values need not be described. The only material omission is any parameter-level guidance, which the schema does not compensate for at 0% coverage.

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% across 11 parameters (5 required), and the description explicitly punts with 'Input is a strict JSON object; see the schema.' It hints at operating-cost analysis (mapping loosely to the two optional cost fields) and Al Mouj/Muscat for area, but explains no parameter formats, units, or required-vs-optional distinction, leaving the gap unfilled.

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

Purpose5/5

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

States a specific verb and resource ('Analyze an Oman residential property') and enumerates the analytical dimensions (rental comparables, market context, investment metrics, sale-price positioning, operating costs). It clearly distinguishes itself from the generic analyze_property and property_investment_report siblings by being Oman/Al Mouj Muscat-specific.

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

Usage Guidelines5/5

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

Contains explicit 'When' (Oman rental/yield/sale positioning, especially Al Mouj Muscat), 'Selection' (primary; prefer for Oman-specific with local comparables), and 'Do not use' clauses (property outside supported Oman market, simple yield with supplied numbers). This is the full when/when-not/alternative structure.

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

All Rafid Intelligence Network 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.