analyze_property

Calculate gross/net rental yield, income, operating costs and simple payback in OMR. Calculations only.

When to use

Use when an agent needs financial metrics (yield, income, payback) for a single property.

Selection guidance

Role: supporting. simple single-property yield, income and payback arithmetic

Not for: live Oman market comparables; multi-property portfolio screening; company risk

Use cases

• property investment analysis
• rental yield check
• single-property evaluation
• buy vs. hold financial screening

Access

• REST: POST https://api.rafidsystem.com/api/v1/property/analyze
• x402: POST https://api.rafidsystem.com/api/v1/x402/property/analyze
• MCP tool: analyze_property

Price: $0.01 USD per call. Payment options are deployment-configured; inspect /api/v1/payment-methods. Prices and payment semantics are unchanged from the canonical registry.

Related tools

• compare_properties
• portfolio_screen
• property_investment_report
• estimate_maintenance

Example input

{
  "propertyValue": 85000,
  "annualRent": 7200,
  "serviceCharge": 650,
  "maintenanceCost": 400
}

Example output

{
  "propertyValue": 85000,
  "annualRent": 7200,
  "grossAnnualIncome": 7200,
  "grossYield": 8.47,
  "netYield": 7.24,
  "annualOperatingCost": 1050,
  "annualNetIncome": 6150,
  "effectiveAnnualRent": 7200,
  "paybackYears": 13.82,
  "grossYieldPct": 8.47,
  "netYieldPct": 7.24,
  "annualOperatingCosts": 1050,
  "currency": "OMR",
  "note": "Calculations only; excludes financing, taxes, transaction fees and capital appreciation."
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "propertyValue": {
      "type": "number",
      "minimum": 0.01,
      "maximum": 1000000000000
    },
    "annualRent": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000000
    },
    "serviceCharge": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000000
    },
    "maintenanceCost": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000000
    },
    "maintenance": {
      "description": "Legacy alias for maintenanceCost; supply only one",
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000000
    },
    "vacancyRatePct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "otherAnnualCosts": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000000
    }
  },
  "required": [
    "propertyValue",
    "annualRent"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "propertyValue": {
      "type": "number"
    },
    "annualRent": {
      "type": "number"
    },
    "grossAnnualIncome": {
      "type": "number"
    },
    "grossYield": {
      "type": "number"
    },
    "netYield": {
      "type": "number"
    },
    "annualOperatingCost": {
      "type": "number"
    },
    "annualNetIncome": {
      "type": "number"
    },
    "effectiveAnnualRent": {
      "type": "number"
    },
    "paybackYears": {
      "type": [
        "number",
        "null"
      ]
    },
    "grossYieldPct": {
      "type": "number"
    },
    "netYieldPct": {
      "type": "number"
    },
    "annualOperatingCosts": {
      "type": "number"
    },
    "currency": {
      "type": "string",
      "const": "OMR"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "propertyValue",
    "annualRent",
    "grossAnnualIncome",
    "grossYield",
    "netYield",
    "annualOperatingCost",
    "annualNetIncome",
    "effectiveAnnualRent",
    "paybackYears",
    "grossYieldPct",
    "netYieldPct",
    "annualOperatingCosts",
    "currency",
    "note"
  ],
  "additionalProperties": false
}

Category: Property Intelligence · hierarchy: supporting · idempotent: yes · side effects: no