> ## 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.

# Products

> Read and manage products through the 1eye MCP server.

Products describe the workspace's own products.

Use `resource: "products"` 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 products.

### Arguments

| Argument | Type | Required | Description |
| - | - | - | - |
| `resource` | string | Yes | Use `"products"` 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": "products",
  "limit": 10
}
```

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

## `get_kb`

**Read-only**

Retrieve a product.

### Arguments

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

### Example

```json theme={null}
{
  "resource": "products",
  "id": "PRODUCT_ID"
}
```

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

## `create_kb`

**Change · confirmation required**

Create a product.

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 `"products"` for this page. |
| `fields` | object | Yes | Resource fields. See the creation requirements above; updates supply only fields to change. |

### Example

```json theme={null}
{
  "resource": "products",
  "fields": {
    "name": "Buyer Intelligence",
    "short_name": "Intelligence",
    "description": "Our buyer intelligence product."
  }
}
```

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

## `update_kb`

**Change · confirmation required**

Update a product.

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 `"products"` 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": "products",
  "id": "PRODUCT_ID",
  "fields": {
    "short_name": "Intelligence Updated"
  }
}
```

**Returns:** The updated item.

## `delete_kb`

**Change · confirmation required**

Delete a product.

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

### Arguments

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

### Example

```json theme={null}
{
  "resource": "products",
  "id": "PRODUCT_ID"
}
```

**Returns:** The deletion result.


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