MCP Connector

Automate BugBug Test Execution & Management

Unofficial MCP server for BugBug test automation - run tests by name or UUID, monitor execution live, explain errors, and manage suites and profiles.

Works with bugbug

90
Spark score
out of 100
Updated 5 months ago
Version 1.0.0
Models
universal

Add to Favorites

Why it matters

Integrate with the BugBug test automation platform to manage, execute, and monitor tests. This asset provides comprehensive API access for advanced testing workflows.

Outcomes

What it gets done

01

Execute tests by name or ID and wait for results.

02

Retrieve detailed information on tests, suites, and historical runs.

03

Update test configurations and manage run profiles.

04

Explain test errors and monitor execution status.

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-bugbug-mcp-server | bash

Capabilities

Tools your agent gets

wait_for_test_run

Wait for test execution to complete and return full results

wait_for_suite_run

Wait for test suite execution to complete and return full results

explain_error

Get error details and documentation

show_run_from_last_24

Show recent runs from the last 24 hours

run_test_by_name_or_id

Run a test by name or UUID with intelligent matching

get_profiles

Get list of BugBug run profiles

get_profile

Get details of a specific run profile

get_tests

Get list of BugBug tests

+7 tools

Overview

BugBug MCP Server

An unofficial TypeScript MCP server for the BugBug test automation platform, letting an AI assistant run tests by name or ID, wait for and monitor results, explain errors, and manage tests, suites, and run profiles. Use it to trigger, monitor, and debug BugBug test runs from an AI assistant instead of the BugBug web dashboard. It requires a BugBug account and API token.

What it does

An unofficial TypeScript MCP server for BugBug, a test automation platform, that lets an AI assistant manage the full test lifecycle: browsing and editing tests and suites, triggering a run, waiting for it to complete, and getting the full results or an explanation of a failure, without switching to the BugBug web dashboard. Test execution is smart rather than requiring an exact identifier - a test can be run by name or UUID with intelligent matching - and completion can be waited on synchronously so the assistant returns actual results instead of just a run-started acknowledgment.

When to use - and when NOT to

Use it when an AI assistant needs to trigger a BugBug test or suite and act on the outcome - running a specific test by name, checking what ran in the last 24 hours, or getting an explanation of why a test failed. It works across AI assistants beyond Claude, including Windsurf and GitHub Copilot, since it speaks the standard MCP protocol. It requires an active BugBug account with an API token; without one, none of the tools can authenticate. Because this is an unofficial, community-built implementation rather than one maintained by BugBug itself, it is worth treating with the same caution as any third-party wrapper around a paid platform's API - review what it does with the API token before granting it access to a production test suite.

Capabilities

Execution and monitoring: run_test_by_name_or_id, wait_for_test_run, wait_for_suite_run, which block until completion and return full results, show_run_from_last_24, explain_error. Tests and suites: get_tests, get_test, update_test (full update), partial_update_test, get_suites, get_suite. Runs and profiles: get_test_runs, get_test_run, get_profiles, get_profile.

How to install

npx -y @simplypixi/bugbug-mcp-server@latest

Configure the AI assistant's MCP settings:

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

Requires Node.js 18 or higher and a BugBug account with an API token.

Who it's for

QA and development teams using BugBug who want an AI assistant to trigger tests, wait on and interpret results, and manage suites and profiles directly from a conversation.

Source README

An unofficial TypeScript implementation of an MCP server that provides comprehensive tools for the BugBug test automation platform, including test management, execution, monitoring, and API integration.

Installation

NPX

npx -y @simplypixi/bugbug-mcp-server@latest

Configuration

MCP Settings for AI Assistants

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

Available Tools

Tool Description
wait_for_test_run Wait for test execution to complete, return full results
wait_for_suite_run Wait for test suite execution to complete, return full results
explain_error Get error details and documentation
show_run_from_last_24 Show recent runs from the last 24 hours
run_test_by_name_or_id Run a test by name or UUID with intelligent matching
get_profiles Get list of BugBug run profiles
get_profile Get details of a specific run profile
get_tests Get list of BugBug tests
get_test Get details of a specific test
update_test Update a test (full update)
partial_update_test Partially update a test
get_suites Get list of test suites
get_suite Get details of a specific test suite
get_test_runs Get list of historical test runs
get_test_run Get detailed results of a test run

Features

  • Full BugBug API integration with complete access to tests, suites, runs, and profiles
  • Cross-platform AI assistant support - works with Claude, Windsurf, GitHub Copilot, and other AI assistants
  • Advanced tools, including completion waiting, error explanation, and batch operations
  • Smart test execution - run tests by name or UUID with intelligent matching
  • Real-time monitoring - track test and suite execution with live status updates
  • Built with TypeScript for type safety and modern development practices

Environment Variables

Required

  • API_KEY - BugBug API token for authentication

Notes

Requires Node.js 18 or higher and a BugBug account with an API token. This is an unofficial MCP server for the BugBug test automation platform.

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.