BugBug MCP

BugBug MCP is BugBug's official Model Context Protocol server. It gives AI agents live access to BugBug through 50 tools and 8 predefined workflow prompts.

BugBug MCP access requires a Pro or higher BugBug plan. BugBug Skills are available on all plans.

Recommended setup: BugBug Plugin

Install BugBug Plugin through the CLI. It is the best setup route for supported clients because it configures MCP and installs BugBug Skills together. Choose your AI client:

Claude Code

npx @bugbug-io/cli plugin --agent=claude

Codex

npx @bugbug-io/cli plugin --agent=codex

Cursor

npx @bugbug-io/cli plugin --agent=cursor

GitHub Copilot

npx @bugbug-io/cli plugin --agent=copilot

VS Code

npx @bugbug-io/cli plugin --agent=vscode

Manual configuration

For a Streamable HTTP MCP client not supported by the installer, add this server entry to its MCP configuration. Keep any existing server entries and follow that client's documentation for the configuration-file location.

{
  "mcpServers": {
    "bugbug": {
      "type": "http",
      "url": "https://mcp.bugbug.io/mcp",
    }
  }
}

Restart the selected client if needed, then complete its MCP OAuth sign-in flow. The CLI plugin command does not accept a --token option.

What the agent can do

BugBug MCP tools can inspect tests, suites, runs, steps, groups, components, profiles, variables, project settings, documentation, and available run evidence. Authorized tools can also create or update test assets and start runs.

See the BugBug MCP tools reference for the tool list and safe prompt examples.

Alternative setup: BugBug MCP only

Use this only when you do not want the bundled skills or your client cannot use the plugin installer. Use the Custom MCP client tab above to add the hosted endpoint to your client.

When supported, let the client complete the OAuth flow. For CI/CD or other non-interactive environments, use the authentication method supported by that environment and keep credentials in its secret manager.

Security best practices

• Verify the endpoint before connecting: https://mcp.bugbug.io/mcp.

• Prefer OAuth for interactive local use.

• Explicitly authorize creation, updates, deletion, imports, and test runs.

• Use read-only inspection first for planning, review, and debugging.

• Do not commit credentials to repositories.

Related docs

• BugBug Plugin

• BugBug MCP tools

• BugBug Skills

FAQ

What is the BugBug MCP server, and what can AI agents do with it?

BugBug MCP is BugBug’s official Model Context Protocol server. It gives authorized AI agents access to 50 tools for inspecting, creating and maintaining tests, suites, steps, components, profiles and variables. Agents can also start test runs, monitor their progress and investigate failures using available run evidence.

How is BugBug MCP different from a browser-control MCP server such as Playwright MCP?

A browser-control MCP helps an agent explore and interact with a live website. BugBug MCP connects the agent to persistent regression assets, reusable components, run history and failure evidence managed in BugBug. They can work together: browser access provides application context, while BugBug MCP manages the shared regression suite.

Which AI clients can connect to BugBug MCP?

BugBug MCP works with Cursor, Claude Code, VS Code, Codex and GitHub Copilot through the BugBug Plugin. Other AI clients can connect if they support Streamable HTTP MCP and OAuth. These clients can use the hosted BugBug MCP endpoint through manual configuration.

How does BugBug MCP authenticate and protect project data?

Interactive clients authenticate with BugBug through OAuth. Agents can only access projects available to the authenticated account. For safer operation, begin with read-only inspection and require human confirmation for actions that create, update, delete, import or run BugBug assets. Credentials should never be committed to a repository.

Which BugBug plans include MCP access?

BugBug MCP is available on the Pro plan and higher. BugBug Skills are available on all plans, but Skills alone do not give an AI agent live access to your BugBug projects.