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

BugBug MCP Server

BugBug MCP Server

Features

Setup

Prerequisites

Adding to AI Assistants

Available Tools

Advanced Tools

Profiles

Tests

Test Suites

Test Runs

Suite Runs

Configuration

Latest Blog Posts

MCP directory API