@emuluxe/mcp-server
v1.1.1
Published
Let AI agents launch and verify Emuluxe mobile simulations.
Readme
Emuluxe MCP Server 🚀
Emuluxe MCP lets AI agents launch and verify high-fidelity mobile simulations using the Emuluxe simulation engine. It is built for teams that already use MCP-enabled editors or assistants and want those agents to check mobile UI in realistic device contexts.
🌟 Features
- Zero-Install: Run instantly with
npx. - Multi-IDE Ready: Native support for Antigravity, Cursor, and VS Code.
- Instant Launch: Deep-link integration triggers simulation panels automatically.
- Production-Grade: Built on the official Emuluxe Simulation API.
- AI-Powered Verification: Ideal when your team wants AI agents to verify mobile layouts instead of only suggesting code changes.
Best for
- Cursor, VS Code, Windsurf, and Antigravity teams already using MCP
- AI-assisted mobile UI verification
- Agent workflows that need real mobile device context
- Power users expanding beyond the standard editor flow
- Teams that want AI-driven simulation, not just static code suggestions
🚀 Quick Start (Zero-Install)
No cloning or installation required. Just add it to your IDE's MCP configuration and give your agent a mobile simulation tool it can actually use.
🍱 1. Get your Token
- Sign up/Login at app.emuluxe.com.
- Go to Settings → API Tokens.
- Copy your
EMULUXE_TOKEN.
🎨 2. Add to your IDE
Cursor (Native Support)
- Open Cursor Settings (
Cmd + Shift + J). - Go to Features → MCP Servers.
- Click + Add New MCP Server.
- Name:
Emuluxe - Type:
command - Command:
npx -y @emuluxe/mcp-server - Environment Variables:
EMULUXE_TOKEN:your_token_hereEMULUXE_IDE:cursor
VS Code (via Roo Code / Cline)
Add this to your mcp_config.json:
"emuluxe": {
"command": "npx",
"args": ["-y", "@emuluxe/mcp-server"],
"env": {
"EMULUXE_TOKEN": "your_token_here"
}
}Antigravity
Add this to .gemini/antigravity/mcp_config.json:
"emuluxe": {
"command": "npx",
"args": ["-y", "@emuluxe/mcp-server"],
"env": {
"EMULUXE_TOKEN": "your_token_here"
}
}Windsurf
- Open Windsurf Settings.
- Go to Cascade → MCP Servers.
- Click + Add New MCP Server.
- Name:
Emuluxe - Type:
command - Command:
npx -y @emuluxe/mcp-server - Environment Variables:
EMULUXE_TOKEN:your_token_hereEMULUXE_IDE:windsurf
Claude Desktop & Claude Code CLI Support
The Emuluxe MCP server intelligently handles different environments:
In IDE (VS Code, Cursor, Windsurf, Antigravity)
- Simulation panel opens inside the editor
- No special configuration needed
In Terminal (Claude Desktop, Claude Code CLI)
- Free tier: Returns CLI command to run
- Pro/Enterprise: Opens platform dashboard in browser
Setup for Claude Code CLI
claude mcp add --transport stdio --env EMULUXE_TOKEN=your_token emuluxe -- npx -y @emuluxe/mcp-serverSetup for Claude Desktop
Add to Claude Desktop MCP configuration:
"emuluxe": {
"command": "npx",
"args": ["-y", "@emuluxe/mcp-server"],
"env": {
"EMULUXE_TOKEN": "your_token_here"
}
}🛠 Available Tools
simulate
Launches a mobile simulation of a URL on a specific device.
Arguments:
url(string, required): The URL to simulate (e.g.,https://google.com).device(string, optional): The device ID (e.g.,iphone-15-pro-max,pixel-8-pro). Defaults toiphone-15-pro-max.
How it fits the Emuluxe workflow
- VS Code / Cursor: Best for manual daily mobile simulation
- Chrome extension: Best for live-site simulations
- CLI: Best for fast repeat simulation launches
- MCP: Best when agents should trigger or verify the same simulation workflow
MCP is not the first step for most users. It is the power-user AI layer for teams that already rely on agentic development and want mobile simulation and verification inside that loop.
🔍 Troubleshooting
Extension Doesn't Open
- Ensure you have the Emuluxe VS Code Extension installed.
- Check the terminal output of the MCP server. It always provides a Manual Bridge Link if the deep-link fails.
Authentication Errors
- Verify your
EMULUXE_TOKENis correct and hasn't expired. - You can also set the token globally using the Emuluxe CLI.
📄 License
ISC © Emuluxe
