Cisco Catalog MCP Server

A FastMCP server that provides tools for querying the Cisco Commerce Catalog API. Enables LLMs to look up Cisco product pricing, availability, specifications, service options, and end-of-life information.

Features

• Product Pricing - Look up list prices for any Cisco SKU

• Product Details - Get comprehensive product information (65+ attributes)

• Availability Check - Check orderability, lead times, and stock status

• Service Options - Find available support contracts for hardware

• EOL Status - Check end-of-life dates and milestones

• Physical Specs - Get dimensions and weight for shipping/rack planning

• Product Comparison - Compare multiple products side by side

• Multi-Region Support - Query 21 different regional price lists

Prerequisites

You need Cisco API credentials to use this server:

1. Go to Cisco API Console

2. Log in with your CCO ID

3. Navigate to "My Apps and Keys"

4. Find "CCW Catalog" and click "Register" (or "Request Access" if needed)

5. Create an application with:

   • OAuth 2.0: Resource Owner Credentials (required!)

   • Enable Refresh Token

   • Select APIs: Get Item Information API, Get Mapped Services API

6. Note your Client ID and Client Secret

Installation

From Source

Using pip (when published)

Configuration

Create a .env file in the project root:

Edit .env with your credentials:

Usage

Running the Server

Configuring with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

Or if using a virtual environment:

Available Tools

lookup_pricing

Look up pricing for one or more SKUs. Returns list price, currency, and basic product info.

get_product_details

Get comprehensive details for a single SKU including all 65+ available attributes.

check_availability

Check orderability, lead times, and fulfillment restrictions.

check_end_of_life

Get all EOL milestone dates for products.

get_service_options

Find available service/support contracts for hardware.

get_physical_specs

Get dimensions, weight, and packaging info.

get_service_sku_details

Get details for service SKUs (CON-* part numbers).

compare_products

Compare 2-10 products side by side.

list_price_lists

List all available regional price lists.

list_available_attributes

List all 65+ queryable product attributes.

Supported Price Lists

Example Queries for LLMs

Once configured, you can ask your LLM things like:

• "What's the list price for a Catalyst 9300-24T-E?"

• "Compare the C9300-24T-E and C9300-48T-E switches"

• "What service options are available for C9300-24T-E?"

• "Is the WS-C3750-24TS-S end of life?"

• "What's the lead time for C9200-48P-E?"

• "Get me the physical dimensions of ISR4331/K9"

Development

Setup

Running Tests

Code Quality

API Reference

This server wraps the following Cisco Commerce Catalog APIs:

• Get Item Information API - Product details and pricing

• Get Mapped Service API - Service/support options

For full API documentation, see the Cisco Commerce Catalog Web Service Implementation Guidelines.

License

MIT License - see LICENSE for details.

Disclaimer

This is an unofficial tool and is not affiliated with or endorsed by Cisco Systems, Inc. Cisco, Catalyst, and other product names are trademarks of Cisco Systems, Inc.

Use of the Cisco Commerce Catalog API is subject to Cisco's terms of service and requires valid partner credentials.