CX Assistant MCP Server

Query Cisco CX Assistant (production and stage) directly from Cursor using natural language. No API keys, no curl, no JavaScript — just type your question.

Prerequisites

• Python 3.11 or higher (python --version to check)
• Cursor editor
• Mac only: Google Chrome installed — required for Cisco Duo device trust during login

Setup (one time per machine)

1. Get the project

Copy the cx-assistant-mcp folder to your machine, for example:

Windows: C:\Users\<your-name>\Projects\cx-assistant-mcp

Mac: /Users/<your-name>/Projects/cx-assistant-mcp

2. Install dependencies

Open a terminal in the project folder and run:

Windows:

python -m venv venv
venv\Scripts\pip install -r requirements.txt
venv\Scripts\python -m playwright install chromium

Mac:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
playwright install chromium

Mac note: Login uses your real installed Chrome (required for Cisco Duo device trust). If Chrome is not installed, it falls back to bundled Chromium, which may fail Duo authentication. Install Google Chrome if login fails.

3. Configure Cursor

Open this file (create it if it doesn't exist):

Windows: C:\Users\<your-name>\AppData\Roaming\Cursor\User\mcp.json

Mac: ~/.cursor/mcp.json

Add this configuration (replace <your-name> with your username):

Windows:

{
  "mcpServers": {
    "cx-assistant": {
      "command": "C:/Users/<your-name>/Projects/cx-assistant-mcp/venv/Scripts/python.exe",
      "args": ["C:/Users/<your-name>/Projects/cx-assistant-mcp/server.py"]
    }
  }
}

Mac:

{
  "mcpServers": {
    "cx-assistant": {
      "command": "/Users/<your-name>/Projects/cx-assistant-mcp/venv/bin/python",
      "args": ["/Users/<your-name>/Projects/cx-assistant-mcp/server.py"]
    }
  }
}

Restart Cursor. Go to Settings → Features → MCP — you should see cx-assistant listed with 5 tools.

4. Login

In Cursor chat, type:

Login to CX Assistant production

A browser window opens. Complete your Cisco Duo login. The window closes automatically. You're ready.

Using the Tools

Ask a free-form question (stage)

Ask stage: What are the adoption barriers for United Nations CAV BU 104461?

Ask using pre-built questions (production)

Ask production structured: What is the renewal risk for deal D-72595030?

Ask a free-form question (production)

Ask production open: Summarize my top 10 at-risk renewals

Re-authenticate (when session expires)

Login to CX Assistant stage

Available Tools

Tips

• Use CAV BU IDs for consistent results: United Nations CAV BU 104461 is more reliable than just United Nations
• Deal IDs should be in format D-XXXXX (e.g. D-72595030)
• Session cookies expire — if you get an authentication error, run Login to CX Assistant production again
• Stage vs Production: Use stage for testing and exploration; use production for real customer data
• Browser selection: On Mac, login uses real Chrome (for Duo device trust) with bundled Chromium as fallback. On Windows, real Edge is tried first, then bundled Chromium. Both production and stage use the same browser logic.

Troubleshooting