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

# ICPs

> Read and manage ideal customer profiles through the 1eye MCP server.

ICPs define the company profiles you want 1eye to identify and qualify.

Use `resource: "icps"` with each knowledge base tool on this page. `short_name` is the brief label shown in the 1eye app.

| Creation fields | Values |
| - | - |
| Required | `name`, `short_name` |
| Optional | `description` |

Fields accept strings or null as applicable. Required fields must be supplied when creating an item and cannot be cleared when updating it. Read the current record and confirm the exact proposal before creating, updating, or deleting.

The examples below are MCP tool arguments. Replace uppercase IDs with values returned by your workspace.

## Tools

* [`list_kb`](#list-kb) — Read-only.
* [`get_kb`](#get-kb) — Read-only.
* [`create_kb`](#create-kb) — Change; confirmation required.
* [`update_kb`](#update-kb) — Change; confirmation required.
* [`delete_kb`](#delete-kb) — Change; confirmation required.

## `list_kb`

**Read-only**

List ideal customer profiles.

### Arguments

| Argument | Type | Required | Description |
| - | - | - | - |
| `resource` | string | Yes | Use `"icps"` for this page. |
| `limit` | number | No | Page size; defaults to 100. |
| `cursor` | string | No | Opaque continuation cursor from the same list. |
| `sort_order` | `asc` or `desc` | No | Oldest or newest first; defaults to `desc`. |

### Example

```json theme={null}
{
  "resource": "icps",
  "limit": 10
}
```

**Returns:** A paginated list with `total`, `data`, and `next_cursor`.

## `get_kb`

**Read-only**

Retrieve an ICP.

### Arguments

| Argument | Type | Required | Description |
| - | - | - | - |
| `resource` | string | Yes | Use `"icps"` for this page. |
| `id` | string | Yes | An item ID returned by `list_kb`. |

### Example

```json theme={null}
{
  "resource": "icps",
  "id": "ICP_ID"
}
```

**Returns:** The item and the fields applicable to its resource type.

## `create_kb`

**Change · confirmation required**

Create an ICP.

Confirm the complete proposed item before creating it. Knowledge base changes affect how 1eye finds and qualifies buyers.

### Arguments

| Argument | Type | Required | Description |
| - | - | - | - |
| `resource` | string | Yes | Use `"icps"` for this page. |
| `fields` | object | Yes | Resource fields. See the creation requirements above; updates supply only fields to change. |

### Example

```json theme={null}
{
  "resource": "icps",
  "fields": {
    "name": "Growth-stage SaaS",
    "short_name": "Growth SaaS",
    "description": "B2B software companies with 50–500 employees."
  }
}
```

**Returns:** The created knowledge base item.

## `update_kb`

**Change · confirmation required**

Update an ICP.

Confirm the item and field changes first. Omitted fields remain unchanged. Send `null` or an empty string to clear an optional field; required fields cannot be cleared.

### Arguments

| Argument | Type | Required | Description |
| - | - | - | - |
| `resource` | string | Yes | Use `"icps"` for this page. |
| `id` | string | Yes | Item ID. |
| `fields` | object | Yes | Resource fields. See the creation requirements above; updates supply only fields to change. |

### Example

```json theme={null}
{
  "resource": "icps",
  "id": "ICP_ID",
  "fields": {
    "short_name": "Growth SaaS Updated"
  }
}
```

**Returns:** The updated item.

## `delete_kb`

**Change · confirmation required**

Delete an ICP.

Confirm the named item before deleting it. Deletion cannot be undone through this tool.

### Arguments

| Argument | Type | Required | Description |
| - | - | - | - |
| `resource` | string | Yes | Use `"icps"` for this page. |
| `id` | string | Yes | Item ID. |

### Example

```json theme={null}
{
  "resource": "icps",
  "id": "ICP_ID"
}
```

**Returns:** The deletion result.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.