DEPRECATION NOTICE

This MCP server has been deprecated and will no longer be updated. The official ThousandEyes MCP server docs here: https://docs.thousandeyes.com/product-documentation/integration-guides/thousandeyes-mcp-server

Thousandeyes MCP server community

Community project - NOT affiliated with Cisco/ThousandEyes.
Status: Alpha (MVP) read-only.

Official Cisco ThousandEyes MCP server: https://docs.thousandeyes.com/product-documentation/integration-guides/thousandeyes-mcp-server

Model Context Protocol (MCP) server for Cisco ThousandEyes v7 — lets AI assistants query tests, agents, alerts, dashboards, widgets, and test results (network, page-load, web-transactions, path-vis).

Why (business value)

• Faster troubleshooting: Ask AI to “show outages in the last hour” or “figure out where the network traffic is getting stuck at” for super fast issues identification.

• Consistency over scripts: Standard MCP tools replace one-off curl snippets.

• Safer by default: Read-only; token is only read from env.

• Composable workflows: Chain tools (tests → dashboard → widget → test results).

Current capabilities

Requirements

• Python 3.12+

• ThousandEyes API v7 bearer token in env: TE_TOKEN

Install

python3 -m pip install -r requirements.txt
# If Python is externally managed:
# python3 -m venv .venv && . .venv/bin/activate && pip install -r requirements.txt

Configure (Claude Desktop)

Add to your claude_desktop_config.json (or Dev UI):

{
  "mcpServers": {
    "thousandeyes": {
      "command": "/ABS/PATH/TO/python3",
      "args": ["/ABS/PATH/TO/repo/src/server.py"],
      "env": { "TE_TOKEN": "YOUR_OAUTH_BEARER_TOKEN" }
    }
  }
}

Token is read only from env, never written to disk.

Try it out!

Example 1: In-depth Analysis of Customer Journeys for Optimizing Performance

https://github.com/user-attachments/assets/5915fb97-20ef-42af-ad53-f6889a839330

Example 2: Visualizing Performance Data

https://github.com/user-attachments/assets/c5ef796a-42fc-422f-82c0-9f8c4c68aeb8

Here are some other prompts to try out

• What was the network health of the Patient Portal between 13:00–14:00 CET on 1 Sep 2025?

• Which regions/agents showed elevated page-load time for the Patient Portal between 08:00–10:00 UTC today?”

• Show uptime and TTFB for the Patient Portal homepage over the last 24 hours, and call out any drops.

• Which enterprise agents had >1% packet loss to api.patient-portal.example.com this morning?”

• Open the Patient Portal dashboard and list the widgets relevant to availability and the login flow and callout any widgets reporting no data

• For test , compare network latency during 10:00–10:30 UTC vs. the prior 30 minutes.”

• Show path visualization anomalies for test around 15:30 UTC yesterday.”

Security & privacy

• Read-only tools - no writes.

• No tokens or org data stored - token only via TE_TOKEN.

• Respect org rate limits - backoff on the roadmap.

Roadmap

• Adding feature support for alerts, tags, event detection, endpoint agents, etc.

• Optional retries/backoff on 429.

• Minimal CI and examples catalog.

License & attribution

• Apache-2.0

• “ThousandEyes” is a trademark of Cisco Systems, Inc. This project is NOT affiliated with Cisco/ThousandEyes.

Maintainers

• Aditya Chellam · Kiran Kabdal