Skip to content
Jeremy edited this page Jun 23, 2025 · 2 revisions

🌐 Cisco Support MCP Server Wiki

Welcome to the comprehensive documentation hub for the Cisco Support MCP Server - a production-ready TypeScript MCP (Model Context Protocol) server providing access to multiple Cisco Support APIs.

πŸš€ Quick Start

New to the project? Start here:

  1. Quick Installation Guide - Get up and running in minutes
  2. Available Tools - See all 33 MCP tools across 6 Cisco APIs
  3. Advanced Configuration - Environment variables and deployment options

πŸ“Š Project Status

βœ… 6/8 Cisco APIs Implemented (75%)

  • 33 Total Tools across Bug, Case, EoX, PSIRT, Product, and Software APIs
  • Production Ready with comprehensive security and testing
  • Multi-Transport Support - stdio (Claude Desktop) and HTTP (remote server)

πŸ› οΈ Core Documentation

πŸ”§ Setup & Configuration

πŸ” API & Tools

  • Available Tools - Complete reference for all 33 MCP tools with JSON-RPC examples
  • MCP Prompts - 5 specialized prompts for guided Cisco support workflows
  • SSE Integration - Server-Sent Events and real-time communication

πŸ§ͺ Development & Testing

🎯 Use Cases

πŸ‘¨β€πŸ’» Support Engineers

  • Search and analyze Cisco bugs across products
  • Investigate security vulnerabilities (PSIRT)
  • Plan software upgrades and maintenance
  • Track product lifecycle and end-of-life notifications

🏒 Network Administrators

  • Monitor product security advisories
  • Plan hardware refresh cycles
  • Validate software compatibility
  • Research known issues before deployments

πŸ”¬ Developers & Integrators

  • Integrate Cisco Support APIs into workflows
  • Build custom automation with MCP tools
  • Access real-time support data via SSE
  • Extend server with additional APIs

🌟 Key Features

  • πŸ” Secure Authentication - OAuth2 with Cisco APIs, Bearer token protection for HTTP
  • ⚑ Real-time Updates - Server-Sent Events for live data streaming
  • πŸ§ͺ Comprehensive Testing - 38+ passing tests with full coverage
  • 🐳 Container Ready - Docker deployment with health checks
  • πŸ“± Multi-Platform - Works with Claude Desktop, MCP Inspector, N8N, and custom clients
  • πŸ”„ Auto-refresh - Automatic token management and error recovery

πŸ“ˆ API Implementation Status

API Status Tools Description
Bug βœ… Complete 8 tools Bug search, details, product-specific queries
Case βœ… Complete 4 tools Support case management and operations
EoX βœ… Complete 4 tools End-of-Life/Sale information and lifecycle planning
PSIRT βœ… Complete 8 tools Security vulnerability data and advisories
Product βœ… Complete 3 tools Product details and specifications
Software βœ… Complete 6 tools Software suggestions and upgrade recommendations
Serial πŸ”„ Planned 0 tools Serial number to product mapping
RMA πŸ”„ Planned 0 tools Return Merchandise Authorization

🚨 Need Help?

🀝 Contributing

Want to contribute? Check out our Development Guide for:

  • Project architecture and patterns
  • Adding new Cisco APIs
  • Testing procedures
  • Code contribution guidelines

πŸ“š This wiki contains over 3,000 lines of documentation covering everything from basic setup to advanced development. Use the navigation above to find exactly what you need!

Last updated: $(date '+%Y-%m-%d')

Clone this wiki locally