Swag MCP App
Supports UIby agentic-commerce-lab
AI-powered Shopware storefront — browse products, add to cart, and checkout through conversational MCP tools with an embedded UI.
What it does
Swag MCP App turns a Shopware storefront into an interactive conversational commerce experience. AI assistants can browse a product grid, search for items, add them to a cart, and open a full checkout UI — all through natural language. The embedded Vue-based UI renders a live product grid with "Add to Cart" buttons and a checkout panel, while the AI keeps the session in sync using a shared contextToken.
Key features
- Interactive product grid — Browse or search Shopware products with a live UI; results show images, prices, and add-to-cart buttons
- Conversational add-to-cart — Add items by ID or by asking the assistant ("add the blue tent to the cart"); cart stays in sync across tools via contextToken
- Embedded checkout flow — Opens a full checkout UI for the current session, supporting both logged-in and guest checkout
- Session sync — Keeps the AI's cart session in sync after login, logout, or guest registration
- Dual transport — Supports both Streamable HTTP (remote/cloud clients) and stdio (local subprocess hosts)
Installation
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"swag-mcp-app": {
"command": "node",
"args": ["/path/to/swag-mcp-app/dist/index.js", "--stdio"],
"env": {
"VITE_SHOPWARE_STOREFRONT_API_URL": "https://your-store.shopware.store",
"VITE_SHOPWARE_STOREFRONT_API_TOKEN": "your-token"
}
}
}
}
Or for HTTP transport, set the MCP server URL to http://localhost:3001/mcp in your Claude Desktop settings.
VS Code Copilot
Add to your settings.json:
{
"github.copilot.chat.mcp.servers": {
"swag-mcp-app": {
"command": "node",
"args": ["/path/to/swag-mcp-app/dist/index.js", "--stdio"],
"env": {
"VITE_SHOPWARE_STOREFRONT_API_URL": "https://your-store.shopware.store",
"VITE_SHOPWARE_STOREFRONT_API_TOKEN": "your-token"
}
}
}
}
Claude.ai web
Add http://localhost:3001/mcp as an MCP integration URL in Settings → Integrations (requires the server to be running and accessible).
Supported hosts
Claude Desktop (stdio + HTTP), VS Code Copilot, and any MCP client supporting Streamable HTTP or stdio.
Quick install
npx swag-mcp-app