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.