ThousandEyes MCP Server

The Model Context Protocol (MCP) standardizes how applications can provide context to large language models (LLMs), allowing AI assistants to access and query external data and tools/APIs, and incorporate the results of those queries in their responses.

The ThousandEyes MCP server allows you to connect an AI assistant directly to the ThousandEyes platform. The assistant can then use natural language to access and analyze ThousandEyes network monitoring data through a standardized interface.

Prerequisites

To use the ThousandEyes MCP server, your organization must not be opted out of ThousandEyes AI features. In addition, you will need:

• The API Access ThousandEyes user permission.
• A ThousandEyes API token.
• An MCP-compatible client.

For instructions on generating a new API token, see User API Tokens.

For more information on user permissions, see Role-Based Access Control.

Usage

ThousandEyes MCP server usage counts against your API rate limit.

Connect to the MCP Server

To integrate the ThousandEyes MCP server with your AI assistant, you will need to either create an MCP client, or use a framework that supports MCP, and configure it to authenticate to the MCP server.

The sections below outline example configurations for common MCP-compatible clients. Refer to the relevant client documentation for more detailed instructions.

Note: The configurations shown below are examples. You will need to adapt the configuration for your own needs. For example, Windows users will need to replace the command line to specify the location of npx:

"command": "C:\\Progra~1\\nodejs\\npx.cmd"

The <THOUSANDEYES_API_TOKEN> variable should be replaced with your API token.

Claude Desktop

To use Claude Desktop, update the configuration in claude_desktop_config.json as shown below. This example configuration uses the npx mcp-remote command, which acts as a local proxy. Requests from the Claude Desktop client are intercepted, and the necessary Authorization header is injected before forwarding the request to the ThousandEyes MCP server.

This method is useful for clients that don't have a native interface for adding custom request headers.

Note: The Claude web interface is not supported.

Additional Prerequisites:

• You will need to install Node.js. For instructions, see the Node.js documentation.

OAuth Bearer Token

{
  "mcpServers": {
    "thousandeyes-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://api.thousandeyes.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "<insert your token>"
      }
    }
  }
}

OAuth2 Dynamic Client Configuration (DCR)

Note: If OAuth2 Dynamic Client Configuration (DCR) authentication is used, a browser is required to enable access and to share the token with the client.

{
  "mcpServers": {
    "thousandeyes-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://api.thousandeyes.com/mcp",
        "--transport",
        "http-only"
      ]
    }
  }
}

Cursor IDE

The Cursor IDE's MCP client allows for the direct specification of custom HTTP headers, with the Authorization header sent with every request to the MCP server.

OAuth Bearer Token

{
  "mcpServers": {
    "thousandeyes-mcp-remote": {
      "url": "https://api.thousandeyes.com/mcp",
      "headers": {
        "Authorization": "Bearer <THOUSANDEYES_API_TOKEN>"
      }
    }
  }
}

OAuth2 Dynamic Client Configuration (DCR)

Note: If OAuth2 Dynamic Client Configuration (DCR) authentication is used, a browser is required to enable access and to share the token with the client.

{
  "mcpServers": {
    "thousandeyes-mcp-remote": {
      "url": "https://api.thousandeyes.com/mcp"
    }
  }
}

VS Code

VS Code's input variables allow you to create a secure prompt within the IDE for the user to enter their API token, rather than hardcoding the token into a configuration file.

The ${input:te-key} variable is then dynamically replaced with the entered key at runtime, preventing the token from being accidentally saved to source control.

Additional Prerequisites:

• You will need to install Node.js. For instructions, see the Node.js documentation.
• Copilot features must be enabled in VS Code.

OAuth Bearer Token

{
  "inputs": [
    {
      "type": "promptString",
      "id": "te-key",
      "description": "ThousandEyes API Key",
      "password": true
    }
  ],
  "servers": {
    "mcp-thousandeyes": {
      "url": "https://api.thousandeyes.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:te-key}"
      }
    }
  }
}

AWS Kiro

Use the configuration examples below as a basis for creating a ~/.kiro/settings/mcp.json file.

Additional Prerequisites:

• You will need to install Node.js. For instructions, see the Node.js documentation.

OAuth Bearer Token

{
  "mcpServers": {
    "thousandeyes-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://api.thousandeyes.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "<THOUSANDEYES_API_TOKEN>"
      }
    }
  }
}

OAuth2 Dynamic Client Configuration (DCR)

Note: If OAuth2 Dynamic Client Configuration (DCR) authentication is used, a browser is required to enable access and to share the token with the client.

{
  "mcpServers": {
    "thousandeyes-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://api.thousandeyes.com/mcp",
        "--transport",
        "http-only"
      ]
    }
  }
}

MCP Server Functionality and Sample Prompts

Recommendation: Be selective with the tools you enable. Enabling too many tools at once can lead to degraded MCP server performance, including delayed responses and timeouts.

Core Monitoring

Advanced Analysis

AI-Powered Skills

Endpoint Monitoring

Network Path Analysis

Account Management

Note: By default, queries are scoped to your default account group. To expand the scope to multiple or all account groups, you can specify which account groups you want data retrieved from in your prompt to the MCP server.

Troubleshooting

If you are using an MCP server client that uses npx and encounter the command not found error, you may not have Node.js installed. For instructions, see the Node.js documentation.

You can use the following commands to verify Node.js is installed correctly in a terminal:

# bash% node --version
v22.18.0
# npx --version
10.9.3

Source: ThousandEyes Documentation — Last updated February 2026
© 2025 Cisco Systems, Inc. and its affiliates. All rights reserved.