mcp-cisco-support

Instructions

Implementation Reference

• src/apis/bug-api.ts:679-688 (handler)

  Handler logic in BugApi.executeTool(): constructs Cisco Bug API endpoint `/bugs/product_series/{product_series}/fixed_in_releases/{fixed_releases}`, normalizes release versions, adds standard query params, logs details, and calls makeApiCall (inherited from BaseApi) to execute the search.
  case 'search_bugs_by_product_series_fixed': endpoint = `/bugs/product_series/${encodeURIComponent(processedArgs.product_series)}/fixed_in_releases/${encodeURIComponent(processedArgs.fixed_releases)}`; logger.info('Product series fixed endpoint', { product_series: processedArgs.product_series, fixed_releases: processedArgs.fixed_releases, endpoint, fullUrl: `${this.baseUrl}${endpoint}` }); break;
• src/apis/bug-api.ts:320-363 (registration)

  Tool registration in BugApi.getTools(): defines tool metadata (name, description) and input schema with required parameters product_series and fixed_releases, optional pagination/filtering params, and detailed validation enums.
  { name: 'search_bugs_by_product_series_fixed', description: 'Search bugs by product series and fixed 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.)' }, fixed_releases: { type: 'string', description: 'Comma-separated fixed 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', 'fixed_releases'] } },
• src/apis/bug-api.ts:323-362 (schema)

  Input schema definition specifying object type, properties (product_series, fixed_releases required; optional filters), enums for status/severity/modified_date/sort_by, and descriptions.
  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.)' }, fixed_releases: { type: 'string', description: 'Comma-separated fixed 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', 'fixed_releases'] }
• src/utils/formatting.ts:393-395 (helper)

  Helper logic in formatSearchContext/formatBugResults: adds tool-specific search context (product_series, fixed_releases) to formatted bug search results.
  } else if (searchContext.toolName === 'search_bugs_by_product_series_fixed') { formatted += `**Product Series:** ${searchContext.args.product_series}\n\n`; formatted += `**Fixed Releases:** ${searchContext.args.fixed_releases}\n\n`;
• src/apis/enhanced-analysis-api.ts:35-44 (registration)

  Registration as internal tool in EnhancedAnalysisApi: explicitly allowed for use by enhanced analysis tools despite not being in exposed getTools(), enabling temporary access during executeTool.
  const internalTools = [ 'get_bug_details', 'search_bugs_by_keyword', 'search_bugs_by_product_id', 'search_bugs_by_product_and_release', 'search_bugs_by_product_series_affected', 'search_bugs_by_product_series_fixed', 'search_bugs_by_product_name_affected', 'search_bugs_by_product_name_fixed' ];