property_investment_report

Combine Oman property market comparables, price positioning and rental-yield calculations into one investment report.

When to use

Use when an agent needs one structured investment analysis for a property rather than separate market and calculator calls.

Selection guidance

Role: specialized. Use when an agent needs one structured investment analysis for a property rather than separate market and calculator calls.

Use cases

• property investment report
• real estate investment analysis
• Oman property valuation
• rental yield report

Access

• REST: POST https://api.rafidsystem.com/api/v1/property/property-investment-report
• x402: POST https://api.rafidsystem.com/api/v1/x402/property/property-investment-report
• MCP tool: property_investment_report

Price: $0.75 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

• analyze_property
• compare_properties
• portfolio_screen
• estimate_maintenance

Example input

{
  "property": {
    "governorate": "Muscat",
    "wilayat": "Bawshar",
    "area": "Al Khuwair",
    "propertyType": "apartment",
    "bedrooms": 2,
    "bathrooms": 2,
    "sizeSqm": 110,
    "askingPriceOMR": 85000
  }
}

Example output

{
  "workflow": "property_investment_report",
  "result": {
    "market": {},
    "investment": {}
  },
  "limitations": [
    "Market data coverage, freshness and provenance remain those reported by analyze_oman_property.",
    "Investment calculations are estimates and not investment advice."
  ]
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "property": {
      "type": "object",
      "properties": {
        "governorate": {
          "type": "string",
          "minLength": 1,
          "maxLength": 60
        },
        "wilayat": {
          "type": "string",
          "minLength": 1,
          "maxLength": 60
        },
        "area": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "propertyType": {
          "type": "string",
          "enum": [
            "apartment",
            "villa",
            "townhouse"
          ]
        },
        "bedrooms": {
          "type": "integer",
          "minimum": 0,
          "maximum": 20
        },
        "bathrooms": {
          "type": "integer",
          "minimum": 0,
          "maximum": 20
        },
        "sizeSqm": {
          "type": "number",
          "minimum": 10,
          "maximum": 5000
        },
        "askingPriceOMR": {
          "type": "number",
          "minimum": 1000,
          "maximum": 1000000000
        },
        "furnished": {
          "type": "string",
          "enum": [
            "furnished",
            "semi_furnished",
            "unfurnished"
          ]
        },
        "optionalAnnualServiceChargeOMR": {
          "type": "number",
          "minimum": 0,
          "maximum": 1000000000
        },
        "optionalAnnualMaintenanceOMR": {
          "type": "number",
          "minimum": 0,
          "maximum": 1000000000
        }
      },
      "required": [
        "governorate",
        "area",
        "propertyType",
        "sizeSqm",
        "askingPriceOMR"
      ],
      "additionalProperties": false
    },
    "financials": {
      "type": "object",
      "properties": {
        "propertyValue": {
          "type": "number",
          "minimum": 0
        },
        "annualRent": {
          "type": "number",
          "minimum": 0
        },
        "serviceCharge": {
          "type": "number",
          "minimum": 0
        },
        "maintenanceCost": {
          "type": "number",
          "minimum": 0
        },
        "maintenance": {
          "type": "number",
          "minimum": 0
        },
        "vacancyRatePct": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "otherAnnualCosts": {
          "type": "number",
          "minimum": 0
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "property"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "workflow": {
      "type": "string"
    },
    "result": {},
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "workflow",
    "result",
    "limitations"
  ],
  "additionalProperties": false
}

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