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

Tool	Environment	Question type	Best for
ask_production_structured	Production	116 pre-built	Known question types with deal IDs, customer names
ask_production_open	Production	Free-form	Ad-hoc questions, exploration
ask_stage_structured	Stage	116 pre-built	Testing pre-built questions against stage data
ask_stage_open	Stage	Free-form	Testing new questions, exploring stage data
login	Both	—	Authenticate or re-authenticate

---

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

Problem	Solution
MCP not showing in Cursor	Check mcp.json path and restart Cursor
"Not authenticated" error	Run Login to CX Assistant production
Browser doesn't open	Run playwright install chromium in the project folder
"Could not find matching question"	Use ask_*_open for free-form questions instead
Login browser doesn't close	Complete Duo login — browser closes automatically after redirect
Duo login fails on Mac	Install Google Chrome — bundled Chromium lacks device trust support