Muggle Works — Claude Code MCP server: install
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.
Apache-2.0 ★ 15 updated 2026-11-16
claude mcp add muggleai -- npx -y @muggleai/worksWhat Muggle Works 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.
What it helps with
- 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 for the agent
- Run
/muggle:muggle-doto add a logout button to the header and carry the task through to a pull request. - Run
/muggle:muggle-testto check the changed login flow in a real browser.
How to install Muggle Works
Platform CLI
claude mcp add muggleai -- npx -y @muggleai/worksPlatform CLI
codex mcp add muggle-works -- npx -y @muggleai/worksConfig file
{
"mcpServers": {
"muggle-works": {
"command": "npx",
"args": [
"-y",
"@muggleai/works"
]
}
}
}Config file
{
"servers": {
"muggle-works": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@muggleai/works"
]
}
}
}Platform CLI
gemini mcp add muggle-works npx -y @muggleai/worksStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Muggle Works
How do I install Muggle Works in Claude Code?
Run these commands in order: claude mcp add muggleai -- npx -y @muggleai/works, then claude mcp add muggle-works -- npx -y @muggleai/works.
What does Muggle Works do?
It takes a task from requirements and implementation through unit tests, real-browser acceptance checks, and a pull request with screenshots. Afterward, it monitors review feedback, CI, and changes to the base branch.
What does Muggle Works need to run?
It needs Node >=22, the @muggleai/works package, and an MCP client. The full workflow also uses a repository with pull-request or merge-request support, a development server, and testable user flows.