Build proven high converting product showrooms and websites from your existing ecommerce catalog
AI assistant tools for building high-converting immersive commerce showrooms from your existing e-commerce catalog. Built on Mantis's production immersive-commerce platform, used by Fortune 500 brands including New Balance, with deployments spanning the Paris 2024 Olympics, MLB, NHL, and the Premier League.
Part of Mantis's vision for agent-invoked immersive commerce infrastructure. Learn more at mantisxr.com.
npx mantis-mcp
Or install globally:
npm install -g mantis-mcp
Then configure in Claude Desktop, Cursor, or any MCP-compatible client (see Configuration below).
The Mantis showroom platform this MCP connects to is live in production, used by Fortune 500 brands including New Balance, with deployments including the Paris 2024 Olympics, Chicago Cubs (MLB), St. Louis Blues (NHL), and Burnley FC and other Premier League clubs. This MCP server is how that platform gets exposed to AI agents, and it's actively in development. Some tools are fully wired to the real platform API today; others are simulated while backend endpoints are being built out. See the tool status below for exactly what's real versus in progress.
Configure these to connect to the real Mantis API:
MANTIS_API_URL=https://your-mantis-instance.com
MANTIS_AUTH_TOKEN=your_token_here
Mantis users receive their API URL and auth token during account setup. Without these, tools work with simulated data for code generation and planning.
Claude Desktop:
{
"mcpServers": {
"mantis-mcp": {
"command": "npx",
"args": ["mantis-mcp"]
}
}
}
Cursor:
npx mantis-mcpOther MCP clients: Use npx mantis-mcp or node /path/to/dist/index.js
installMantisSDK Generates installation commands and .npmrc setup for integrating Mantis SDK into React, Vue, Next.js, Shopify, or vanilla JavaScript projects.
createMantisIntegration Generates complete, framework-specific integration code with event handlers, cart integration, and analytics tracking.
generateEventHandler Creates event handler code for Mantis SDK events (cart-opened, model-click, variant-changed, etc.).
analyzeConsoleErrors Pattern-matches common errors (SDK not loaded, postMessage blocked, WebGL issues) and provides fixes with code examples.
checkBrowserCompatibility Checks browser compatibility for WebGL, postMessage, fullscreen, and other immersive features with polyfill recommendations.
validateSetup
Validates Mantis SDK installation. Calls real showrooms.getShowroom API if MANTIS_API_URL is configured, otherwise returns sample validation checks.
importCatalog Imports product catalogs from Shopify (real API), CSV, or manual input. Data parsed successfully; backend storage endpoints pending.
createStore
Creates an immersive showroom. Attempts real showrooms.createShowroom API call if configured, falls back to mock response with guidance.
publishStore
Publishes showroom live. Attempts real showrooms.updateShowroom API if configured, otherwise simulates status change to active.
debugPostMessage Simulates postMessage debugging scenarios with realistic message timelines, origin checks, and error patterns.
testMantisEvent Simulates SDK event testing (model-loaded, add-to-cart, etc.) with validation and performance timing.
simulateUserFlow Simulates multi-step user interaction flows (load → click → add-to-cart) with realistic delays and error scenarios.
getPerformanceMetrics Generates simulated performance data (FPS, load times, memory, GPU) based on requested metrics.
analyzeEventFlow Simulates event flow analysis with conversion funnels, dropoff points, and user behavior patterns.
Immersive Asset Generation: Mantis does not provide automated conversion of product photos into immersive-ready assets. Merchants must provide immersive-ready assets (.glb/.gltf files) when creating products. This is an intentional scope decision: automated asset generation is a commoditizing service layer that multiple companies have attempted without building sustainable businesses. Mantis's value is the immersive showroom platform, merchandising intelligence, and agent-invokable commerce infrastructure—not asset generation.
# Clone and install
git clone https://github.com/kahlilashanti/mantis-mcp.git
cd mantis-mcp
npm install
# Build
npm run build
# Run locally
npm start
MIT
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y mantis-mcpMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-kahlilashanti-mantis-mcp": {
"command": "npx",
"args": [
"-y",
"mantis-mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referencemantis-mcpnpmio.github.kahlilashanti/mantis-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.