BugBug MCP Server

BugBug Logo

BugBug MCP Server

Unofficial MCP Server for BugBug

A Model Context Protocol (MCP) server implementation in TypeScript that provides comprehensive tools for BugBug test automation platform.

Features

Complete BugBug API Integration: Full access to tests, suites, runs, and profiles
Cross AI Assistant Support: Works with Claude, Windsurf, GitHub Copilot, and other AI assistants
Advanced Tools: Wait for completion, error explanation, and batch operations
Smart Test Running: Run tests by name or UUID with intelligent matching
Real-time Monitoring: Track test and suite execution with live status updates
Built with TypeScript: Type safety and modern development practices

Setup

Prerequisites

Node.js 18 or higher
BugBug account and API token

Adding to AI Assistants

Add to your MCP settings:

{
  "mcpServers": {
    "bugbug": {
      "command": "npx",
      "args": ["-y", "@simplypixi/bugbug-mcp-server@latest"],
      "env": {
        "API_KEY": "your_bugbug_api_token_here"
      }
    }
  }
}

Available Tools

Advanced Tools

Tool Name	Description	Parameters
`wait_for_test_run`	Wait until test run finishes, return full results	`runId`, `timeoutMinutes?`, `pollIntervalSeconds?`
`wait_for_suite_run`	Wait until suite run finishes, return full results	`runId`, `timeoutMinutes?`, `pollIntervalSeconds?`
`explain_error`	Get error details and documentation	`runId`, `runType`
`show_run_from_last_24`	Show recent runs from last 24 hours	`runType?`, `pageSize?`
`run_test_by_name_or_id`	Run test by name or UUID with smart matching	`testNameOrId`, `profileName?`, `variables?`, `triggeredBy?`

Profiles

Tool Name	Description	Parameters
`get_profiles`	Get list of BugBug run profiles	`page?`, `pageSize?`
`get_profile`	Get details of a specific run profile	`profileId`

Tests

Tool Name	Description	Parameters
`get_tests`	Get list of BugBug tests	`page?`, `pageSize?`, `query?`, `ordering?`
`get_test`	Get details of a specific test	`testId`
`update_test`	Update a test (full update)	`testId`, `name`, `isActive`
`partial_update_test`	Partially update a test	`testId`, `name?`, `isActive?`

Test Suites

Tool Name	Description	Parameters
`get_suites`	Get list of test suites	`page?`, `pageSize?`, `query?`, `ordering?`
`get_suite`	Get details of a specific test suite	`suiteId`

Test Runs

Tool Name	Description	Parameters
`get_test_runs`	Get list of historical test runs	`page?`, `pageSize?`, `ordering?`, `startedAfter?`, `startedBefore?`
`get_test_run`	Get detailed results of a test run	`runId`
`get_test_run_status`	Get current status of a test run	`runId`
`get_test_run_screenshots`	Get screenshots from a test run	`runId`
`stop_test_run`	Stop a running test	`runId`

Suite Runs

Tool Name	Description	Parameters
`get_suite_run`	Get detailed results of a suite run	`runId`
`get_suite_run_status`	Get current status of a suite run	`runId`
`get_suite_run_screenshots`	Get screenshots from a suite run	`runId`
`stop_suite_run`	Stop a running suite	`runId`

Configuration

Tool Name	Description	Parameters
`get_ip_addresses`	Get list of BugBug infrastructure IP addresses	None

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables comprehensive interaction with the BugBug test automation platform through its API. Supports running tests, monitoring execution status, managing test suites, retrieving results and screenshots, and performing batch operations through natural language commands.

Related MCP Servers

GitHub MCP Server
asbloom-py
-
security
F
license
-
quality
Enables interaction with GitHub through the GitHub API, supporting file operations, repository management, advanced search, and issue tracking with comprehensive error handling and automatic branch creation.
Last updated -
9
253
1
TypeScript
Web-QA
GroundNG
-
security
A
license
-
quality
AI-powered agent that streamlines web testing workflows by allowing developers to record, execute, and discover tests using natural language prompts in their AI coding assistants.
Last updated -
56
Python
Apache 2.0
Node.js Debugger MCP Server
qckfx
A
security
A
license
A
quality
Provides Node.js debugging capabilities with process management for AI agents, allowing them to start/stop Node.js processes, set breakpoints, step through code, and evaluate expressions.
Last updated -
8
10
JavaScript
MIT License
Browser Tools MCP Extension
Winds-AI
-
security
F
license
-
quality
Enables AI tools to interact with your browser for enhanced frontend development, providing context-rich capabilities like API call analysis, screenshot capture, element inspection, and API testing with automatic authentication.
Last updated -
3
JavaScript

View all related MCP servers

BugBug MCP Server