1eye Docs – Buyer Signals API, Webhooks, MCP & Integrations

Exclusions identify companies, such as existing customers or partners, whose people are not treated as buyers. Omitted company name, description, LinkedIn, and logo values are filled from company data. Use resource: "exclusions" with each knowledge base tool on this page. short_name is the brief label shown in the 1eye app.

Creation fields	Values
Required	`short_name`, `domain`
Optional	`name`, `linkedin`, `logo`, `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 — Read-only.
get_kb — Read-only.
create_kb — Change; confirmation required.
update_kb — Change; confirmation required.
delete_kb — Change; confirmation required.

`list_kb`

Read-only List excluded companies.

Arguments

Argument	Type	Required	Description
`resource`	string	Yes	Use `"exclusions"` 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

{
  "resource": "exclusions",
  "limit": 10
}

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

`get_kb`

Read-only Retrieve an exclusion.

Arguments

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

Example

{
  "resource": "exclusions",
  "id": "EXCLUSION_ID"
}

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

`create_kb`

Change · confirmation required Create an exclusion. 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 `"exclusions"` for this page.
`fields`	object	Yes	Resource fields. See the creation requirements above; updates supply only fields to change.

Example

{
  "resource": "exclusions",
  "fields": {
    "short_name": "Partner",
    "domain": "partner.example"
  }
}

Returns: The created knowledge base item.

`update_kb`

Change · confirmation required Update an exclusion. 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 `"exclusions"` 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

{
  "resource": "exclusions",
  "id": "EXCLUSION_ID",
  "fields": {
    "short_name": "Partner Updated"
  }
}

Returns: The updated item.

`delete_kb`

Change · confirmation required Delete an exclusion. Confirm the named item before deleting it. Deletion cannot be undone through this tool.

Arguments

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

Example

{
  "resource": "exclusions",
  "id": "EXCLUSION_ID"
}

Returns: The deletion result.

Get Started

Using MCP

Buyers

Signals

Target Lists

Destinations

Knowledge Base

Workspace

Exclusions

Tools

`list_kb`

Arguments

Example

`get_kb`

Arguments

Example

`create_kb`

Arguments

Example

`update_kb`

Arguments

Example

`delete_kb`

Arguments

Example

​Tools

​list_kb

​Arguments

​Example

​get_kb

​Arguments

​Example

​create_kb

​Arguments

​Example

​update_kb

​Arguments

​Example

​delete_kb

​Arguments

​Example

Tools

`list_kb`

Arguments

Example

`get_kb`

Arguments

Example

`create_kb`

Arguments

Example

`update_kb`

Arguments

Example

`delete_kb`

Arguments

Example