Cisco Catalog

You can run the Cisco Catalog MCP Server to query Cisco Commerce Catalog data such as pricing, availability, product details, service options, and end-of-life information. It exposes a set of tools you can call from an MCP client or integrated LLM workflow to fetch up-to-date Cisco product information and comparisons.

How to use

Once you have the MCP server running, you can access a set of dedicated tools to retrieve data about Cisco SKUs. The server supports actions such as looking up pricing, fetching full product details (65+ attributes), checking availability and lead times, discovering service options, verifying end-of-life milestones, obtaining physical specs, and comparing multiple products side by side. You can also query regional price lists and available attributes to tailor responses for your location and use case.

How to install

Prerequisites: You need Python installed on your system.

# Clone the MCP server repository
git clone https://github.com/seanerama/cisco-commerce-mcp
cd cisco-commerce-mcp

# Install in editable mode (development setup)
pip install -e .

Configuration and running

Create a configuration file and supply your Cisco API credentials. The server expects the following environment variables.

CISCO_CLIENT_ID=your_client_id_here
CISCO_CLIENT_SECRET=your_client_secret_here
CISCO_CCO_USERNAME=your_cco_username
CISCO_CCO_PASSWORD=your_cco_password
CISCO_PRICE_LIST=GLUS  # Optional, defaults to GLUS (US pricing)

Starting the server

You can start the server using the installed command or by running the module directly.

cisco-catalog-mcp

# or run directly
python -m cisco_catalog_mcp.server

Claude Desktop configuration

If you use Claude Desktop, configure the MCP server by adding an entry for Cisco Catalog with the appropriate command and environment variables.

{
  "mcpServers": {
    "cisco-catalog": {
      "command": "cisco-catalog-mcp",
      "env": {
        "CISCO_CLIENT_ID": "your_client_id",
        "CISCO_CLIENT_SECRET": "your_client_secret",
        "CISCO_CCO_USERNAME": "your_username",
        "CISCO_CCO_PASSWORD": "your_password"
      }
    }
  }
}

Alternative Python module run

If you prefer running via the Python module, the following configuration works in your environment configuration file.

{
  "mcpServers": {
    "cisco-catalog": {
      "command": "python",
      "args": ["-m", "cisco_catalog_mcp.server"],
      "env": {
        "CISCO_CLIENT_ID": "your_client_id",
        "CISCO_CLIENT_SECRET": "your_client_secret",
        "CISCO_CCO_USERNAME": "your_username",
        "CISCO_CCO_PASSWORD": "your_password"
      }
    }
  }
}

What you can do with the MCP server

After starting the server, you can call its tools such as lookup_pricing, get_product_details, check_availability, check_end_of_life, get_service_options, get_physical_specs, get_service_sku_details, compare_products, list_price_lists, and list_available_attributes to fetch the data you need for pricing, specs, and lifecycle information.

Notes on usage

• You can configure a default price list region with the CISCO_PRICE_LIST variable to tailor responses to your locale. - Ensure your Cisco API credentials have access to the Get Item Information API and Get Mapped Services API. - When running in Claude Desktop, you can reuse the same environment variables configured in your local shell.

Security considerations

Keep your client secret and credentials secure. Do not commit the .env file or credential values to version control. Use secret management where available and rotate credentials periodically.

Troubleshooting

If the server fails to start, verify that Python and pip are available, the environment variables are set, and that there are no network issues preventing access to Cisco APIs. Check for authentication errors from the Cisco API and confirm that your credentials have the required API access.

Available tools

lookup_pricing

Fetch list price, currency, and basic product info for one or more Cisco SKUs.

get_product_details

Retrieve comprehensive product details for a single SKU, including 65+ attributes.

check_availability

Check whether products are orderable, along with lead times and restrictions.

check_end_of_life

Obtain end-of-life milestone dates for given products.

get_service_options

Find available service and support contracts for hardware.

get_physical_specs

Get physical dimensions, weight, and packaging information.

get_service_sku_details

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

compare_products

Compare multiple products side by side.

list_price_lists

List all available regional price lists.

list_available_attributes

List all queryable product attributes.