Unofficial MCP Server for BugBug
A Model Context Protocol (MCP) server implementation in TypeScript that provides comprehensive tools for BugBug test automation platform.
- 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
- Node.js 18 or higher
- BugBug account and API token
Add to your MCP settings:
{
"mcpServers": {
"bugbug": {
"command": "npx",
"args": ["-y", "@simplypixi/bugbug-mcp-server@latest"],
"env": {
"API_KEY": "your_bugbug_api_token_here"
}
}
}
}| 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? |
| Tool Name | Description | Parameters |
|---|---|---|
get_profiles |
Get list of BugBug run profiles | page?, pageSize? |
get_profile |
Get details of a specific run profile | profileId |
| 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? |
| 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 |
| 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 |
| 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 |
| Tool Name | Description | Parameters |
|---|---|---|
get_ip_addresses |
Get list of BugBug infrastructure IP addresses | None |