analyze_oman_company

Generate deterministic commercial-intelligence signals, risk flags and positive signals for one Oman company by companyId, for a stated evaluation purpose.

When to use

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.

Selection guidance

Role: supporting. 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.

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.

Related tools

Example input

{
  "companyId": "demo-co-1",
  "purpose": "supplier"
}

Example output

{
  "companyId": "demo-co-1",
  "commercialSignals": {
    "yearsActive": 11,
    "operatingStatus": "active",
    "digitalPresenceScore": 100,
    "dataCompletenessScore": 100,
    "businessMaturity": "established",
    "governmentProcurementActivity": "none"
  },
  "riskFlags": [],
  "positiveSignals": [
    "Active company status",
    "Established website",
    "Several years of operating history (11+ years)",
    "Registered VAT number on file",
    "Comprehensive public information available",
    "Multiple public contact channels on file"
  ],
  "recommendedChecks": [
    "Request commercial registration copy",
    "Verify VAT registration",
    "Request recent financial statements"
  ],
  "confidence": 0.34,
  "confidenceReasons": [
    "This record is backed only by the curated demo dataset — not a real registry, website or directory source.",
    "2 distinct source(s) contributed to this record (target is 3+ for full confidence on this factor).",
    "Data completeness is 100%.",
    "Most recent contributing source is 10 day(s) old."
  ],
  "dataCoverage": {
    "realSources": 0,
    "demoSources": 2,
    "latestVerifiedAt": null
  },
  "sources": [
    {
      "sourceName": "alnoortrading.om (demo)",
      "sourceType": "demo",
      "sourceAuthority": 0.1,
      "sourceUrl": "https://alnoortrading.om/about",
      "sourceRecordId": null,
      "observedAt": "2026-09-11",
      "verificationStatus": "unknown",
      "fields": [
        "companyName",
        "normalizedName",
        "registrationNumber",
        "legalType",
        "status",
        "industry",
        "governorate",
        "wilayat",
        "area",
        "website",
        "email",
        "phone"
      ]
    },
    {
      "sourceName": "Oman Ministry of Commerce, Industry and Investment Promotion (demo)",
      "sourceType": "demo",
      "sourceAuthority": 0.1,
      "sourceUrl": "https://example-registry.om/companies/1010123456",
      "sourceRecordId": "MOCIIP-1010123456",
      "observedAt": "2026-08-07",
      "verificationStatus": "unknown",
      "fields": [
        "registrationDate",
        "activities",
        "address",
        "vatNumber",
        "vatStatus",
        "employeeRange",
        "estimatedCompanySize"
      ]
    }
  ]
}

Input schema

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

Output schema

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

Category: Company & Risk Intelligence · hierarchy: supporting · idempotent: yes · side effects: no