ThousandEyes

This MCP server lets AI assistants query ThousandEyes v7 data such as tests, agents, dashboards, and test results in a safe read-only mode. You can chain tools to build composable workflows and get fast, structured insights without writing custom API calls.

How to use

You interact with the ThousandEyes MCP server by using an MCP client that speaks the MCP protocol. The server exposes a set of read-only endpoints that let you query tests, agents, dashboards, widgets, users, and account groups. You can combine multiple tool calls to drill into test results, visualize path visibility, or inspect specific dashboards and their widgets.

How to install

Prerequisites: make sure you have Python 3.12 or newer installed on your system.

Install the required Python packages using the official requirements file included with the project.

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

Run the MCP server using the provided Python entry point and pass your API token via the TE_TOKEN environment variable. The server script is located under the repository path indicated in the configuration snippet.

Configuration and startup

Configure your client to connect to the MCP server by using the standard stdio-based MCP command. The server is started as a local process that your MCP client can communicate with through standard input/output.

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

What you can query (tools)

You can list and retrieve information about tests, agents, dashboards, and results using the following tool endpoints:

• te_list_tests(aid?, name_contains?, test_type?) — Lists tests (filter by name/type/AG)
• te_list_agents(agent_types?, aid?) — Lists enterprise / enterprise-cluster / cloud agents
• te_get_test_results(test_id, test_type, window?/start?/end?/aid?/agent_id?) — Test results for network, page-load, web-transactions
• te_get_path_vis(test_id, window?/start?/end?/aid?/agent_id?/direction?) — Path visualization data
• te_list_dashboards(aid?, title_contains?) — Lists dashboards
• te_get_dashboard(dashboard_id, aid?) — Dashboard details incl. widget list
• te_get_dashboard_widget(dashboard_id, widget_id, window?/start?/end?/aid?) — Widget data for a dashboard
• te_get_users() — Lists users in the ThousandEyes account
• te_get_account_groups() — Lists account groups available to the authenticated org

Security & privacy

All tools are read-only. Tokens are read from the environment and are not stored on disk. The server respects organizational rate limits and enforces access controls to protect data.

Notes and troubleshooting

If you encounter token-related errors, verify that TE_TOKEN is correctly set in the environment before starting the server. Ensure the server process has read access to the required credentials and that your MCP client is configured to pass requests to the local stdio channel established by the server.

Available tools

te_list_tests

Lists tests with optional filters for aid, name_contains, and test_type. Endpoint: GET /v7/tests

te_list_agents

Lists enterprise/enterprise-cluster/cloud agents. Endpoint: GET /v7/agents

te_get_test_results

Fetches test results for a specific test ID and type across a time window or specific agents. Endpoint: GET /v7/test-results/{testId}/{testType}

te_get_path_vis

Retrieves path visualization data for a given test. Endpoint: GET /v7/test-results/{testId}/path-vis

te_list_dashboards

Lists dashboards available to the account. Endpoint: GET /v7/dashboards

te_get_dashboard

Gets details for a dashboard including its widgets. Endpoint: GET /v7/dashboards/{dashboardId}

te_get_dashboard_widget

Fetches data for a specific widget within a dashboard. Endpoint: GET /v7/dashboards/{dashboardId}/widgets/{widgetId}

te_get_users

Lists users in the ThousandEyes account. Endpoint: GET /v7/users

te_get_account_groups

Lists account groups available to the authenticated org. Endpoint: GET /v7/account-groups