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