Connect to NeoLoad Web MCP

The NeoLoad Web Model Context Protocol (MCP) integration lets you interact with your performance testing platform through natural language conversations with AI assistants. Instead of navigating complex UIs or writing scripts, you can manage tests, analyze results, and generate reports through simple conversational prompts.

MCP transforms your performance testing experience by enabling you to:

  • Discover and manage workspaces and tests through natural language

  • Execute performance tests with conversational commands

  • Analyze results and generate insights automatically

  • Monitor test execution in real-time

  • Create comprehensive reports without manual data gathering

Note: MCP requires a compatible AI assistant that supports the Model Context Protocol standard. Currently tested and supported platforms include Cursor and Claude Desktop.

Before you start

Before you connect to NeoLoad MCP, make sure you have:

  • An API token from NeoLoad Web

  • A compatible AI assistant (Cursor or Claude Desktop)

  • Node.js 18 or later installed on your system

  • MCP-Remote installed on your system

Get your API token

To connect to the MCP server, you need a valid API token from NeoLoad Web. To get your API token, follow these steps:

  1. Sign in to NeoLoad Web.

  2. Select User menu > Account settings.

  3. Go to the API tokens section.

  4. Select Generate new token.

  5. Copy and securely save your API token.

Configure your AI assistant

Configure your AI assistant to connect to the NeoLoad Web MCP server. The configuration steps depend on which AI assistant you're using.

To configure Cursor to connect to NeoLoad Web MCP, follow these steps:

  1. Open your Cursor settings and open the Tools & Integrations tab.

  2. Select New MCP Server.

  3. Add the NeoLoad Web MCP server configuration using the appropriate server URL for your region:

    • US Region: https://neoload-v2.saas.neotys.com/mcp-server/mcp

    • EU Region: https://neoload-v2-eu.saas.neotys.com/mcp-server/mcp

    Copy 
    {
      "mcpServers": {
        "nlweb-mcp-server": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://neoload-v2.saas.neotys.com/mcp-server/mcp",
            "-y",
            "--header",
            "Authorization:${AUTH_HEADER}"
          ],
          "env": {
            "AUTH_HEADER": "<your NLW API token>"
          }
        }
      }
    }

  4. Enter your API token in the authentication settings.

To configure Claude Desktop to connect to NeoLoad Web MCP, follow these steps:

  1. Open your Claude Desktop configuration file.

  2. Add the NeoLoad Web MCP server configuration using the appropriate server URL for your region:

    • US Region: https://neoload-v2.saas.neotys.com/mcp-server/mcp

    • EU Region: https://neoload-v2-eu.saas.neotys.com/mcp-server/mcp

    Copy 
    {
      "mcpServers": {
        "nlweb-mcp-server": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://neoload-v2.saas.neotys.com/mcp-server/mcp",
            "-y",
            "--header",
            "Authorization:${AUTH_HEADER}"
          ],
          "env": {
            "AUTH_HEADER": "<your NLW API token>"
          }
        }
      }
    }

  3. Replace <your NLW API token> with your actual API token.

Verify your connection

To verify that your MCP connection is working correctly, follow these steps:

  1. Open your AI assistant.

  2. Start a conversation with a simple command like: "Show me all available workspaces"

  3. If the connection is successful, you should see a list of your NeoLoad Web workspaces.

If you encounter connection issues, verify that:

  • Your API token is valid and correctly entered

  • You're using the correct server URL for your region

  • The MCP feature is enabled for your account

  • Node.js 18 or later, and required dependencies are properly installed

Available MCP actions

Once connected, you have access to these MCP actions for interacting with NeoLoad Web:

Action Description
list-workspaces View all available workspaces
list-tests-workspace List tests within a specific workpace
list-results-workspace View test results for a workspace
get-result Retrieve detailed test result information
run-test Run performance tests
stop-test-execution Stop running tests
get-result-logs Access test execution logs
get-result-events View test execution events

What's next?

Now that you've connected to NeoLoad Web MCP, you can: