bugbug-mcp-server

Name: bugbug-mcp-server
Availability: InStock
Author: Mariusz Wójcik

The BugBug MCP Server is an unofficial implementation of an MCP server for the BugBug test automation platform. Built in TypeScript, it offers comprehensive API integration, support for AI assistants, and advanced features like real-time monitoring. This allows for efficient execution and management of tests.

GitHub

GitHub Stars

User Rating

Not Rated

Favorites

Views

Forks

Issues

README

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`