Cloudflare Dex Analysis MCP server for AI agents

Cloudflare DEX MCP Server is an implementation of the Model Context Protocol that provides visibility into device, network, and application performance across your Zero Trust organization. It comes with Cloudflare OAuth built-in and enables remote MCP connections to access various diagnostic and monitoring tools through the Cloudflare DEX API.

Available Tools

The server provides access to various tools categorized by their functionality:

Synthetic Application Monitoring

dex_test_statistics - Analyze Cloudflare DEX Test Results by quartile given a Test ID
dex_list_tests - List configured Cloudflare DEX tests with overview performance metrics
dex_http_test_details - Retrieve detailed time series results for an HTTP DEX test by id
dex_traceroute_test_details - Retrieve detailed time series results for a Traceroute DEX test by id
dex_traceroute_test_network_path - Retrieve detailed time series results for the network path of a traceroute test
dex_traceroute_test_result_network_path - Retrieve the hop-by-hop network path for a specific Traceroute DEX test result

Remote Captures

dex_list_remote_capture_eligible_devices - Retrieve devices eligible for remote captures
dex_create_remote_pcap - Initiate a remote packet capture on a specific device
dex_create_remote_warp_diag - Initiate a remote Warp diagnostic capture on a specific device
dex_list_remote_captures - Retrieve previously created remote captures with details and status
dex_list_remote_warp_diag_contents - List filenames included in a remote WARP diag capture
dex_explore_remote_warp_diag_output - Retrieve remote WARP diag file contents by filepath
dex_analyze_warp_diag - Analyze successful WARP-diag remote captures for common issues

Fleet Status

dex_fleet_status_live - View live metrics for your fleet of zero trust devices (up to past hour)
dex_fleet_status_over_time - View historical metrics for zero trust devices over time
dex_fleet_status_logs - View historical logs for zero trust devices (up to past 7 days)
dex_list_warp_change_events - View logs of users toggling WARP connection or changing configuration

Miscellaneous

dex_list_colos - List Cloudflare colos, optionally sorted by frequency of appearance in test results

Connecting to the Server

You can access the Cloudflare DEX MCP Server from any MCP-compatible client using these methods:

Using MCP Clients with Native Remote Server Support

If your MCP client directly supports remote MCP servers:

Enter the server URL https://dex.mcp.cloudflare.com in your client interface
Follow the authentication prompts to connect

This works with clients like Cloudflare AI Playground.

Using MCP Clients without Native Remote Server Support

For clients without built-in remote server support:

Install the mcp-remote package:
```
npm install -g mcp-remote
```

Set up the client's configuration file with the following content:

{
  "mcpServers": {
    "cloudflare": {
      "command": "npx",
      "args": ["mcp-remote", "https://dex.mcp.cloudflare.com/sse"]
    }
  }
}

Restart your MCP client
A browser window will open showing the OAuth login page
Complete the authentication flow to grant access
After successful authentication, the tools will become available in your client

Usage Examples

Here are some example prompts you can use with the Cloudflare DEX MCP Server:

"Are there any anomalies in the DEX test to the internal wiki in the past 24 hours?"
"Can you see any bottlenecks in [email protected]'s network path for Zoom today between 1 and 2 PM?"
"How many macOS devices are connected right now in DFW?"
"Do you notice any unusual performance metrics for [email protected]'s device in the past few hours?"
"Capture a WARP diag for [email protected] and make sure to test all routes"
"Which users have toggled off WARP recently?"
"Which Cloudflare colo is most used by my users in the EU running DEX application tests?"
"Look at the latest WARP diag for [email protected] and tell me if you see anything notable in dns logs"

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "cloudflare" '{"command":"npx","args":["mcp-remote","https://<your-subdomain>.workers.dev/sse"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cloudflare": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://<your-subdomain>.workers.dev/sse"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "cloudflare": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://<your-subdomain>.workers.dev/sse"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect