Tools: Vendors

listVendors

🔍 Read-only

List all vendors for the organization.

Parameters: {
  "organization_id": "org_xxx",
  "size": 50,
  "cursor": "optional_cursor",
  "filter": { "query": "search term" }
}

Supports: Pagination, search, filtering Returns: Array of vendors with basic information, next_cursor for pagination

Example:
AI: "List all vendors"
    [Uses listVendors tool]
AI: "Find vendors matching 'cloud'"
    [Uses listVendors tool with query filter]

addVendor

✏️ Write

Add a new vendor to the organization.

Parameters: {
  "organization_id": "org_xxx",
  "name": "Vendor Name",
  "description": "Vendor description",
  "website": "https://vendor.com"
}

Returns: Created vendor object with generated ID

Example:
AI: "Add a new vendor called CloudBackup Inc that provides backup services"
    [Uses addVendor tool]

updateVendor

✏️ Write

Update an existing vendor.

Parameters: {
  "organization_id": "org_xxx",
  "vendor_id": "vendor_xxx",
  "name": "Updated Name",
  "description": "Updated description"
}

Returns: Updated vendor object

Example:
AI: "Update vendor vendor_abc123 to mark them as approved"
    [Uses updateVendor tool]

listVendorRiskAssessments

🔍 Read-only

List all risk assessments for a vendor.

Parameters: {
  "organization_id": "org_xxx",
  "vendor_id": "vendor_xxx",
  "size": 50,
  "cursor": "optional_cursor"
}

Returns: Array of risk assessments for the vendor

Example:
AI: "Show all risk assessments for vendor vendor_abc123"
    [Uses listVendorRiskAssessments tool]

addVendorRiskAssessment

✏️ Write

Add a new risk assessment for a vendor.

Parameters: {
  "vendor_id": "vendor_xxx",
  "expires_at": "2025-12-31T00:00:00Z",
  "data_sensitivity": "HIGH",
  "business_impact": "MEDIUM",
  "notes": "Assessment notes"
}

Returns: Created vendor risk assessment object

Example:
AI: "Add a HIGH risk assessment for vendor vendor_abc123"
    [Uses addVendorRiskAssessment tool]

deleteVendor

⚠️ Destructive

Delete a vendor.

Parameters: {
  "id": "vendor_xxx"
}

Returns: Deleted vendor ID

Example:
AI: "Delete vendor vendor_abc123"
    [Uses deleteVendor tool]