search_bugs_by_product_series_affected
Search Cisco bug reports for specific product series and affected software releases to identify potential issues and fixes.
Instructions
Search bugs by product series and affected releases. This endpoint accepts full product series names like "Cisco 4000 Series Integrated Services Routers". IMPORTANT: Use Cisco API version format without leading zeros (17.9.6 not 17.09.06).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| product_series | Yes | Product series name (accepts full names like "Cisco 4000 Series Integrated Services Routers", "Cisco Catalyst 9200 Series", etc.) | |
| affected_releases | Yes | Comma-separated affected release versions in Cisco API format (e.g., "17.9.6,17.12.3" not "17.09.06" - no leading zeros). Can search up to 75 versions in one call. | |
| page_index | No | Page number (10 results per page) | |
| status | No | Bug status filter. IMPORTANT: Only ONE status allowed per search. Values: O=Open, F=Fixed, T=Terminated. Do NOT use comma-separated values like "O,F". | |
| severity | No | Bug severity filter. Returns bugs with ONLY the specified severity level. Values: 1=Severity 1 (highest), 2=Severity 2, 3=Severity 3, 4=Severity 4, 5=Severity 5, 6=Severity 6 (lowest). For "severity 3 or higher" bugs, use multi_severity_search tool which handles multiple separate API calls. | |
| modified_date | No | Last modified date filter. Values: 1=Last Week, 2=Last 30 Days, 3=Last 6 Months, 4=Last Year, 5=All. Default: 5 (All) | 5 |
| sort_by | No | Sort order for results. Default: modified_date (recent first) |
Implementation Reference
- src/apis/bug-api.ts:676-678 (handler)Handler logic in BugApi.executeTool method that constructs the Cisco Bug Search API endpoint specifically for 'search_bugs_by_product_series_affected' tool, using product_series and affected_releases parameters.case 'search_bugs_by_product_series_affected': endpoint = `/bugs/product_series/${encodeURIComponent(processedArgs.product_series)}/affected_releases/${encodeURIComponent(processedArgs.affected_releases)}`; break;
- src/apis/bug-api.ts:277-319 (schema)Tool schema definition in BugApi.getTools(), including detailed input schema, description, required parameters (product_series, affected_releases), and optional filters.name: 'search_bugs_by_product_series_affected', description: 'Search bugs by product series and affected releases. This endpoint accepts full product series names like "Cisco 4000 Series Integrated Services Routers". IMPORTANT: Use Cisco API version format without leading zeros (17.9.6 not 17.09.06).', inputSchema: { type: 'object', properties: { product_series: { type: 'string', description: 'Product series name (accepts full names like "Cisco 4000 Series Integrated Services Routers", "Cisco Catalyst 9200 Series", etc.)' }, affected_releases: { type: 'string', description: 'Comma-separated affected release versions in Cisco API format (e.g., "17.9.6,17.12.3" not "17.09.06" - no leading zeros). Can search up to 75 versions in one call.' }, page_index: { type: 'integer', default: 1, description: 'Page number (10 results per page)' }, status: { type: 'string', description: 'Bug status filter. IMPORTANT: Only ONE status allowed per search. Values: O=Open, F=Fixed, T=Terminated. Do NOT use comma-separated values like "O,F".', enum: ['O', 'F', 'T'] }, severity: { type: 'string', description: 'Bug severity filter. Returns bugs with ONLY the specified severity level. Values: 1=Severity 1 (highest), 2=Severity 2, 3=Severity 3, 4=Severity 4, 5=Severity 5, 6=Severity 6 (lowest). For "severity 3 or higher" bugs, use multi_severity_search tool which handles multiple separate API calls.', enum: ['1', '2', '3', '4', '5', '6'] }, modified_date: { type: 'string', description: 'Last modified date filter. Values: 1=Last Week, 2=Last 30 Days, 3=Last 6 Months, 4=Last Year, 5=All. Default: 5 (All)', enum: ['1', '2', '3', '4', '5'], default: '5' }, sort_by: { type: 'string', description: 'Sort order for results. Default: modified_date (recent first)', enum: ['status', 'modified_date', 'severity', 'support_case_count', 'modified_date_earliest'] }, }, required: ['product_series', 'affected_releases'] } },
- src/apis/index.ts:100-111 (registration)Registration of BugApi instance in ApiRegistry.initializeApis(), making its tools (including search_bugs_by_product_series_affected) available to the MCP server.private initializeApis(): void { // Initialize implemented APIs this.apis.set('bug', new BugApi()); this.apis.set('case', new CaseApi()); this.apis.set('eox', new EoxApi()); this.apis.set('psirt', new PsirtApi()); this.apis.set('product', new ProductApi()); this.apis.set('software', new SoftwareApi()); this.apis.set('serial', new SerialApi()); this.apis.set('rma', new RmaApi()); this.apis.set('enhanced_analysis', new EnhancedAnalysisApi()); this.apis.set('smart_bonding', new SmartBondingApi() as any); // Cast needed due to different base class
- src/utils/formatting.ts:390-393 (helper)Helper in formatSearchContext that adds specific formatting for search_bugs_by_product_series_affected tool parameters in the response output.} else if (searchContext.toolName === 'search_bugs_by_product_series_affected') { formatted += `**Product Series:** ${searchContext.args.product_series}\n\n`; formatted += `**Affected Releases:** ${searchContext.args.affected_releases}\n\n`; } else if (searchContext.toolName === 'search_bugs_by_product_series_fixed') {
- tests/mockData.ts:130-138 (helper)Test cases and mock input validation data for search_bugs_by_product_series_affected tool.search_bugs_by_product_series_affected: { valid: { product_series: 'Cisco Catalyst 9200 Series', affected_releases: '17.5.1' }, invalid: { product_series: '', affected_releases: '' }