mcp-cisco-support

Instructions

Implementation Reference

• src/apis/bug-api.ts:690-692 (handler)

  Specific handler case in executeTool method that constructs the Cisco Bug Search API endpoint using the product_name and affected_releases parameters from tool args. Encodes parameters and sets endpoint for the makeApiCall in base class.

  case 'search_bugs_by_product_name_affected':
    endpoint = `/bugs/products/product_name/${encodeURIComponent(processedArgs.product_name)}/affected_releases/${encodeURIComponent(processedArgs.affected_releases)}`;
    break;

• src/apis/bug-api.ts:367-406 (schema)

  Input schema defining parameters for the tool, including required product_name and affected_releases, with descriptions and optional filters for pagination, status, severity, etc.

  inputSchema: {
    type: 'object',
    properties: {
      product_name: {
        type: 'string',
        description: 'Full descriptive product name (e.g., "Cisco 4431 Integrated Services Router", "Cisco 2504 Wireless Controller") - NOT product IDs like ISR4431'
      },
      affected_releases: {
        type: 'string',
        description: 'Comma-separated affected release versions (e.g., "12.5(1)SU5,14.0(1)SU2"). 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_name', 'affected_releases']
  }

• src/apis/bug-api.ts:364-407 (registration)

  Tool registration in BugApi.getTools() method, defining name, description, and inputSchema, making it available via the MCP tool interface.

  {
    name: 'search_bugs_by_product_name_affected',
    description: 'Search bugs by full product name and affected releases. NOTE: Requires FULL descriptive product names (like "Cisco 4431 Integrated Services Router") not product IDs. Use search_bugs_by_product_id for product IDs like ISR4431.',
    inputSchema: {
      type: 'object',
      properties: {
        product_name: {
          type: 'string',
          description: 'Full descriptive product name (e.g., "Cisco 4431 Integrated Services Router", "Cisco 2504 Wireless Controller") - NOT product IDs like ISR4431'
        },
        affected_releases: {
          type: 'string',
          description: 'Comma-separated affected release versions (e.g., "12.5(1)SU5,14.0(1)SU2"). 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_name', 'affected_releases']
    }
  },

• src/apis/bug-api.ts:18-22 (helper)

  Helper method used in executeTool to normalize affected_releases versions by removing leading zeros for Cisco API compatibility (e.g., 17.09.06 -> 17.9.6).

  private normalizeVersionString(version: string): string {
    if (!version) return version;
    // Remove leading zeros from each version segment: 17.09.06 -> 17.9.6
    return version.replace(/\.0+(\d)/g, '.$1');
  }

• src/utils/formatting.ts:9-19 (schema)

  Output response type definition for Bug API tools, including bugs array with key fields and total_results.

  export interface BugApiResponse extends ApiResponse {
    bugs?: Array<{
      bug_id: string;
      headline: string;
      status: string;
      severity: string;
      last_modified_date: string;
      [key: string]: any;
    }>;
    total_results?: number;
  }