1---2name: te-network-monitoring3description: Cisco ThousandEyes — test management, agent inventory, test results, dashboards, path visualization, user/account management. Use when checking ThousandEyes test results, viewing network monitoring dashboards, listing agents, investigating alerts, or assessing overall network performance.4license: Apache-2.05---6
7# ThousandEyes Network Monitoring
8
9## MCP Servers
10
11### Community Server (local, stdio)
12
13- **Repository**: [CiscoDevNet/thousandeyes-mcp-community](https://github.com/CiscoDevNet/thousandeyes-mcp-community)
14- **Transport**: stdio (Python)
15- **Install**: `git clone` + `pip install -r requirements.txt`
16- **Script**: `src/server.py`
17- **Python**: 3.12+
18- **Requires**: `TE_TOKEN`
19- **Status**: Alpha/MVP, read-only
20
21### Official Server (remote, HTTP)
22
23- **Repository**: [CiscoDevNet/ThousandEyes-MCP-Server-official](https://github.com/CiscoDevNet/ThousandEyes-MCP-Server-official)
24- **Endpoint**: `https://api.thousandeyes.com/mcp`
25- **Transport**: Remote HTTP (via `npx mcp-remote`)
26- **Auth**: Bearer token (`Authorization: Bearer <TE_TOKEN>`)
27- **No local install** — hosted by Cisco
28- **Requires**: `TE_TOKEN`, Node.js (for npx), org not opted out of AI features
29
30## Community Server Tools (9)
31
32| Tool | Parameters | What It Does |
33|------|-----------|--------------|
34| `te_list_tests` | `aid?, name_contains?, test_type?` | List all configured tests with filtering by name, type, or account group |
35| `te_list_agents` | `agent_types?, aid?` | List enterprise, enterprise-cluster, and cloud agents |
36| `te_get_test_results` | `test_id, test_type, window?/start?/end?/aid?/agent_id?` | Fetch network, page-load, and web-transaction test results |
37| `te_get_path_vis` | `test_id, window?/start?/end?/aid?/agent_id?/direction?` | Path visualization — hop-by-hop network path data |
38| `te_list_dashboards` | `aid?, title_contains?` | List all ThousandEyes dashboards |
39| `te_get_dashboard` | `dashboard_id, aid?` | Dashboard details including widget inventory |
40| `te_get_dashboard_widget` | `dashboard_id, widget_id, window?/start?/end?/aid?` | Widget data for a specific dashboard widget |
41| `te_get_users` | none | List users in the ThousandEyes account |
42| `te_get_account_groups` | none | List account groups accessible to the authenticated org |
43
44## Official Server Tools (~20)
45
46### Core Monitoring
47| Tool | What It Does |
48|------|--------------|
49| List Tests | View all configured tests (web, network, DNS, voice) |
50| Get Test Details | Detailed information about a specific test |
51| List Events | Find network and application problems within time ranges |
52| Get Event Details | Deep dive into specific events with impacted targets |
53| List Alerts | View triggered or cleared alert rules |
54| Get Alert Details | Comprehensive alert information with conditions and targets |
55| Search Outages | Find network and application outages with filters |
56| Instant Tests | **Active troubleshooting** — run tests on demand |
57
58### Advanced Analysis
59| Tool | What It Does |
60|------|--------------|
61| Get Anomalies | Detect metric anomalies in test data over time |
62| Get Metrics | Retrieve aggregated metrics for dashboards and reports |
63| Views Explanations | **AI-powered** — explain specific test results and visualizations |
64
65### Endpoint Monitoring
66| Tool | What It Does |
67|------|--------------|
68| List Endpoint Agents and Tests | List endpoint agents with filtering |
69| Get Endpoint Agent Metrics | Time series data from endpoint agents |
70
71### Network Path & BGP Analysis
72| Tool | What It Does |
73|------|--------------|
74| Get Path Visualization | Network paths and hop-by-hop routing |
75| Get Full Path Visualization | Comprehensive path data for all agents |
76| Get BGP Test Results | BGP reachability and routing information |
77| Get BGP Route Details | Detailed AS path and routing information |
78
79### Account Management
80| Tool | What It Does |
81|------|--------------|
82| Get Account Groups | List available account groups |
83
84## Key Concepts
85
86| Concept | Description |
87|---------|-------------|
88| **Test** | Synthetic probe: HTTP, network (ICMP/TCP), DNS, voice, SIP |
89| **Agent** | Vantage point: Enterprise (on-prem), Cloud (Cisco-hosted) |
90| **Path Visualization** | Hop-by-hop path showing latency, loss, and MPLS labels per hop |
91| **Instant Test** | On-demand test execution for active troubleshooting |
92| **Endpoint Agent** | Workstation agent monitoring WiFi, VPN, and SaaS experience |
93
94## Workflow: Network Performance Assessment
95
96When a user asks "how's the network performing?":
97
981. **List tests**: `te_list_tests` — discover all configured monitoring tests
992. **Test results**: `te_get_test_results` for key network tests — latency, loss, jitter
1003. **Alerts**: List Alerts (official) — any active alert conditions
1014. **Events**: List Events (official) — recent network/application problems
1025. **Dashboards**: `te_list_dashboards` + `te_get_dashboard_widget` — executive summary metrics
1036. **Report**: network performance dashboard with test-by-test metrics and alert status
104
105## Workflow: Path Troubleshooting
106
107When investigating "traffic to example.com is slow from the London office":
108
1091. **Find test**: `te_list_tests` filtered by name or target
1102. **Path visualization**: `te_get_path_vis` for the relevant test — hop-by-hop path
1113. **Full path**: Get Full Path Visualization (official) — all agents, all paths
1124. **BGP routes**: Get BGP Route Details (official) — is traffic taking an unexpected AS path?
1135. **Anomalies**: Get Anomalies (official) — metric deviations over time
1146. **Report**: path analysis with hop-by-hop latency, loss source, and routing assessment
115
116## Workflow: Outage Investigation
117
118When responding to a ThousandEyes alert:
119
1201. **Alerts**: List Alerts (official) — active alert details, affected tests
1212. **Events**: List Events (official) + Get Event Details — timeline, impacted targets
1223. **Outages**: Search Outages (official) — broader outage scope (ISP, CDN, SaaS)
1234. **Path vis**: `te_get_path_vis` — where in the path is the problem?
1245. **Instant test**: Instant Tests (official) — run on-demand tests from multiple agents
1256. **Report**: outage timeline with root cause (ISP node X, hop Y, BGP route change)
126
127## Workflow: Endpoint Experience
128
129When investigating "users complain about slow VPN":
130
1311. **Endpoint agents**: List Endpoint Agents and Tests (official) — find agents on affected users
1322. **Metrics**: Get Endpoint Agent Metrics (official) — WiFi signal, VPN latency, DNS response
1333. **Path vis**: Get Path Visualization (official) — user-to-VPN-gateway path
1344. **Correlate**: compare with enterprise agent test results — is it user-side or network-side?
1355. **Report**: endpoint experience analysis with WiFi, VPN, and path diagnostics
136
137## Workflow: BGP Monitoring
138
139When auditing BGP health:
140
1411. **BGP tests**: `te_list_tests` filtered by type=bgp
1422. **BGP results**: Get BGP Test Results (official) — reachability, prefix visibility
1433. **Route details**: Get BGP Route Details (official) — AS paths, origin validation
1444. **Anomalies**: Get Anomalies (official) — BGP metric deviations
1455. **Report**: BGP health summary with route stability assessment
146
147## Integration with Other Skills
148
149| Skill | How They Work Together |
150|-------|----------------------|
151| `pyats-routing` | ThousandEyes external BGP view + pyATS internal routing state = full picture |
152| `pyats-troubleshoot` | ThousandEyes path vis (internet view) + pyATS show commands (device view) |
153| `aws-network-ops` | ThousandEyes cloud agent tests + AWS VPC flow logs for hybrid visibility |
154| `gcp-cloud-monitoring` | ThousandEyes metrics + GCP Cloud Monitoring for cross-platform correlation |
155| `meraki-monitoring` | ThousandEyes synthetic tests + Meraki Dashboard live diagnostics |
156| `fmc-firewall-ops` | ThousandEyes path vis through firewall + FMC rule audit |
157| `servicenow-change-workflow` | ThousandEyes alerts trigger ServiceNow incidents |
158| `gait-session-tracking` | Record all ThousandEyes investigations in GAIT audit trail |
159| `slack-network-alerts` | Deliver ThousandEyes alert summaries to Slack channels |
160
161## Important Rules
162
163- **Read-only** — community server is read-only; official server has Instant Tests (on-demand test execution)
164- **API rate limits** — ThousandEyes API usage counts against your org's rate limit; avoid rapid-fire queries
165- **Account group scope** — queries default to the authenticated user's account group; specify `aid` for cross-group queries
166- **AI features** — official server requires org not opted out of ThousandEyes AI features
167- **Time windows** — use `window` (seconds) or `start`/`end` (ISO 8601) for time-bounded queries
168- **Record in GAIT** — log all ThousandEyes investigations for audit trail
169
170## Environment Variables
171
172- `TE_TOKEN` — ThousandEyes API v7 OAuth bearer token (used by both community and official servers)
gabrielmoreira