get_coverage_status_by_serial
Check warranty coverage and contract details for Cisco devices using serial numbers. Retrieve comprehensive product information including warranty dates and contract status for up to 75 devices at once.
Instructions
Get detailed coverage status, warranty, and product information for up to 75 serial numbers. Returns comprehensive coverage details including warranty dates, contract information, and product identifiers.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| serial_numbers | Yes | Comma-separated list of serial numbers (max 75, e.g., "SAL09232Q0Z,FOC0903N5J9"). Supported formats include 11-character serial numbers and other Cisco serial number formats. | |
| page_index | No | Page number for pagination (starts at 1). Each page returns up to 75 results. |
Implementation Reference
- src/apis/serial-api.ts:108-116 (handler)Handler function within executeTool method that processes serial numbers input, constructs the API endpoint `/coverage/status/serial_numbers/{serialNumbers}`, adds pagination params, and calls makeApiCall to fetch coverage status.case 'get_coverage_status_by_serial': { const serialNumbers = (processedArgs.serial_numbers as string) .split(',') .map(s => s.trim()) .join(','); const endpoint = `/coverage/status/serial_numbers/${serialNumbers}`; const params = { page_index: processedArgs.page_index }; return await this.makeApiCall(endpoint, params) as SerialApiResponse; }
- src/apis/serial-api.ts:41-57 (schema)Input schema for the tool, validating serial_numbers as comma-separated string (required) and optional page_index integer.inputSchema: { type: 'object', properties: { serial_numbers: { type: 'string', description: 'Comma-separated list of serial numbers (max 75, e.g., "SAL09232Q0Z,FOC0903N5J9"). Supported formats include 11-character serial numbers and other Cisco serial number formats.', pattern: '^[A-Za-z0-9,\\s]+$' }, page_index: { type: 'integer', description: 'Page number for pagination (starts at 1). Each page returns up to 75 results.', minimum: 1, default: 1 } }, required: ['serial_numbers'] }
- src/apis/serial-api.ts:38-58 (registration)Tool registration in SerialApi.getTools(), defining name, description, and input schema for MCP tool integration.{ name: 'get_coverage_status_by_serial', description: 'Get detailed coverage status, warranty, and product information for up to 75 serial numbers. Returns comprehensive coverage details including warranty dates, contract information, and product identifiers.', inputSchema: { type: 'object', properties: { serial_numbers: { type: 'string', description: 'Comma-separated list of serial numbers (max 75, e.g., "SAL09232Q0Z,FOC0903N5J9"). Supported formats include 11-character serial numbers and other Cisco serial number formats.', pattern: '^[A-Za-z0-9,\\s]+$' }, page_index: { type: 'integer', description: 'Page number for pagination (starts at 1). Each page returns up to 75 results.', minimum: 1, default: 1 } }, required: ['serial_numbers'] } },
- src/apis/serial-api.ts:6-30 (schema)Output interface type definition for SerialApi responses, used in the tool handler.export interface SerialApiResponse extends ApiResponse { serial_numbers?: Array<{ sr_no?: string; sr_no_list?: string[]; is_valid?: string; base_pid?: string; orderable_pid?: string; item_description?: string; item_type?: string; instance_id?: number; warranty_type?: string; warranty_end_date?: string; covered_product_line_end_date?: string; is_covered?: string; service_contract_number?: string; service_line_descr?: string; parent_sr_no?: string; }>; pagination_response_record?: { page_index?: number; page_records?: number; total_records?: number; last_index?: number; }; }