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

Related MCP server: GitHub MCP Server

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`