# Muggle Works

Muggle Works is a Claude Code MCP server that runs real-browser acceptance tests and adds screenshots to pull requests. It also watches CI and review feedback.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 15 repo stars
- Author: multiplex-ai
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/multiplex-ai/muggle-ai-works
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/muggle-works

## What it does

Muggle Works takes a coding task through requirements, design, implementation, unit tests, and browser checks for the affected user flows. The MCP server then opens a pull request with screenshots, an end-to-end result, and step-level evidence.

It keeps polling the pull request after creation, responding to review comments, failed CI, and drift from the base branch. GitHub and GitLab are supported, including self-hosted GitLab. Plain-language flow descriptions can become repeatable regression scripts. Node >=22 is required.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add muggleai -- npx -y @muggleai/works
```

### Codex

**Platform CLI**
```bash
codex mcp add muggle-works -- npx -y @muggleai/works
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "muggle-works": {
            "command": "npx",
            "args": [
                "-y",
                "@muggleai/works"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "muggle-works": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@muggleai/works"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add muggle-works npx -y @muggleai/works
```

## When to use it
- run acceptance checks through a real browser
- attach screenshots of user flows to a pull request
- gate a pull request on unit tests and browser evidence
- respond to review comments and failed CI
- rerun a saved flow as a regression test

## Example prompts
- Run `/muggle:muggle-do` to add a logout button to the header and carry the task through to a pull request.
- Run `/muggle:muggle-test` to check the changed login flow in a real browser.

## Similar
- [verify-and-ship](https://affpapa.org/en/nevibecode/skills/verify-and-ship.md) — skill · 888 installs
- [conventional-git](https://affpapa.org/en/nevibecode/skills/conventional-git.md) — skill · 5400 installs
- [browser-testing-with-devtools](https://affpapa.org/en/nevibecode/skills/browser-testing-with-devtools.md) — skill · 74600 installs
- [greploop](https://affpapa.org/en/nevibecode/skills/greploop.md) — skill · 3100 installs
- [gh-switch](https://affpapa.org/en/nevibecode/skills/gh-switch.md) — skill · 2200 installs
- [check-pr](https://affpapa.org/en/nevibecode/skills/check-pr.md) — skill · 1500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
