analyze_company_risk

Gather evidence-tiered risk signals for a company across corporate identity, domain, website, sanctions-list name-matching, adverse news, reputation and legal/regulatory signals — never a safe/unsafe verdict.

When to use

Use when an agent needs risk evidence to weigh before a transaction, partnership, or onboarding decision — not a substitute for compliance/legal sign-off.

Selection guidance

Role: specialized. Use when an agent needs risk evidence to weigh before a transaction, partnership, or onboarding decision — not a substitute for compliance/legal sign-off.

Use cases

Access

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

{
  "company": "Acme Corporation",
  "website": "https://acme.example.com"
}

Example output

{
  "company": {
    "name": "Acme Corporation",
    "website": "https://acme.example.com",
    "country": null
  },
  "riskSignals": [
    {
      "type": "corporate_identity",
      "severity": "low",
      "summary": "No confident match was found in Rafid's Oman company registry data.",
      "evidence": [
        {
          "description": "No Oman registry match above the confidence threshold.",
          "source": null,
          "tier": "missing_information"
        }
      ],
      "source": null
    }
  ],
  "checks": {
    "corporateIdentity": {
      "status": "performed",
      "summary": "No confident match was found in Rafid's Oman company registry data.",
      "findings": [
        "This check only covers Oman-registered companies known to Rafid; a company outside Oman, or one not yet covered, will correctly show no match here."
      ],
      "evidence": [
        {
          "description": "No Oman registry match above the confidence threshold.",
          "source": null,
          "tier": "missing_information"
        }
      ]
    },
    "domain": {
      "status": "not_configured",
      "summary": "Live checks are not enabled for this deployment (RISK_LIVE_CHECKS_ENABLED is not true).",
      "findings": [],
      "evidence": []
    },
    "website": {
      "status": "not_configured",
      "summary": "Live checks are not enabled for this deployment (RISK_LIVE_CHECKS_ENABLED is not true).",
      "findings": [],
      "evidence": []
    },
    "sanctions": {
      "status": "not_configured",
      "summary": "Live checks are not enabled for this deployment (RISK_LIVE_CHECKS_ENABLED is not true).",
      "findings": [],
      "evidence": []
    },
    "adverseNews": {
      "status": "not_configured",
      "summary": "No web search provider is configured for this deployment.",
      "findings": [],
      "evidence": []
    },
    "securitySignals": {
      "status": "not_configured",
      "summary": "Live checks are not enabled for this deployment (RISK_LIVE_CHECKS_ENABLED is not true).",
      "findings": [],
      "evidence": []
    },
    "reputation": {
      "status": "not_configured",
      "summary": "No web search provider is configured for this deployment.",
      "findings": [],
      "evidence": []
    },
    "legalSignals": {
      "status": "not_configured",
      "summary": "No web search provider is configured for this deployment.",
      "findings": [],
      "evidence": []
    }
  },
  "sources": [],
  "confidence": 0.13,
  "limitations": [
    "Sanctions screening (when enabled) is an automated name-matching indicator only and does not constitute a legal sanctions determination — verify directly against the source list before acting.",
    "Adverse news, reputation and legal-signal findings are search results, not confirmed facts — each must be reviewed at its source.",
    "This tool never returns a safe/unsafe verdict; it returns evidence for the calling agent or a human to weigh.",
    "Corporate identity verification only covers Oman-registered companies known to Rafid; a company elsewhere, or not yet covered, correctly shows no match rather than a false negative.",
    "domain: Live checks are not enabled for this deployment (RISK_LIVE_CHECKS_ENABLED is not true).",
    "website: Live checks are not enabled for this deployment (RISK_LIVE_CHECKS_ENABLED is not true).",
    "sanctions: Live checks are not enabled for this deployment (RISK_LIVE_CHECKS_ENABLED is not true).",
    "adverse_news: No web search provider is configured for this deployment.",
    "reputation: No web search provider is configured for this deployment.",
    "legal_signals: No web search provider is configured for this deployment.",
    "security_signals: Live checks are not enabled for this deployment (RISK_LIVE_CHECKS_ENABLED is not true)."
  ],
  "cached": false,
  "dataMode": "live"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "website": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300
    },
    "country": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "checks": {
      "maxItems": 8,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "corporate_identity",
          "domain",
          "website",
          "sanctions",
          "adverse_news",
          "security_signals",
          "reputation",
          "legal_signals"
        ]
      }
    }
  },
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "company": {
      "type": "object",
      "properties": {
        "name": {
          "type": [
            "string",
            "null"
          ]
        },
        "website": {
          "type": [
            "string",
            "null"
          ]
        },
        "country": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "name",
        "website",
        "country"
      ],
      "additionalProperties": false
    },
    "riskSignals": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "corporate_identity",
              "domain",
              "website",
              "sanctions",
              "adverse_news",
              "security_signals",
              "reputation",
              "legal_signals"
            ]
          },
          "severity": {
            "type": "string",
            "enum": [
              "low",
              "medium",
              "high"
            ]
          },
          "summary": {
            "type": "string"
          },
          "evidence": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "description": {
                  "type": "string"
                },
                "source": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "tier": {
                  "type": "string",
                  "enum": [
                    "confirmed_evidence",
                    "public_allegation",
                    "automated_indicator",
                    "missing_information"
                  ]
                }
              },
              "required": [
                "description",
                "source",
                "tier"
              ],
              "additionalProperties": false
            }
          },
          "source": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "type",
          "severity",
          "summary",
          "evidence",
          "source"
        ],
        "additionalProperties": false
      }
    },
    "checks": {
      "type": "object",
      "properties": {
        "corporateIdentity": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "performed",
                "not_configured",
                "unavailable",
                "not_applicable"
              ]
            },
            "summary": {
              "type": [
                "string",
                "null"
              ]
            },
            "findings": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "evidence": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "description": {
                    "type": "string"
                  },
                  "source": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "tier": {
                    "type": "string",
                    "enum": [
                      "confirmed_evidence",
                      "public_allegation",
                      "automated_indicator",
                      "missing_information"
                    ]
                  }
                },
                "required": [
                  "description",
                  "source",
                  "tier"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "status",
            "summary",
            "findings",
            "evidence"
          ],
          "additionalProperties": false
        },
        "domain": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "performed",
                "not_configured",
                "unavailable",
                "not_applicable"
              ]
            },
            "summary": {
              "type": [
                "string",
                "null"
              ]
            },
            "findings": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "evidence": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "description": {
                    "type": "string"
                  },
                  "source": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "tier": {
                    "type": "string",
                    "enum": [
                      "confirmed_evidence",
                      "public_allegation",
                      "automated_indicator",
                      "missing_information"
                    ]
                  }
                },
                "required": [
                  "description",
                  "source",
                  "tier"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "status",
            "summary",
            "findings",
            "evidence"
          ],
          "additionalProperties": false
        },
        "website": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "performed",
                "not_configured",
                "unavailable",
                "not_applicable"
              ]
            },
            "summary": {
              "type": [
                "string",
                "null"
              ]
            },
            "findings": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "evidence": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "description": {
                    "type": "string"
                  },
                  "source": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "tier": {
                    "type": "string",
                    "enum": [
                      "confirmed_evidence",
                      "public_allegation",
                      "automated_indicator",
                      "missing_information"
                    ]
                  }
                },
                "required": [
                  "description",
                  "source",
                  "tier"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "status",
            "summary",
            "findings",
            "evidence"
          ],
          "additionalProperties": false
        },
        "sanctions": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "performed",
                "not_configured",
                "unavailable",
                "not_applicable"
              ]
            },
            "summary": {
              "type": [
                "string",
                "null"
              ]
            },
            "findings": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "evidence": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "description": {
                    "type": "string"
                  },
                  "source": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "tier": {
                    "type": "string",
                    "enum": [
                      "confirmed_evidence",
                      "public_allegation",
                      "automated_indicator",
                      "missing_information"
                    ]
                  }
                },
                "required": [
                  "description",
                  "source",
                  "tier"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "status",
            "summary",
            "findings",
            "evidence"
          ],
          "additionalProperties": false
        },
        "adverseNews": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "performed",
                "not_configured",
                "unavailable",
                "not_applicable"
              ]
            },
            "summary": {
              "type": [
                "string",
                "null"
              ]
            },
            "findings": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "evidence": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "description": {
                    "type": "string"
                  },
                  "source": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "tier": {
                    "type": "string",
                    "enum": [
                      "confirmed_evidence",
                      "public_allegation",
                      "automated_indicator",
                      "missing_information"
                    ]
                  }
                },
                "required": [
                  "description",
                  "source",
                  "tier"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "status",
            "summary",
            "findings",
            "evidence"
          ],
          "additionalProperties": false
        },
        "securitySignals": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "performed",
                "not_configured",
                "unavailable",
                "not_applicable"
              ]
            },
            "summary": {
              "type": [
                "string",
                "null"
              ]
            },
            "findings": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "evidence": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "description": {
                    "type": "string"
                  },
                  "source": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "tier": {
                    "type": "string",
                    "enum": [
                      "confirmed_evidence",
                      "public_allegation",
                      "automated_indicator",
                      "missing_information"
                    ]
                  }
                },
                "required": [
                  "description",
                  "source",
                  "tier"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "status",
            "summary",
            "findings",
            "evidence"
          ],
          "additionalProperties": false
        },
        "reputation": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "performed",
                "not_configured",
                "unavailable",
                "not_applicable"
              ]
            },
            "summary": {
              "type": [
                "string",
                "null"
              ]
            },
            "findings": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "evidence": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "description": {
                    "type": "string"
                  },
                  "source": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "tier": {
                    "type": "string",
                    "enum": [
                      "confirmed_evidence",
                      "public_allegation",
                      "automated_indicator",
                      "missing_information"
                    ]
                  }
                },
                "required": [
                  "description",
                  "source",
                  "tier"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "status",
            "summary",
            "findings",
            "evidence"
          ],
          "additionalProperties": false
        },
        "legalSignals": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "performed",
                "not_configured",
                "unavailable",
                "not_applicable"
              ]
            },
            "summary": {
              "type": [
                "string",
                "null"
              ]
            },
            "findings": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "evidence": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "description": {
                    "type": "string"
                  },
                  "source": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "tier": {
                    "type": "string",
                    "enum": [
                      "confirmed_evidence",
                      "public_allegation",
                      "automated_indicator",
                      "missing_information"
                    ]
                  }
                },
                "required": [
                  "description",
                  "source",
                  "tier"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "status",
            "summary",
            "findings",
            "evidence"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "corporateIdentity",
        "domain",
        "website",
        "sanctions",
        "adverseNews",
        "securitySignals",
        "reputation",
        "legalSignals"
      ],
      "additionalProperties": false
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": [
              "string",
              "null"
            ]
          },
          "title": {
            "type": "string"
          },
          "publisher": {
            "type": [
              "string",
              "null"
            ]
          },
          "sourceType": {
            "type": "string",
            "enum": [
              "web_search",
              "company_website",
              "news",
              "government_registry",
              "regulatory_registry",
              "sanctions_list",
              "domain_registry",
              "rafid_oman_registry",
              "not_configured"
            ]
          },
          "observedAt": {
            "type": "string"
          }
        },
        "required": [
          "url",
          "title",
          "publisher",
          "sourceType",
          "observedAt"
        ],
        "additionalProperties": false
      }
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "cached": {
      "type": "boolean"
    },
    "dataMode": {
      "type": "string",
      "enum": [
        "live",
        "not_configured"
      ]
    }
  },
  "required": [
    "company",
    "riskSignals",
    "checks",
    "sources",
    "confidence",
    "limitations",
    "cached",
    "dataMode"
  ],
  "additionalProperties": false
}

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