Provides read-only access to Cisco ThousandEyes v7 API for querying network monitoring data including tests, agents, alerts, dashboards, widgets, and test results (network, page-load, web-transactions, path visualization).
thousandeyes-mcp
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).
Community project - NOT affiliated with Cisco/ThousandEyes.
Status: Alpha (MVP) read-only.
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
Tool | What it does | Endpoint(s) |
| Lists tests (filter by name/type/AG) |
|
| Lists enterprise / enterprise-cluster / cloud agents |
|
| Test results (e.g.,
,
,
; not
) |
|
| Path visualization data |
|
| Lists dashboards |
|
| Dashboard details incl. widget list |
|
| Widget data for a dashboard |
|
| Lists users in the ThousandEyes account |
|
| Lists account groups available to the authenticated org |
|
Requirements
Python 3.12+
ThousandEyes API v7 bearer token in env:
TE_TOKEN
Install
Configure (Claude Desktop)
Add to your claude_desktop_config.json (or Dev UI):
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