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: primary. Use when an agent needs one structured investment analysis for a property rather than separate market and calculator calls.

Use cases

Access

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.

Get the full result

0.75 USD per call

Save with Monthly Plans & API Key Billing: Pay $0.75 per call, or get an instant API key at https://api.rafidsystem.com/get-started and save with monthly plans starting at $10/mo (1,000 calls) and Growth $50/mo (10,000 calls). See https://api.rafidsystem.com/api/v1/subscription-plans. View monthly plans · Payment methods
Pay with USDC · request an x402 challenge
curl -X POST 'https://api.rafidsystem.com/api/v1/x402/property/property-investment-report' -H 'Content-Type: application/json' --data '{"property":{"governorate":"Muscat","wilayat":"Bawshar","area":"Al Khuwair","propertyType":"apartment","bedrooms":2,"bathrooms":2,"sizeSqm":110,"askingPriceOMR":85000}}'
Authorized x402 client · signed retry request
curl -X POST 'https://api.rafidsystem.com/api/v1/x402/property/property-investment-report' -H 'Content-Type: application/json' -H 'PAYMENT-SIGNATURE: <PAYMENT_SIGNATURE_FROM_AUTHORIZED_CLIENT>' -H 'X-Rafid-Payment-Journey: <PAYMENT_JOURNEY_FROM_CHALLENGE>' -H 'Idempotency-Key: <UNIQUE_REQUEST_ID>' --data '{"property":{"governorate":"Muscat","wilayat":"Bawshar","area":"Al Khuwair","propertyType":"apartment","bedrooms":2,"bathrooms":2,"sizeSqm":110,"askingPriceOMR":85000}}'

Use an x402-compatible client to parse PAYMENT-REQUIRED and authorize payment before retrying the same input with PAYMENT-SIGNATURE. Copying a request does not pay.

No crypto wallet? Use Rafid Credits
curl -X POST 'https://api.rafidsystem.com/api/v1/property/property-investment-report' -H 'Content-Type: application/json' -H 'Authorization: Bearer <RAFID_API_KEY>' -H 'X-Rafid-Payment-Method: credits' -H 'Idempotency-Key: <UNIQUE_REQUEST_ID>' -H 'X-Rafid-Payment-Journey: <PAYMENT_JOURNEY_FROM_CHALLENGE>' --data '{"property":{"governorate":"Muscat","wilayat":"Bawshar","area":"Al Khuwair","propertyType":"apartment","bedrooms":2,"bathrooms":2,"sizeSqm":110,"askingPriceOMR":85000}}'

Create an API key instantly via POST https://api.rafidsystem.com/api/v1/account/signup or at https://api.rafidsystem.com/get-started, then fund by card (Stripe) or USDC and save with monthly plans ($10–$500/mo).

Existing account balance: GET https://api.rafidsystem.com/api/v1/account/balance.

MCP Credits integration
POST https://api.rafidsystem.com/mcp/credits
Authorization: Bearer <OAUTH_ACCESS_TOKEN>
Idempotency-Key: <UNIQUE_REQUEST_ID>
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "property_investment_report",
    "arguments": {
      "property": {
        "governorate": "Muscat",
        "wilayat": "Bawshar",
        "area": "Al Khuwair",
        "propertyType": "apartment",
        "bedrooms": 2,
        "bathrooms": 2,
        "sizeSqm": 110,
        "askingPriceOMR": 85000
      }
    }
  }
}

OAuth metadata: authorization server · protected resource. Operator authorization and an existing funded account are required; OAuth does not grant credits.

Payment instructions and onboarding · API docs and schemas

These are copyable API integration requests. They do not open a checkout or execute a paid tool.

Related tools

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: primary · idempotent: yes · side effects: no