search_configuration_items
Find configuration items in Autotask by name, company, product, or active status to manage IT assets and resources.
Instructions
Search for configuration items in Autotask with optional filters
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| searchTerm | No | Search term for configuration item name | |
| companyID | No | Filter by company ID | |
| isActive | No | Filter by active status | |
| productID | No | Filter by product ID | |
| pageSize | No | Number of results to return (default: 25, max: 500) |
Implementation Reference
- src/handlers/tool.handler.ts:883-914 (registration)Tool registration including name, description, and detailed input schema in the listTools() method.{ name: 'search_configuration_items', description: 'Search for configuration items in Autotask with optional filters', inputSchema: { type: 'object', properties: { searchTerm: { type: 'string', description: 'Search term for configuration item name' }, companyID: { type: 'number', description: 'Filter by company ID' }, isActive: { type: 'boolean', description: 'Filter by active status' }, productID: { type: 'number', description: 'Filter by product ID' }, pageSize: { type: 'number', description: 'Number of results to return (default: 25, max: 500)', minimum: 1, maximum: 500 } }, required: [] } },
- src/handlers/tool.handler.ts:1144-1148 (handler)MCP dispatch handler in callTool() switch statement that invokes the autotask service.// Configuration Item tools case 'search_configuration_items': result = await this.autotaskService.searchConfigurationItems(args); message = `Found ${result.length} configuration items`; break;
- src/services/autotask.service.ts:944-955 (handler)Core implementation of searchConfigurationItems that queries the Autotask API via the client library, handles errors, and returns typed results.async searchConfigurationItems(options: AutotaskQueryOptions = {}): Promise<AutotaskConfigurationItem[]> { const client = await this.ensureClient(); try { this.logger.debug('Searching configuration items with options:', options); const result = await client.configurationItems.list(options as any); return (result.data as AutotaskConfigurationItem[]) || []; } catch (error) { this.logger.error('Failed to search configuration items:', error); throw error; } }