About BugBug
BugBug Agent Plugin installs workflow skills and a hosted MCP connection into AI coding clients for teams working with BugBug tests and results. It combines workflow guidance with live project data for planning tests, investigating failures, and reviewing run health.
Key features
- 01Install client plugin through the CLI
- 02BugBug workflow guidance skills
- 03Access live project and test data
- 04Plan coverage and create tests
- 05Inspect run diagnostics, screenshots, and DOM snapshots
- 06Summarize project and run health
Use cases
- 01Plan end-to-end and UI test coverage from requirements
- 02Investigate test failures using run diagnostics
- 03Review and improve selectors, tests, and suites
- 04Summarize run history for QA and product review
MCP support
The plugin connects to BugBug’s hosted MCP endpoint, providing clients with live BugBug data and actions for tests, runs, exports, and diagnostics. Changes to BugBug resources require explicit user authorization.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.bugbug.io/mcpclaude mcp add --transport http bugbug-io https://mcp.bugbug.io/mcp{"mcpServers":{"bugbug-io":{"type":"http","url":"https://mcp.bugbug.io/mcp"}}}Open in Cursor{"servers":{"bugbug-io":{"type":"http","url":"https://mcp.bugbug.io/mcp"}}}Open in VS Code{"mcpServers":{"bugbug-io":{"type":"http","url":"https://mcp.bugbug.io/mcp"}}}{"mcpServers":{"bugbug-io":{"serverUrl":"https://mcp.bugbug.io/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project README![]()
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.