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

# Target Pages

> Read and manage target pages through the 1eye MCP server.

Target pages identify website URLs whose visits signal buying intent. Matching uses the exact URL.

Use `resource: "target_pages"` 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`, `url` |
| 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 target pages.

### Arguments

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

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

## `get_kb`

**Read-only**

Retrieve a target page.

### Arguments

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

### Example

```json theme={null}
{
  "resource": "target_pages",
  "id": "TARGET_PAGE_ID"
}
```

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

## `create_kb`

**Change · confirmation required**

Create a target page.

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

### Example

```json theme={null}
{
  "resource": "target_pages",
  "fields": {
    "name": "Pricing page",
    "short_name": "Pricing",
    "url": "https://example.com/pricing"
  }
}
```

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

## `update_kb`

**Change · confirmation required**

Update a target page.

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 `"target_pages"` 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": "target_pages",
  "id": "TARGET_PAGE_ID",
  "fields": {
    "short_name": "Pricing Updated"
  }
}
```

**Returns:** The updated item.

## `delete_kb`

**Change · confirmation required**

Delete a target page.

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

### Arguments

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

### Example

```json theme={null}
{
  "resource": "target_pages",
  "id": "TARGET_PAGE_ID"
}
```

**Returns:** The deletion result.


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