> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# black-kite

> Black Kite Cyber Risk

**Server path:** `/black-kite` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                          | Description                      |
| --------------------------------------------------------------------------------------------- | -------------------------------- |
| [`black_kite_add_company`](#black_kite_add_company)                                           | Add company to monitoring        |
| [`black_kite_delete_company`](#black_kite_delete_company)                                     | Remove company from monitoring   |
| [`black_kite_get_company`](#black_kite_get_company)                                           | Get company details              |
| [`black_kite_get_company_risk_score`](#black_kite_get_company_risk_score)                     | Get company risk score           |
| [`black_kite_get_company_technical_risk_score`](#black_kite_get_company_technical_risk_score) | Get technical risk score history |
| [`black_kite_get_scorecard`](#black_kite_get_scorecard)                                       | Get company scorecard            |
| [`black_kite_get_status`](#black_kite_get_status)                                             | Get API status                   |
| [`black_kite_get_tag`](#black_kite_get_tag)                                                   | Get tag details                  |
| [`black_kite_list_companies`](#black_kite_list_companies)                                     | List monitored companies         |
| [`black_kite_list_company_findings`](#black_kite_list_company_findings)                       | List company findings            |
| [`black_kite_list_company_focus_tags`](#black_kite_list_company_focus_tags)                   | List company FocusTags           |
| [`black_kite_list_ecosystems`](#black_kite_list_ecosystems)                                   | List ecosystems                  |
| [`black_kite_search_companies`](#black_kite_search_companies)                                 | Search for companies             |
| [`black_kite_update_company`](#black_kite_update_company)                                     | Update company properties        |

***

## black\_kite\_add\_company

Add company to monitoring

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                  |
| --------- | ------ | -------- | ------- | ------------------------------------------------------------ |
| `domain`  | string | Yes      | —       | Primary domain of the company to monitor (e.g., example.com) |
| `name`    | string | No       | —       | Company name                                                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "domain": {
        "type": "string",
        "description": "Primary domain of the company to monitor (e.g., example.com)"
      },
      "name": {
        "type": "string",
        "description": "Company name"
      }
    },
    "required": [
      "PCID",
      "domain"
    ]
  }
  ```
</Expandable>

***

## black\_kite\_delete\_company

Remove company from monitoring

**Parameters:**

| Parameter   | Type   | Required | Default | Description                          |
| ----------- | ------ | -------- | ------- | ------------------------------------ |
| `companyId` | string | Yes      | —       | The unique identifier of the company |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "companyId": {
        "type": "string",
        "description": "The unique identifier of the company"
      }
    },
    "required": [
      "PCID",
      "companyId"
    ]
  }
  ```
</Expandable>

***

## black\_kite\_get\_company

Get company details

**Parameters:**

| Parameter   | Type   | Required | Default | Description                          |
| ----------- | ------ | -------- | ------- | ------------------------------------ |
| `companyId` | string | Yes      | —       | The unique identifier of the company |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "companyId": {
        "type": "string",
        "description": "The unique identifier of the company"
      }
    },
    "required": [
      "PCID",
      "companyId"
    ]
  }
  ```
</Expandable>

***

## black\_kite\_get\_company\_risk\_score

Get company risk score

**Parameters:**

| Parameter   | Type   | Required | Default | Description                          |
| ----------- | ------ | -------- | ------- | ------------------------------------ |
| `companyId` | string | Yes      | —       | The unique identifier of the company |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "companyId": {
        "type": "string",
        "description": "The unique identifier of the company"
      }
    },
    "required": [
      "PCID",
      "companyId"
    ]
  }
  ```
</Expandable>

***

## black\_kite\_get\_company\_technical\_risk\_score

Get technical risk score history

**Parameters:**

| Parameter   | Type   | Required | Default | Description                          |
| ----------- | ------ | -------- | ------- | ------------------------------------ |
| `companyId` | string | Yes      | —       | The unique identifier of the company |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "companyId": {
        "type": "string",
        "description": "The unique identifier of the company"
      }
    },
    "required": [
      "PCID",
      "companyId"
    ]
  }
  ```
</Expandable>

***

## black\_kite\_get\_scorecard

Get company scorecard

**Parameters:**

| Parameter   | Type   | Required | Default | Description                          |
| ----------- | ------ | -------- | ------- | ------------------------------------ |
| `companyId` | string | Yes      | —       | The unique identifier of the company |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "companyId": {
        "type": "string",
        "description": "The unique identifier of the company"
      }
    },
    "required": [
      "PCID",
      "companyId"
    ]
  }
  ```
</Expandable>

***

## black\_kite\_get\_status

Get API status

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## black\_kite\_get\_tag

Get tag details

**Parameters:**

| Parameter | Type   | Required | Default | Description                      |
| --------- | ------ | -------- | ------- | -------------------------------- |
| `tagId`   | string | Yes      | —       | The unique identifier of the tag |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "tagId": {
        "type": "string",
        "description": "The unique identifier of the tag"
      }
    },
    "required": [
      "PCID",
      "tagId"
    ]
  }
  ```
</Expandable>

***

## black\_kite\_list\_companies

List monitored companies

**Parameters:**

| Parameter  | Type    | Required | Default | Description                |
| ---------- | ------- | -------- | ------- | -------------------------- |
| `page`     | integer | No       | —       | Page number for pagination |
| `pageSize` | integer | No       | —       | Number of results per page |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "page": {
        "type": "integer",
        "description": "Page number for pagination"
      },
      "pageSize": {
        "type": "integer",
        "description": "Number of results per page"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## black\_kite\_list\_company\_findings

List company findings

**Parameters:**

| Parameter   | Type    | Required | Default | Description                          |
| ----------- | ------- | -------- | ------- | ------------------------------------ |
| `companyId` | string  | Yes      | —       | The unique identifier of the company |
| `status`    | string  | No       | —       | Filter by finding status             |
| `severity`  | string  | No       | —       | Filter by finding severity           |
| `page`      | integer | No       | —       | Page number for pagination           |
| `pageSize`  | integer | No       | —       | Number of results per page           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "companyId": {
        "type": "string",
        "description": "The unique identifier of the company"
      },
      "status": {
        "type": "string",
        "description": "Filter by finding status",
        "enum": [
          "Active",
          "Resolved",
          "Accepted"
        ]
      },
      "severity": {
        "type": "string",
        "description": "Filter by finding severity",
        "enum": [
          "Low",
          "Medium",
          "High",
          "Critical"
        ]
      },
      "page": {
        "type": "integer",
        "description": "Page number for pagination"
      },
      "pageSize": {
        "type": "integer",
        "description": "Number of results per page"
      }
    },
    "required": [
      "PCID",
      "companyId"
    ]
  }
  ```
</Expandable>

***

## black\_kite\_list\_company\_focus\_tags

List company FocusTags

**Parameters:**

| Parameter   | Type   | Required | Default | Description                          |
| ----------- | ------ | -------- | ------- | ------------------------------------ |
| `companyId` | string | Yes      | —       | The unique identifier of the company |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "companyId": {
        "type": "string",
        "description": "The unique identifier of the company"
      }
    },
    "required": [
      "PCID",
      "companyId"
    ]
  }
  ```
</Expandable>

***

## black\_kite\_list\_ecosystems

List ecosystems

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## black\_kite\_search\_companies

Search for companies

**Parameters:**

| Parameter         | Type      | Required | Default | Description                           |
| ----------------- | --------- | -------- | ------- | ------------------------------------- |
| `productGroupIds` | string\[] | No       | —       | Filter by product group IDs           |
| `query`           | string    | Yes      | —       | Search query — company name or domain |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "productGroupIds": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Filter by product group IDs"
      },
      "query": {
        "type": "string",
        "description": "Search query — company name or domain"
      }
    },
    "required": [
      "PCID",
      "query"
    ]
  }
  ```
</Expandable>

***

## black\_kite\_update\_company

Update company properties

**Parameters:**

| Parameter   | Type   | Required | Default | Description                          |
| ----------- | ------ | -------- | ------- | ------------------------------------ |
| `companyId` | string | Yes      | —       | The unique identifier of the company |
| `name`      | string | Yes      | —       | Updated company name                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "companyId": {
        "type": "string",
        "description": "The unique identifier of the company"
      },
      "name": {
        "type": "string",
        "description": "Updated company name"
      }
    },
    "required": [
      "PCID",
      "companyId",
      "name"
    ]
  }
  ```
</Expandable>