data-ai MCP Server
Your AI coding agent writes code fast — we make sure the web product actually works. Paste a URL, the agent clicks through signup/checkout/dashboards like a real user, reports failures with screenshots. Currently web only. Works with Claude Code, Cursor, Codex, Windsurf.
Discovered via github-topic:mcp and last synced 3mo ago.
1. Install the package
npx @muggleai/works
2. Add to claude_desktop_config.json
{
"mcpServers": {
"-muggleai-works": {
"command": "npx",
"args": [
"@muggleai/works"
]
}
}
}Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)
Start device-code login flow
Update project
Regenerate from new prompt
Create E2E acceptance test project
Persist a fully-specified use case (no LLM)
List by use case
List bulk-preview jobs for a project
Generate scripts
Cancel active execution
Generate final report (PDF/HTML/Markdown)
Check authentication status
Get project details
Preview before creating
Create test case
Batch replay
Get detailed results + screenshots
Tools
File
Clear credentials
Scan site for use cases
Generate test script locally
Report statistics
MCP Tools
Replay single script
Purpose
List all projects
Create from natural language
Get test case details
Cooperatively cancel an in-flight job
List run results
Poll for login completion
Delete project
Async batch-preview via OpenAI Batch API (~50% cheaper)
List use cases
List all test cases
Poll a bulk-preview job for status/results
Generate test cases
Replay existing script locally
Query cost/usage
Yes (do, test-feature-local, status, repair, upgrade)
List test scripts
Publish script to cloud, returns `viewUrl`
`muggle-remote-recommend-*` — get CI/CD and schedule recommendations
Async batch-preview via OpenAI Batch API (~50% cheaper)
Get script details
Check local browser test runner status
Purpose
Test results summary
Description
--- Troubleshooting ### "unauthorized_client" during login **Cause**: MCP configured for one environment but authenticating against another. **Fix**: Set the correct `MUGGLE_MCP_PROMPT_SERVICE_TARGET` in your MCP config and restart your client. ### Browser test runner not found ```bash muggle setup --force # Re-download muggle doctor # Diagnose ``` ### Authentication keeps expiring ```bash muggle logout # Clear all credentials rm ~/.muggle-ai/oauth-session.json ~/.muggle-ai/api-key.json muggle login # Fresh login ``` --- ## About Built by the team behind [MuggleTest](https://www.muggletest.com) — [AI-powered E2E acceptance testing](https://www.muggletest.com) for teams who ship fast. Repository structure ``` muggle-ai-works/ ├── plugin/ # Claude Code plugin (source of truth) │ ├── .claude-plugin/ # Plugin manifest (plugin.json) │ ├── skills/ # Skill definitions │ │ ├── muggle/ # /muggle:muggle — command router and menu │ │ ├── muggle-do/ # /muggle:muggle-do — autonomous dev pipeline │ │ ├── muggle-test-feature-local/ # /muggle:muggle-test-feature-local │ │ ├── muggle-test-regenerate-missing/# /muggle:muggle-test-regenerate-missing │ │ ├── muggle-status/ # /muggle:muggle-status │ │ ├── muggle-repair/ # /muggle:muggle-repair │ │ └── muggle-upgrade/ # /muggle:muggle-upgrade │ ├── hooks/ # Session hooks (hooks.json) │ ├── scripts/ # Hook scripts (ensure-electron-app.sh) │ ├── .mcp.json # MCP server config │ └── README.md # Plugin install and usage docs │ ├── src/ # Application source │ ├── cli/ # CLI commands (serve, setup, doctor, login, etc.) │ └── server/ # MCP server (tool registration, stdio transport) │ ├── packages/ # Workspace packages │ ├── mcps/ # Core MCP runtime — tool registries, schemas, services │ ├── commands/ # CLI command contracts and registration │ └── workflows/ # Workflow contracts and tests │ ├── scripts/ # Build and release │ ├── build-plugin.mjs # Assembles dist/plugin/ from plugin/ source │ ├── verify-plugin-marketplace.mjs # Validates plugin/marketplace consistency │ ├── verify-compatibility-contracts.mjs # Validates long-term surface contracts │ ├── verify-upgrade-experience.mjs # Validates in-place upgrade behavior │ └── postinstall.mjs # npm postinstall (Electron app download, Cursor MCP config, skills sync) │ ├── config/compatibility/ # Contract baselines (CLI/MCP/plugin/skills) ├── bin/ # CLI entrypoint (muggle.js → dist/cli.js) ├── dist/ # Build output (gitignored) ├── .claude-plugin/ # Marketplace catalog (marketplace.json) └── docs/ # Internal design docs and plans ``` Development commands ```bash pnpm install # Install dependencies pnpm run build # Build (tsup + plugin artifact) pnpm run build:plugin # Rebuild plugin artifact only pnpm run verify:plugin # Validate plugin/marketplace metadata consistency pnpm run verify:contracts # Validate compatibility contracts (CLI/MCP/plugin/skills) pnpm run verify:electron-release-checksums # Ensure checksums.txt exists for bundled electron release pnpm run verify:upgrade-experience # Validate existing-user cleanup + re-download flow pnpm run dev # Dev mode (watch) pnpm test # Run tests pnpm run lint # Lint (auto-fix) pnpm run lint:check # Lint (check only) pnpm run typecheck # TypeScript type check ``` CI/CD and publishing
Generate from prompt