procurement_vendor_shortlist

Screen and rank 2–50 Oman suppliers in one procurement workflow using identity, risk, sanctions and public-evidence signals.

When to use

Use when a procurement agent needs a ranked vendor shortlist from several candidate suppliers.

Selection guidance

Role: specialized. Use when a procurement agent needs a ranked vendor shortlist from several candidate suppliers.

Use cases

• vendor shortlist
• procurement shortlist
• compare suppliers
• supplier ranking

Access

• REST: POST https://api.rafidsystem.com/api/v1/procurement/vendor-shortlist
• x402: POST https://api.rafidsystem.com/api/v1/x402/procurement/vendor-shortlist
• MCP tool: procurement_vendor_shortlist

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

• supplier_due_diligence_report

Example input

{
  "suppliers": [
    {
      "companyName": "Example Technical Services LLC",
      "requiredProductOrService": "HVAC maintenance"
    },
    {
      "companyName": "Example Facilities LLC",
      "requiredProductOrService": "HVAC maintenance"
    }
  ],
  "maxResults": 2
}

Example output

{
  "workflow": "procurement_vendor_shortlist",
  "result": {
    "vendors": [],
    "screenedCount": 0
  },
  "limitations": [
    "Ranking is decision support; procurement agents must review evidence, conflicts and unavailable checks before selecting a vendor."
  ]
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "suppliers": {
      "minItems": 2,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "companyName": {
            "type": "string",
            "minLength": 2,
            "maxLength": 200
          },
          "crNumber": {
            "type": "string",
            "minLength": 3,
            "maxLength": 30,
            "pattern": "^[0-9A-Za-z][0-9A-Za-z\\s\\-/.]*$"
          },
          "website": {
            "type": "string",
            "minLength": 4,
            "maxLength": 300
          },
          "email": {
            "type": "string",
            "maxLength": 254,
            "pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$"
          },
          "phone": {
            "type": "string",
            "minLength": 6,
            "maxLength": 30,
            "pattern": "^[+0-9\\s()\\-.xX*]+$"
          },
          "address": {
            "type": "string",
            "minLength": 2,
            "maxLength": 300
          },
          "requiredProductOrService": {
            "type": "string",
            "minLength": 2,
            "maxLength": 200
          }
        },
        "required": [
          "companyName"
        ],
        "additionalProperties": false
      }
    },
    "csv": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000000
    },
    "maxResults": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

Output schema

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

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