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.
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
Execute tests by name or ID and wait for results.
Retrieve detailed information on tests, suites, and historical runs.
Update test configurations and manage run profiles.
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 execution to complete and return full results
Wait for test suite execution to complete and return full results
Get error details and documentation
Show recent runs from the last 24 hours
Run a test by name or UUID with intelligent matching
Get list of BugBug run profiles
Get details of a specific run profile
Get list of BugBug tests
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.