Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Server port for HTTP mode | 3000 |
| NODE_ENV | No | Node environment (development/production) | development |
| SUPPORT_API | No | Enable specific Cisco Support APIs (comma-separated list) | bug |
| CISCO_CLIENT_ID | Yes | Your Cisco API Client ID for OAuth2 authentication | |
| MCP_BEARER_TOKEN | No | Custom Bearer token for HTTP authentication (HTTP mode only) | |
| CISCO_CLIENT_SECRET | Yes | Your Cisco API Client Secret for OAuth2 authentication | |
| DANGEROUSLY_OMIT_AUTH | No | Disables HTTP authentication entirely (development/testing only) |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_bug_details | Get details for up to 5 specific bug IDs |
| search_bugs_by_keyword | Search for bugs using keywords in descriptions and headlines. Use this when searching by general terms, symptoms, or when product-specific tools are not applicable. IMPORTANT: severity parameter returns ONLY that specific level. For "severity 3 or higher" searches, use multi_severity_search tool instead. NOTE: Do NOT use product IDs (like ISR4431/K9) as keywords - use search_bugs_by_product_id instead. |
| search_bugs_by_product_id | Search bugs by specific base product ID (e.g., C9200-24P). Use when you have an exact Cisco product ID. For general product searches by name, consider using keyword search instead. |
| search_bugs_by_product_and_release | Search bugs by specific product ID and software releases. CRITICAL: Use "software_releases" parameter with comma-separated values like "17.9.1,17.12.3" to search up to 75 versions in ONE API call. NEVER make multiple separate calls for different versions - the API supports multiple versions in a single request. Use this when you have an exact product ID and want to filter by specific software versions. For product series searches, use search_bugs_by_product_series_affected instead. |
| search_bugs_by_product_series_affected | 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). |
| search_bugs_by_product_series_fixed | 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). |
| search_bugs_by_product_name_affected | 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. |
| search_bugs_by_product_name_fixed | Search bugs by full product name and fixed 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. |
| smart_search_strategy | Analyzes search queries and suggests optimal search approaches based on input patterns. Provides strategic guidance for finding bugs effectively. |
| progressive_bug_search | Automatically tries multiple search strategies, starting specific and broadening scope if needed. Handles version normalization and product ID variations. |
| multi_severity_search | RECOMMENDED for multi-severity searches: Automatically searches multiple severity levels and combines results with severity breakdown counts. Use this when you need "severity 3 or higher", "high severity bugs", or any range of severities. Handles the API limitation that requires separate calls for each severity level. SMART FALLBACK: When product_id search returns no results, automatically falls back to keyword search for better coverage (regardless of whether version is provided). |
| comprehensive_analysis | BEST FOR DETAILED ANALYSIS: Combines bug database search with web search guidance for EoL information. Provides complete product analysis including known issues, lifecycle status, and actionable recommendations. Ideal for failover issues, configuration problems, and product reliability concerns. |
| compare_software_versions | Compare bugs, CVEs, and recommendations between two software versions on the same product. Analyzes differences in known issues, security vulnerabilities, and provides upgrade recommendations. |
| product_name_resolver | Resolves product IDs to full product names and provides web search strategies. Helps convert technical product codes to searchable terms. |
| get_case_summary | Get case summary information for up to 30 specific case IDs. Returns brief information for multiple cases. |
| get_case_details | Get detailed information for a single case ID. Returns comprehensive case information including status, severity, description, and all case attributes. |
| search_cases_by_contract | Search for cases associated with specific contract IDs (max 10). Returns cases linked to the specified contracts. |
| search_cases_by_user | Search for cases associated with specific user IDs (max 10). Returns cases owned by or involving the specified users. |
| get_coverage_status_by_serial | 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. |
| get_coverage_summary_by_serial | Get summary coverage information for up to 75 serial numbers. Returns brief coverage status and key dates. Use this for quick coverage lookups without full details. |
| get_coverage_summary_by_instance | Get coverage summary by instance numbers. Instance numbers are unique identifiers for devices in Cisco systems. Returns coverage information for specified instances. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| cisco-high-severity-search | Search for high-severity bugs (severity 3 or higher) for specific products - handles API limitation requiring separate searches. Provide either product_keyword OR serial_number (not both). |
| cisco-incident-investigation | Investigate Cisco bugs related to specific incident symptoms and errors. Provide either product OR serial_number. |
| cisco-upgrade-planning | Research known issues and bugs before upgrading Cisco software or hardware. Provide either product OR serial_number. |
| cisco-maintenance-prep | Prepare for maintenance windows by identifying potential issues and bugs. Provide either product OR serial_number. |
| cisco-security-advisory | Research security-related bugs and vulnerabilities for Cisco products. Provide either product OR serial_number. |
| cisco-known-issues | Check for known issues in specific Cisco software releases or products. Provide either product OR serial_number. |
| cisco-case-investigation | Investigate support cases and related information using Case API tools |
| cisco-lifecycle-planning | Research end-of-life information for Cisco products to plan replacements and maintenance |
| cisco-smart-search | Intelligent search strategy with automatic refinement and comprehensive analysis. Uses multiple search techniques and provides web search guidance. |
| cisco-interactive-search | ⚠️ EXPERIMENTAL: Interactive search with elicitation requests for missing parameters. Note: ElicitationRequest support is limited in current MCP clients (Claude Desktop uses conversational follow-ups instead). Kept for future client support. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Recent Critical Bugs | High-severity bugs from the last 7 days |
| Recent High-Severity Bugs | Severity 1-3 bugs from the last 30 days |