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 |