@testingbot/mcp-server
TestingBot's official MCP Server for AI-powered testing automation
Versions
1.0.2latest1.0.11.0.0Tools 32
getBuilds Get a list of builds with optional pagination. Builds group related tests together.
getTestsForBuild Get all tests associated with a specific build ID.
deleteBuild Delete a build and all its associated tests by build ID.
createCdpSession Create a remote browser session on TestingBot and get its CDP (Chrome DevTools Protocol) URL for direct browser control. Use this to automate browsers via CDP clients like Puppeteer or Playwright.
getBrowsers Get list of available browsers and platforms for testing. Optionally filter by type (web or mobile).
getDevices Get list of available mobile devices for testing (real devices and simulators).
uploadFile Upload a local file (APK, IPA, or ZIP) to TestingBot storage for mobile app testing. Returns an app_url for use in tests.
uploadRemoteFile Upload a file from a remote URL to TestingBot storage. The file will be downloaded from the URL and stored.
getStorageFiles List all files in TestingBot storage with pagination.
deleteStorageFile Delete a file from TestingBot storage using its app_url.
startLiveSession Start an interactive live testing session on TestingBot. Opens a real browser or mobile device for manual testing. Supports both desktop browsers (Chrome, Firefox, Safari, Edge, IE) and mobile devices (iOS, Android).
startDesktopLiveSession Convenience tool to start a desktop browser live testing session. Automatically sets platformType to
startMobileLiveSession Convenience tool to start a mobile device live testing session. Automatically sets platformType to
getTeam Retrieve team settings and information including plan details, team size, and configuration.
getUsersInTeam Get a list of all users in your team with their roles and permissions.
getUserFromTeam Retrieve detailed information about a specific user in your team by their user ID.
takeScreenshot Take screenshots of a URL across multiple browsers and platforms. Returns a screenshot ID to retrieve results.
retrieveScreenshots Retrieve screenshot results by screenshot ID. Returns URLs to the generated screenshots.
getScreenshotList Get a list of all screenshot jobs with pagination.
getTunnelList Get a list of all active TestingBot tunnels. Tunnels allow you to test websites behind firewalls or on your local machine.
deleteTunnel Delete an active TestingBot tunnel by its ID. This will terminate the tunnel connection.
getFailureLogs Fetch and return session log file content (selenium, browser, chrome, vm, appium) for a test by session ID. Use this to debug failures — pass failuresOnly=true to extract only error/exception/stack-trace lines.
getTests Retrieve a list of recent tests with optional pagination. Returns test details including status, browser, platform, video and duration.
getTestDetails Get detailed information about a specific test by session ID. Includes logs, screenshots, video URLs, and execution metadata.
updateTest Update test metadata such as name, status (passed/failed), and other attributes. Useful for marking tests after execution.
deleteTest Delete a test by session ID. This permanently removes the test and its associated data.
stopTest Stop a running test by session ID. This terminates the test execution immediately.
listTestFiles Scan a project directory and return test files for the detected framework. Read-only — never modifies files.
setupTestingBot Detect the testing framework in a project and return the ready-to-paste TestingBot configuration snippet, install command, and env-var requirements. Read-only — never modifies files; the agent or user applies the snippet.
getUserInfo Get current user account information including minutes used, plan details, and account status.
updateUserInfo Update user account information such as name, email, or other profile details.
tb_login Authenticate with TestingBot — no API key or secret to copy or paste. By default it opens your browser, you
Permissions 4
network medium filesystem low shell high env_vars low