What is TestingBot MCP?

The TestingBot MCP server (Model-Controller-Processor) is a service that allows AI agents and Large Language Models (LLMs) to interact with TestingBot’s testing infrastructure and features through natural language prompts.

You can manage your TestingBot tests, view test results, run tests, manage team members and more by simply sending natural language commands to your AI agent connected to the MCP server.

Features

The TestingBot MCP server offers a range of features to enhance your testing experience with your favorite AI tools such as Claude, Cursor, VS Code and more. You can simply issue commands, request information, and manage your TestingBot account using natural language.

Natural Language: Manage tests, team members, tunnels and more using simple natural language commands.
Test Result Analysis: Retrieve test results and generated assets through conversational queries.
Team Collaboration: Manage team members and permissions using AI-driven commands.
Storage: Manage and upload native mobile apps for testing on physical devices.
CDP sessions: Start and manage CDP sessions for browser automation through natural language.

How does it work?

The MCP server will run as a local process on your machine. It will receive natural language commands from your AI agent or LLM and translate these into API calls to TestingBot's services. The response is then returned back to the AI client in a conversational format.

Getting Started

To get started with the TestingBot MCP server, follow the steps below.

1-click installers

We provide 1-click installers for Visual Studio Code and Cursor. Click on one of the options below to automatically configure the TestingBot MCP server:

Visual Studio Code

Install the TestingBot MCP server for Visual Studio Code with a single click. This will automatically configure the MCP settings in your VS Code environment.

Install for VS Code

Cursor

Install the TestingBot MCP server for Cursor with a single click. This will automatically configure the MCP settings in your Cursor editor.

Install for Cursor

Claude

Install the mcp-server.mcpb file from the MCP releases page. Claude will automatically set up the TestingBot MCP server.

You will need your TestingBot API key and secret to complete the setup. You can find these in your account settings.

Manual Installation

If you prefer to install the MCP server manually, or if you're using a different AI client, you can follow the instructions below:

Prerequisites

Node.js 18 or higher
TestingBot API key and secret
An MCP-compatible client (Claude Desktop, VS Code, Cursor, etc.)

Follow these steps to install and set up the TestingBot MCP server for Visual Studio Code:

Open Visual Studio Code.
Open the command palette by pressing Ctrl+Shift+P (or Cmd+Shift+P on macOS).
Type in "MCP: Add Server"
A dropdown will appear with options. Choose the NPM Package method.
You can now enter the NPM package: @testingbot/mcp-server
You will see a confirmation screen requesting to install the TestingBot MCP server.
Click "Install". Enter your TestingBot Key and Secret which you can obtain from the member area.

Follow these steps to install and set up the TestingBot MCP server for Cursor:

Create or open the file .cursor/mcp.json.

Add the configuration to the mcp.json file:

{
  "mcpServers": {
    "testingbot": {
      "command": "npx",
      "args": ["-y", "@testingbot/mcp-server@latest"],
      "env": {
        "TESTINGBOT_KEY": "<key>",
        "TESTINGBOT_SECRET": "<secret>"
      }
    }
  }
}</secret></key>

Restart Cursor - the MCP server will now be available.

Follow these steps to install and set up the TestingBot MCP server for Claude:

Create or open the file claude_desktop_config.json.

Add the configuration to the claude_desktop_config.json file:

{
  "mcpServers": {
    "testingbot": {
      "command": "npx",
      "args": ["-y", "@testingbot/mcp-server@latest"],
      "env": {
        "TESTINGBOT_KEY": "<key>",
        "TESTINGBOT_SECRET": "<secret>"
      }
    }
  }
}</secret></key>

Restart Claude (Desktop) - the MCP server will now be available.

You can install the MCP server locally from the TestingBot MCP GitHub repository.

Example prompts

Here are some example prompts you can use with the TestingBot MCP server:

Manual Testing

"Start a live testing session on Chrome latest with Windows 11 for https://example.com"

"Open https://myapp.com on iPhone 14 with iOS 16 for manual testing"

Browsers & Devices

"List all available browsers and versions"

"Show me all available real devices for mobile testing"

Test Management

"Show me my last 20 tests"

"Mark test abc123 as passed"

Screenshots

"Take a screenshot of https://example.com on the latest Chrome and Firefox on Windows 11"

"Screenshot https://testingbot.com on a iOS 26 mobilesafari simulator"

TestingBot Storage

"Upload https://example.com/app.ipa to TestingBot"

Team Management

"Show me all team members"

CDP Session

"Create a CDP session on Chrome latest with Windows 11"

TestingBot Tunnel

"Show me all active tunnels"

FAQ

MCP servers are LLM-agnostic, which means they work with any LLM model that supports the Model Context Protocol.

No, the MCP server does not send any information to an LLM. It's the LLM that is requesting information from the MCP server. The MCP server will perform API calls to the TestingBot API.

When configuring the MCP server, you will need to specify the TestingBot Key and Secret which you can obtain from the member area. These credentials are stored on your local machine, it's the credentials that the MCP Server uses to communicate with the TestingBot API.