What can you do with BugBug?
- Ready in one command — Set up Claude Code, Codex, Cursor, GitHub Copilot,
- Turn requirements into coverage — Use BugBug's workflow guidance and live
- Build with live BugBug context — Combine 50 MCP tools and **8 workflow
- Debug from evidence — Investigate failed runs with run details, failure
- Keep suites reliable as they grow — Review selectors, tests, reusable
- Turn run history into decisions — Summarize project and run health for
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http bugbug 'https://mcp.bugbug.io/mcp'
{
"mcpServers": {
"bugbug": {
"type": "http",
"url": "https://mcp.bugbug.io/mcp"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
BugBug Agent Plugin
Install BugBug's skills and hosted MCP connection into your AI client with the BugBug CLI:
npx @bugbug-io/cli plugin --agent=<agent>
Choose exactly one supported client: cursor, claude, vscode, codex, or
copilot. Use --dry-run to preview the installation.
The installer does not accept --token. The AI client you select completes its
own MCP OAuth sign-in after installation. The plugin connects to the production
endpoint at https://mcp.bugbug.io/mcp.
Features
- Ready in one command — Set up Claude Code, Codex, Cursor, GitHub Copilot, or VS Code with the BugBug CLI; the selected client completes OAuth sign-in.
- Turn requirements into coverage — Use BugBug's workflow guidance and live project context to plan coverage, then create tests from an approved plan.
- Build with live BugBug context — Combine 50 MCP tools and 8 workflow prompts with 9 skills so your agent can inspect the tests, suites, profiles, and project details it needs.
- Debug from evidence — Investigate failed runs with run details, failure diagnostics, screenshots, and DOM snapshots, guided by a safe debugging workflow.
- Keep suites reliable as they grow — Review selectors, tests, reusable components, and suites with BugBug-specific guidance before making targeted improvements.
- Turn run history into decisions — Summarize project and run health for actionable QA and product insights, using live data instead of guesswork.
Skills provide safe workflow guidance; MCP supplies the live BugBug data and actions. Changes to BugBug resources require the user's explicit authorization.
What you get
Skills are available on all BugBug plans. MCP access requires Pro or higher.
Bundled skills
| Skill | Capability |
|---|---|
bugbug-context-discovering | Discover the BugBug project, repository, and tested-application context. |
bugbug-project-reporting | Create read-only project health reports for PM and QA audiences. |
bugbug-selectors-authoring | Author, review, repair, and optimize element selectors. |
bugbug-steps-authoring | Choose step types and create or update step payloads. |
bugbug-test-run-debugging | Investigate test runs and classify failures. |
bugbug-tests-authoring | Create and maintain tests from an approved plan. |
bugbug-tests-planning | Plan end-to-end and UI test coverage. |
bugbug-tests-refactoring | Analyze and refactor tests, groups, components, and suites. |
bugbug-yaml-authoring | Create, validate, repair, and explain BugBug YAML. |
When to use it
Use the plugin when you want an AI coding client to work with BugBug tests and test results. Use its skills for workflow guidance and its MCP connection for live BugBug data, runs, exports, diagnostics, and explicit mutations.
For the complete MCP registry, see the MCP server docs.
Frequently asked questions
What is BugBug?
BugBug workflows for AI agents workflows for AI agents
How do I install BugBug?
It runs as a remote server. In Claude Code: claude mcp add --transport http bugbug 'https://mcp.bugbug.io/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does BugBug need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is BugBug open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains BugBug?
It is published by bugbug-io. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.