# search_companies

Search for CRM companies with powerful filtering, sorting, and pagination capabilities.

<!-- INPUT_BLOCK_START -->

## Input

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `first` | `number` | No | Number of results to return (forward pagination). Maximum 25. Use with "after" for paging. |
| `after` | `string` | No | Cursor for forward pagination. Pass the "endCursor" from previous page's pageInfo. |
| `last` | `number` | No | Number of results to return (backward pagination). Maximum 25. Use with "before" for reverse paging. |
| `before` | `string` | No | Cursor for backward pagination. Pass the "startCursor" from previous page's pageInfo. |
| `filters` | `CompaniesFiltersInput` | No | Filter criteria for the company search. Supports complex queries with AND/OR logic. - [CompaniesFiltersInput](#companiesfiltersinput) |
| `sort` | `CompaniesSortInput` | No | Sort order for results. Defaults to newest first if not specified. - [CompaniesSortInput](#companiessortinput) |

### CompaniesFiltersInput

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `StringFilter` | No | [StringFilter](#stringfilter) |
| `name` | `StringFilter` | No | [StringFilter](#stringfilter) |
| `domain` | `StringFilter` | No | [StringFilter](#stringfilter) |
| `taxNumber` | `StringFilter` | No | [StringFilter](#stringfilter) |
| `uniqueReference` | `StringFilter` | No | [StringFilter](#stringfilter) |
| `crmNamespace` | `CrmNamespaceFilter` | No | [CrmNamespaceFilter](#crmnamespacefilter) |
| `contacts` | `ContactsFilter` | No | [ContactsFilter](#contactsfilter) |
| `verifiedInquiries` | `NumberFilter` | No | [NumberFilter](#numberfilter) |
| `createdAt` | `DateTimeFilter` | No | [DateTimeFilter](#datetimefilter) |
| `updatedAt` | `DateTimeFilter` | No | [DateTimeFilter](#datetimefilter) |

### CompaniesSortInput

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `SortDirection` | No | Sort by company ID - [SortDirection](#sortdirection) |
| `name` | `SortDirection` | No | Sort by company name - [SortDirection](#sortdirection) |
| `verifiedInquiries` | `SortDirection` | No | Sort by number of verified inquiries - [SortDirection](#sortdirection) |
| `createdAt` | `SortDirection` | No | Sort by creation date (use DESC for newest first) - [SortDirection](#sortdirection) |
| `updatedAt` | `SortDirection` | No | Sort by last update date (use DESC for recently modified first) - [SortDirection](#sortdirection) |

### StringFilter

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `eq` | `string` | No | Equals: exact match |
| `neq` | `string` | No | Not equals: exclude exact match |
| `in` | `string[]` | No | In: match any value in the array |
| `nin` | `string[]` | No | Not in: exclude values in the array |
| `search` | `string` | No | Full-text search: partial/fuzzy match |

### CrmNamespaceFilter

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `StringFilter` | No | Filter by CRM namespace ID |

### ContactsFilter

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `firstName` | `StringFilter` | No | Filter by contact first name |
| `lastName` | `StringFilter` | No | Filter by contact last name |
| `primaryEmail` | `StringFilter` | No | Filter by contact primary email |

### NumberFilter

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `eq` | `number` | No | Equals: exact match |
| `neq` | `number` | No | Not equals: exclude exact match |
| `in` | `number[]` | No | In: match any value in the array |
| `nin` | `number[]` | No | Not in: exclude values in the array |
| `gt` | `number` | No | Greater than (exclusive) |
| `gte` | `number` | No | Greater than or equal (inclusive) |
| `lt` | `number` | No | Less than (exclusive) |
| `lte` | `number` | No | Less than or equal (inclusive) |

### DateTimeFilter

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `eq` | `string` | No | Equals: exact datetime match (ISO8601 format, e.g., "2025-01-15T14:30:00Z") |
| `neq` | `string` | No | Not equals: exclude exact datetime |
| `in` | `string[]` | No | In: match any datetime in the array |
| `nin` | `string[]` | No | Not in: exclude datetimes in the array |
| `lt` | `string` | No | Less than: before this datetime (exclusive) |
| `lte` | `string` | No | Less than or equal: before or at this datetime (inclusive) |
| `gt` | `string` | No | Greater than: after this datetime (exclusive) |
| `gte` | `string` | No | Greater than or equal: after or at this datetime (inclusive) |

### SortDirection

| Value | Description |
| --- | --- |
| `ASC` | Ascending: oldest first |
| `DESC` | Descending: newest first |

<!-- INPUT_BLOCK_END -->

<!-- OUTPUT_BLOCK_START -->

## Output

| Field | Type | Description |
| --- | --- | --- |
| `content` | `ContentItem[]` | Array of content items returned by the tool - [ContentItem](#contentitem) |
| `isError` | `boolean` | Whether the tool execution resulted in an error |

### ContentItem

| Field | Type | Description |
| --- | --- | --- |
| `type` | `'text'` | Content type (currently only 'text' is supported) |
| `text` | `string` | The text content to display |

<!-- OUTPUT_BLOCK_END -->