Rafid Property Intelligence

Oman property intelligence for AI agents: yield, comparables, Al Mouj sales data, x402 pay-per-call.

Should I use this

Quality & Safety

A
Description quality
96%
Schema completeness
81%
Naming quality
93%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (1)

  • LOWTool 'compare_properties' description lacks action verbin compare_properties

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~7,544Tokens (tool definitions)
~10.5 KBTypical response size
Significant attention impact (5.89% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "rafid-agent-api": {
      "url": "https://api.rafidsystem.com/mcp"
    }
  }
}

Remote endpoints

https://api.rafidsystem.com/mcpstreamable-http

What it can do

Tool inventory

Tools (8)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢analyze_property(propertyValue, annualRent, serviceCharge, maintenanceCost, maintenance, ...)

Calculate gross/net rental yield, income, operating costs and simple payback in OMR. Calculations only. Use when an agent needs financial metrics (yield, income, payback) for a single property.

Input 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"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Output 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"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢compare_properties(properties)

Compare 2–20 uniquely named properties in OMR using the same metrics; order by rounded net yield, preserving input order for ties. Use when an agent must rank or choose between 2-20 candidate properties by net yield.

Input Schema

{
  "type": "object",
  "properties": {
    "properties": {
      "minItems": 2,
      "maxItems": 20,
      "type": "array",
      "items": {
        "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
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120
          }
        },
        "required": [
          "propertyValue",
          "annualRent",
          "name"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "properties"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "properties": {
      "type": "array",
      "items": {
        "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"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "propertyValue",
          "annualRent",
          "grossAnnualIncome",
          "grossYield",
          "netYield",
          "annualOperatingCost",
          "annualNetIncome",
          "effectiveAnnualRent",
          "paybackYears",
          "grossYieldPct",
          "netYieldPct",
          "annualOperatingCosts",
          "currency",
          "note",
          "name"
        ],
        "additionalProperties": false
      }
    },
    "sortedByNetYield": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "properties",
    "sortedByNetYield"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢estimate_maintenance(propertyValue, ageYears, units, annualRent, assumptions)

Estimate an annual maintenance reserve in OMR from value, age and unit count with explicit optional assumptions. Uncalibrated heuristic, not a survey. Use when an agent needs an annual maintenance reserve estimate for a property, not an actual inspection.

Input Schema

{
  "type": "object",
  "properties": {
    "propertyValue": {
      "type": "number",
      "minimum": 0.01,
      "maximum": 1000000000000
    },
    "ageYears": {
      "type": "number",
      "minimum": 0,
      "maximum": 200
    },
    "units": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000
    },
    "annualRent": {
      "description": "Legacy input; unused in this value-based estimate",
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000000
    },
    "assumptions": {
      "type": "object",
      "properties": {
        "annualRatePct": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "additionalUnitCost": {
          "type": "number",
          "minimum": 0,
          "maximum": 1000000000000
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "propertyValue"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "estimatedAnnualMaintenance": {
      "type": "number"
    },
    "monthlyReserve": {
      "type": "number"
    },
    "maintenancePercentage": {
      "type": "number"
    },
    "currency": {
      "type": "string",
      "const": "OMR"
    },
    "assumptionsUsed": {
      "type": "object",
      "properties": {
        "ageYears": {
          "type": "number"
        },
        "units": {
          "type": "number"
        },
        "annualRatePct": {
          "type": "number"
        },
        "additionalUnitCost": {
          "type": "number"
        }
      },
      "required": [
        "ageYears",
        "units",
        "annualRatePct",
        "additionalUnitCost"
      ],
      "additionalProperties": false
    },
    "methodology": {
      "type": "string"
    }
  },
  "required": [
    "estimatedAnnualMaintenance",
    "monthlyReserve",
    "maintenancePercentage",
    "currency",
    "assumptionsUsed",
    "methodology"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢analyze_oman_property(governorate, wilayat, area, propertyType, bedrooms, ...)

Analyze an Oman residential property using local rental comparables, market context and investment metrics. Use when an agent needs Oman-specific rental, yield, price-position or operating-cost analysis.

Input Schema

{
  "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"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Output Schema

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

Search structured Oman business records by name, registration number, governorate, wilayat and/or industry, returning candidate companies ranked by deterministic identity-match confidence. Use before company analysis or due diligence when the exact company identity is uncertain, or to find candidate Oman companies matching a name or registration number.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "governorate": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "wilayat": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "industry": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "matches": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "companyId": {
            "type": "string"
          },
          "companyName": {
            "type": "string"
          },
          "normalizedName": {
            "type": "string"
          },
          "legalType": {
            "type": [
              "string",
              "null"
            ]
          },
          "industry": {
            "type": [
              "string",
              "null"
            ]
          },
          "governorate": {
            "type": [
              "string",
              "null"
            ]
          },
          "wilayat": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": [
              "string",
              "null"
            ]
          },
          "website": {
            "type": [
              "string",
              "null"
            ]
          },
          "confidence": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          }
        },
        "required": [
          "companyId",
          "companyName",
          "normalizedName",
          "legalType",
          "industry",
          "governorate",
          "wilayat",
          "status",
          "website",
          "confidence"
        ],
        "additionalProperties": false
      }
    },
    "totalMatches": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "matches",
    "totalMatches"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_oman_company_profile(companyId)

Return a structured profile for one Oman company by companyId — identity, registration, location and contact fields, digital-presence detection and full source provenance. Use after search_oman_company resolves a companyId, to retrieve the company's structured profile before deciding whether deeper analysis or due diligence is warranted.

Input Schema

{
  "type": "object",
  "properties": {
    "companyId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    }
  },
  "required": [
    "companyId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "company": {
      "type": "object",
      "properties": {
        "companyId": {
          "type": "string"
        },
        "companyName": {
          "type": "string"
        },
        "legalType": {
          "type": [
            "string",
            "null"
          ]
        },
        "status": {
          "type": [
            "string",
            "null"
          ]
        },
        "registrationNumber": {
          "type": [
            "string",
            "null"
          ]
        },
        "registrationDate": {
          "type": [
            "string",
            "null"
          ]
        },
        "industry": {
          "type": [
            "string",
            "null"
          ]
        },
        "activities": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "governorate": {
          "type": [
            "string",
            "null"
          ]
        },
        "wilayat": {
          "type": [
            "string",
            "null"
          ]
        },
        "address": {
          "type": [
            "string",
            "null"
          ]
        },
        "website": {
          "type": [
            "string",
            "null"
          ]
        },
        "email": {
          "type": [
            "string",
            "null"
          ]
        },
        "phone": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "companyId",
        "companyName",
        "legalType",
        "status",
        "registrationNumber",
        "registrationDate",
        "industry",
        "activities",
        "governorate",
        "wilayat",
        "address",
        "website",
        "email",
        "phone"
      ],
      "additionalProperties": false
    },
    "digitalPresence": {
      "type": "object",
      "properties": {
        "websiteFound": {
          "type": "boolean"
        },
        "domain": {
          "type": [
            "string",
            "null"
          ]
        },
        "socialProfiles": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "websiteFound",
        "domain",
        "socialProfiles"
      ],
      "additionalProperties": false
    },
    "verification": {
      "type": "object",
      "properties": {
        "verificationStatus": {
          "type": "string",
          "enum": [
            "verified",
            "reported",
            "estimated",
            "inferred",
            "stale",
            "conflicting",
            "unknown"
          ]
        },
        "lastVerifiedAt": {
          "type": [
            "string",
            "null"
          ]
        },
        "taxVerificationStatus": {
          "type": [
            "string",
            "null"
          ]
        },
        "taxVerifiedAt": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "verificationStatus",
        "lastVerifiedAt",
        "taxVerificationStatus",
        "taxVerifiedAt"
      ],
      "additionalProperties": false
    },
    "procurement": {
      "type": "object",
      "properties": {
        "registeredSupplier": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "supplierCategory": {
          "type": [
            "string",
            "null"
          ]
        },
        "supplierClassification": {
          "type": [
            "string",
            "null"
          ]
        },
        "governmentProcurementPresence": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "tendersParticipated": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "awardedContractCount": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "lastTenderActivityAt": {
          "type": [
            "string",
            "null"
          ]
        },
        "awards": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "tenderNumber": {
                "type": "string"
              },
              "buyer": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "title": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "status": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "awardValueOMR": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "category": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "sourceName": {
                "type": "string"
              },
              "observedAt": {
                "type": "string"
              }
            },
            "required": [
              "tenderNumber",
              "buyer",
              "title",
              "status",
              "awardValueOMR",
              "category",
              "sourceName",
              "observedAt"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "registeredSupplier",
        "supplierCategory",
        "supplierClassification",
        "governmentProcurementPresence",
        "tendersParticipated",
        "awardedContractCount",
        "lastTenderActivityAt",
        "awards"
      ],
      "additionalProperties": false
    },
    "dataCoverage": {
      "type": "object",
      "properties": {
        "realSources": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "demoSources": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "latestVerifiedAt": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "realSources",
        "demoSources",
        "latestVerifiedAt"
      ],
      "additionalProperties": false
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "sourceName": {
            "type": "string"
          },
          "sourceType": {
            "type": "string",
            "enum": [
              "government",
              "public_registry",
              "tax_authority",
              "government_procurement",
              "company_website",
              "licensed_feed",
              "directory",
              "news",
              "demo",
              "other",
              "admin_manual"
            ]
          },
          "sourceAuthority": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "sourceUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "sourceRecordId": {
            "type": [
              "string",
              "null"
            ]
          },
          "observedAt": {
            "type": "string"
          },
          "verificationStatus": {
            "type": "string",
            "enum": [
              "verified",
              "reported",
              "estimated",
              "inferred",
              "stale",
              "conflicting",
              "unknown"
            ]
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "sourceName",
          "sourceType",
          "sourceAuthority",
          "sourceUrl",
          "sourceRecordId",
          "observedAt",
          "verificationStatus",
          "fields"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "company",
    "digitalPresence",
    "verification",
    "procurement",
    "dataCoverage",
    "sources"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢analyze_oman_company(companyId, purpose)

Generate deterministic commercial-intelligence signals, risk flags and positive signals for one Oman company by companyId, for a stated evaluation purpose. Use when an agent needs to assess whether an Oman company looks like a serious, established operating business — as a supplier, customer, partner or investment target.

Input Schema

{
  "type": "object",
  "properties": {
    "companyId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "purpose": {
      "type": "string",
      "enum": [
        "general",
        "supplier",
        "customer",
        "partner",
        "investor"
      ]
    }
  },
  "required": [
    "companyId",
    "purpose"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "companyId": {
      "type": "string"
    },
    "commercialSignals": {
      "type": "object",
      "properties": {
        "yearsActive": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "operatingStatus": {
          "type": "string"
        },
        "digitalPresenceScore": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        },
        "dataCompletenessScore": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        },
        "businessMaturity": {
          "type": "string",
          "enum": [
            "new",
            "early_stage",
            "growing",
            "established"
          ]
        },
        "governmentProcurementActivity": {
          "type": "string",
          "enum": [
            "active",
            "limited",
            "none"
          ]
        }
      },
      "required": [
        "yearsActive",
        "operatingStatus",
        "digitalPresenceScore",
        "dataCompletenessScore",
        "businessMaturity",
        "governmentProcurementActivity"
      ],
      "additionalProperties": false
    },
    "riskFlags": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "severity": {
            "type": "string",
            "enum": [
              "low",
              "medium",
              "high"
            ]
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "code",
          "severity",
          "message"
        ],
        "additionalProperties": false
      }
    },
    "positiveSignals": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "recommendedChecks": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "confidenceReasons": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "dataCoverage": {
      "type": "object",
      "properties": {
        "realSources": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "demoSources": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "latestVerifiedAt": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "realSources",
        "demoSources",
        "latestVerifiedAt"
      ],
      "additionalProperties": false
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "sourceName": {
            "type": "string"
          },
          "sourceType": {
            "type": "string",
            "enum": [
              "government",
              "public_registry",
              "tax_authority",
              "government_procurement",
              "company_website",
              "licensed_feed",
              "directory",
              "news",
              "demo",
              "other",
              "admin_manual"
            ]
          },
          "sourceAuthority": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "sourceUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "sourceRecordId": {
            "type": [
              "string",
              "null"
            ]
          },
          "observedAt": {
            "type": "string"
          },
          "verificationStatus": {
            "type": "string",
            "enum": [
              "verified",
              "reported",
              "estimated",
              "inferred",
              "stale",
              "conflicting",
              "unknown"
            ]
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "sourceName",
          "sourceType",
          "sourceAuthority",
          "sourceUrl",
          "sourceRecordId",
          "observedAt",
          "verificationStatus",
          "fields"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "companyId",
    "commercialSignals",
    "riskFlags",
    "positiveSignals",
    "recommendedChecks",
    "confidence",
    "confidenceReasons",
    "dataCoverage",
    "sources"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢due_diligence_oman_company(companyId, transactionType, transactionValueOMR)

Perform structured commercial due diligence on one Oman company by companyId ahead of a stated transaction, returning identity verification, risk assessment, a prioritized due-diligence checklist and known information gaps. Use before awarding a contract, entering a partnership, extending credit or investing, when a structured, source-backed due-diligence pass is needed ahead of the decision.

Input Schema

{
  "type": "object",
  "properties": {
    "companyId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "transactionType": {
      "type": "string",
      "enum": [
        "supplier_contract",
        "partnership",
        "investment",
        "customer_credit",
        "other"
      ]
    },
    "transactionValueOMR": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000
    }
  },
  "required": [
    "companyId",
    "transactionType"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "company": {
      "type": "object",
      "properties": {
        "companyId": {
          "type": "string"
        },
        "companyName": {
          "type": "string"
        },
        "legalType": {
          "type": [
            "string",
            "null"
          ]
        },
        "status": {
          "type": [
            "string",
            "null"
          ]
        },
        "registrationNumber": {
          "type": [
            "string",
            "null"
          ]
        },
        "registrationDate": {
          "type": [
            "string",
            "null"
          ]
        },
        "industry": {
          "type": [
            "string",
            "null"
          ]
        },
        "activities": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "governorate": {
          "type": [
            "string",
            "null"
          ]
        },
        "wilayat": {
          "type": [
            "string",
            "null"
          ]
        },
        "address": {
          "type": [
            "string",
            "null"
          ]
        },
        "website": {
          "type": [
            "string",
            "null"
          ]
        },
        "email": {
          "type": [
            "string",
            "null"
          ]
        },
        "phone": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "companyId",
        "companyName",
        "legalType",
        "status",
        "registrationNumber",
        "registrationDate",
        "industry",
        "activities",
        "governorate",
        "wilayat",
        "address",
        "website",
        "email",
        "phone"
      ],
      "additionalProperties": false
    },
    "verification": {
      "type": "object",
      "properties": {
        "identityVerified": {
          "type": "boolean"
        },
        "status": {
          "type": [
            "string",
            "null"
          ]
        },
        "registrationAgeYears": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "verificationStatus": {
          "type": "string",
          "enum": [
            "verified",
            "reported",
            "estimated",
            "inferred",
            "stale",
            "conflicting",
            "unknown"
          ]
        },
        "lastVerifiedAt": {
          "type": [
            "string",
            "null"
          ]
        },
        "taxVerificationStatus": {
          "type": [
            "string",
            "null"
          ]
        },
        "taxVerifiedAt": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "identityVerified",
        "status",
        "registrationAgeYears",
        "verificationStatus",
        "lastVerifiedAt",
        "taxVerificationStatus",
        "taxVerifiedAt"
      ],
      "additionalProperties": false
    },
    "procurement": {
      "type": "object",
      "properties": {
        "registeredSupplier": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "supplierCategory": {
          "type": [
            "string",
            "null"
          ]
        },
        "supplierClassification": {
          "type": [
            "string",
            "null"
          ]
        },
        "governmentProcurementPresence": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "tendersParticipated": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "awardedContractCount": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "lastTenderActivityAt": {
          "type": [
            "string",
            "null"
          ]
        },
        "awards": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "tenderNumber": {
                "type": "string"
              },
              "buyer": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "title": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "status": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "awardValueOMR": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "category": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "sourceName": {
                "type": "string"
              },
              "observedAt": {
                "type": "string"
              }
            },
            "required": [
              "tenderNumber",
              "buyer",
              "title",
              "status",
              "awardValueOMR",
              "category",
              "sourceName",
              "observedAt"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "registeredSupplier",
        "supplierCategory",
        "supplierClassification",
        "governmentProcurementPresence",
        "tendersParticipated",
        "awardedContractCount",
        "lastTenderActivityAt",
        "awards"
      ],
      "additionalProperties": false
    },
    "commercialAssessment": {
      "type": "object",
      "properties": {
        "operationalMaturity": {
          "type": "string",
          "enum": [
            "new",
            "early_stage",
            "growing",
            "established"
          ]
        },
        "digitalFootprint": {
          "type": "string",
          "enum": [
            "strong",
            "moderate",
            "weak",
            "none"
          ]
        },
        "publicInformationCoverage": {
          "type": "string",
          "enum": [
            "high",
            "medium",
            "low"
          ]
        },
        "governmentProcurementActivity": {
          "type": "string",
          "enum": [
            "active",
            "limited",
            "none"
          ]
        }
      },
      "required": [
        "operationalMaturity",
        "digitalFootprint",
        "publicInformationCoverage",
        "governmentProcurementActivity"
      ],
      "additionalProperties": false
    },
    "riskAssessment": {
      "type": "object",
      "properties": {
        "riskLevel": {
          "type": "string",
          "enum": [
            "low",
            "medium",
            "high"
          ]
        },
        "riskScore": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        },
        "riskFlags": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "severity": {
                "type": "string",
                "enum": [
                  "low",
                  "medium",
                  "high"
                ]
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "code",
              "severity",
              "message"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "riskLevel",
        "riskScore",
        "riskFlags"
      ],
      "additionalProperties": false
    },
    "recommendedDueDiligence": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "check": {
            "type": "string"
          },
          "importance": {
            "type": "string",
            "enum": [
              "low",
              "medium",
              "high"
            ]
          }
        },
        "required": [
          "check",
          "importance"
        ],
        "additionalProperties": false
      }
    },
    "missingInformation": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "confidenceReasons": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "dataCoverage": {
      "type": "object",
      "properties": {
        "realSources": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "demoSources": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "latestVerifiedAt": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "realSources",
        "demoSources",
        "latestVerifiedAt"
      ],
      "additionalProperties": false
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "sourceName": {
            "type": "string"
          },
          "sourceType": {
            "type": "string",
            "enum": [
              "government",
              "public_registry",
              "tax_authority",
              "government_procurement",
              "company_website",
              "licensed_feed",
              "directory",
              "news",
              "demo",
              "other",
              "admin_manual"
            ]
          },
          "sourceAuthority": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "sourceUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "sourceRecordId": {
            "type": [
              "string",
              "null"
            ]
          },
          "observedAt": {
            "type": "string"
          },
          "verificationStatus": {
            "type": "string",
            "enum": [
              "verified",
              "reported",
              "estimated",
              "inferred",
              "stale",
              "conflicting",
              "unknown"
            ]
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "sourceName",
          "sourceType",
          "sourceAuthority",
          "sourceUrl",
          "sourceRecordId",
          "observedAt",
          "verificationStatus",
          "fields"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "company",
    "verification",
    "procurement",
    "commercialAssessment",
    "riskAssessment",
    "recommendedDueDiligence",
    "missingInformation",
    "confidence",
    "confidenceReasons",
    "dataCoverage",
    "sources"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded8 tools