🧪 Official MCP Server

DebuggAI MCP Server

AI-driven browser automation and E2E test server implementing the Model Context Protocol (MCP)

Test UI changes, simulate user behavior, and analyze visual outputs of running web applications — all via natural language and CLI tools.

Get API Key Watch Demo

End-to-End Testing Used to Be a Nightmare

Not just to setup, but to manage over time as you made changes to your app.

DebuggAI's MCP server offers a NEW way to test, where you never have to worry about setting up playwright, local browsers or proxies with fully remote, managed browsers that simply connect to a server running locally or remotely via a secure tunnel.

No Chrome Pop-ups

No Version Management

Zero Configuration

🚀 Features

MCP Protocol Support

Full MCP server implementation with CLI and tool registry support.

E2E Test Automation

Trigger UI tests based on user stories or natural language descriptions via the debugg_ai_test_page_changes tool.

Localhost Integration

Test your running dev app on any localhost port with simulated user flows.

Real-time Notifications

Sends real-time progress updates back to clients with step descriptions and UI state goals.

Screenshot Support

Capture final visual state of the page for LLMs with image rendering support.

Stdio Compatible

Plug into any MCP-compatible client (like Claude Desktop, LangChain agents, etc.) via stdin/stdout.

Example in Action

Input prompt: "Test the ability to create an account and login"

Task Completed
- Duration: 86.80 seconds
- Final Result: Successfully completed the task of signing up and logging into the account with the email 'alice.wonderland1234@example.com'.
- Status: Success

Watch Full Demo

🛠️ Quickstart

First: Create a free account and generate an API Key at DebuggAI

Option 1: NPX

Use this when testing or integrating into tools like Claude Desktop or your own AI agent.

npx -y @debugg-ai/debugg-ai-mcp

🧪 Claude Desktop Configuration

Example Claude Desktop Config

Add this to your Claude Desktop MCP configuration

{
  "mcpServers": {
    "debugg-ai-mcp": {
      "command": "npx",
      "args": ["-y", "@debugg-ai/debugg-ai-mcp"],
      "env": {
        "DEBUGGAI_API_KEY": "YOUR_API_KEY",
        "TEST_USERNAME_EMAIL": "test@example.com",
        "TEST_USER_PASSWORD": "supersecure",
        "DEBUGGAI_LOCAL_PORT": 3000,
        "DEBUGGAI_LOCAL_REPO_NAME": "org/project",
        "DEBUGGAI_LOCAL_BRANCH_NAME": "main",
        "DEBUGGAI_LOCAL_REPO_PATH": "/Users/you/project",
        "DEBUGGAI_LOCAL_FILE_PATH": "/Users/you/project/index.ts"
      }
    }
  }
}

🔐 Environment Variables

Variable	Description	Required
DEBUGGAI_API_KEY	API key for calling DebuggAI backend	✅
TEST_USERNAME_EMAIL	Email of test user account	❌
TEST_USER_PASSWORD	Password of test user account	❌
DEBUGGAI_LOCAL_PORT	Local port your app runs on	✅
DEBUGGAI_LOCAL_REPO_NAME	GitHub repo name	❌
DEBUGGAI_LOCAL_BRANCH_NAME	Branch name	❌
DEBUGGAI_LOCAL_REPO_PATH	Local path to repo root	❌
DEBUGGAI_LOCAL_FILE_PATH	File to test	❌

🧰 MCP Tool: debugg_ai_test_page_changes

Tool Description

Run an end-to-end test on a running web app, testing a UI feature or flow described in natural language. Allows AI agents in ANY code gen platform to quickly evaluate proposed changes and ensure new functionality works as expected.

Input Parameters

Name	Type	Required	Description
description	string	✅	What feature or page to test (e.g. "Signup page form")
localPort	number	❌	Port of your running app (default: 3000)
repoName	string	❌	GitHub repo name
branchName	string	❌	Current branch
repoPath	string	❌	Absolute path to the repo
filePath	string	❌	File to test

Ready to Get Started?

Join developers who are already using DebuggAI's MCP server to revolutionize their testing workflow.

Get Your API Key Start Free Trial

Made with 🩸, 💦, and 😭 in San Francisco