mcp-cisco-support

Instructions

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: ''
    }