WisWes Magento MCP

- A stateless MCP HTTP endpoint at/mcp, served through your existing Magento web server — no separate process to manage.
- 22 typed tools across catalog, cart, checkout, customer, sales, and wishlist.
- A one-click admin handshake that hands a shared secret to your WisWes workspace.
- Nightly catalogue push to the WisWes vector index for semantic product search.

What this gives you:theWeschat persona on your storefront can read your live Magento data and act on the cart with no glue code. Shoppers ask questions in natural language, Wes calls the right tool, you ship more orders.

- Module name:WisWes_MCP
- Composer package:wiswes/magento-mcp
- Tested Magento versions:2.4.4, 2.4.5, 2.4.6, 2.4.7
- PHP:8.1 / 8.2 / 8.3 / 8.4

Pick one of the three install paths. Composer is recommended for production.

composer require wiswes/magento-mcp bin/magento module:enable WisWes_MCP bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush

mkdir -p app/code/WisWes git clone https://github.com/wiswes/magento.git app/code/WisWes/MCP cd app/code/WisWes/MCP && git checkout v1.0.7 && cd - bin/magento module:enable WisWes_MCP bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush

unzip ~/Downloads/wiswes-magento-1.0.7.zip -d . mkdir -p app/code/WisWes && mv wiswes-magento-1.0.7 app/code/WisWes/MCP bin/magento module:enable WisWes_MCP bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush

The MCP endpoint is served by your existing web server athttps://<your-magento>/mcp. There isno separate process to start— oncesetup:upgraderuns, the route is live.

Connecting to your WisWes workspace is a one-click handshake from the Magento admin:
- OpenStores → Configuration → WisWes Chat → WisWes Chat MCP → Connection.
- (Optional) Set theWisWes Dashboard URLif you're connecting to a staging or self-hosted dashboard. Default:https://api.wiswes.com/.
- Save the config.
- OpenStores → Configuration → WisWes Chat → WisWes Chat Widget → Installand click theInstallbutton.
- Magento generates a long random shared secret unique to this install, persists it (encrypted) underwiswes_mcp/auth/shared_secret, and redirects you to the WisWes dashboard with the secret embedded asinstall_tokenin the URL.
- The dashboard saves the token on your tenant's CommerceConfig. From now on every WisWes chat reaches your store asPOST https://<your-magento>/mcpwithAuthorization: Bearer <secret>.

The merchant never sees the secret in the browser — it travels server-to-server via a redirect over HTTPS.

Tools fall into three categories based on the Magento context they need:

WisWes serves product search out of its own vector index, populated from your Magento store. The push runs nightly at 03:00 by default; trigger it manually after a bulk catalogue change:

# from Magento root bin/magento wiswes:products:push # Pushed 4271 products in 43 batches (upserted=4271, skipped_operator=0, skipped_cap=0)

Or clickPush catalogue nowunderStores → Configuration → WisWes Chat → WisWes Chat MCP → Catalogue Sync.

The push ships a compact retrieval payload (sku,name,url,price) plus a metadata blob built from name + short description + searchable attributes. The blob is what WisWes embeds; the retrieval payload is what the LLM sees verbatim when a result matches.

The push is incremental — only enabled, visible products are sent, batched 100 at a time. Auth uses the same shared secret minted by the Install handshake.

The WisWes chat bubble is a single<script>tag. The module doesnotauto-inject it — paste it into Magento's native script areas instead, so your install path is identical to Shopify or any custom storefront:

- Stores → Configuration → Design → HTML Head → Scripts and Style Sheets, or
- default_head_blocks.xmlin your theme

Copy the snippet from your WisWes workspace underConfiguration → Commerce → Embed snippet. It looks like:

<script src="https://app.wiswes.com/api/widget/embed.js?user_token=YOUR_TENANT_TOKEN" defer></script>

The token in the snippet is your tenant ID — every chat that loads via this snippet is scoped to your workspace.
- MCP endpoint reachable.From any host that WisWes can reach:

curl -X POST https://<your-magento>/mcp \ -H 'Authorization: Bearer <your-shared-secret>' \ -H 'Content-Type: application/json' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

22 tools across six groups. Names listed are the MCP tool ids the agent sees.

Every tool returns a typed array or throws a MagentoLocalizedExceptionwith a shopper-safe message — no raw stack traces leak to the agent.

Once installed and connected, the day-to-day workflow is:
- Customers chatwith Wes via the WisWes widget on your storefront.
- Wes selects toolsto answer questions or take actions — search the catalog, look up an order, add to cart.
- Tool calls hit/mcpon your store, which reads/writes through Magento's standard service contracts so all your existing extension hooks fire (price rules, stock reservations, sales rules, etc.).
- Results return to Wes, who replies in natural language with product cards, status updates, or confirmations.

You can scope which tools are available per workspace underBehavior → Toolsin WisWes — toggle individual tools on/off, override their description (the prompt text the model reads), or pin argument defaults. None of this requires touching PHP.

Give your AI a direct line into your Swell store. Manage products, orders, and customers through natural conversation.

Centralized management of RePricing for Amazon, eBay, and Kaufland, Lost & Found for Amazon FBA, and integrated HelpDesk.

Skyvia MCP Endpoint is a no-code gateway that makes your business data accessible to AI assistants in real time.

Manage products, orders, and customers on Color Me Shop

A Model Context Protocol (MCP) server and standalone CLI for querying PowerPlatform / Dataverse environments. Supports multiple environments, entity metadata, records, plugins, flows, solutions, workflows, business rules, security roles, and more.

An ecommerce assistant for Salesforce, enabling interaction with orders, returns, and customer service operations.

Shopify MCP server for interacting with Shopify store data through GraphQL, including products, orders, customers, and ecommerce workflows.

D2C eCommerce fulfillment platform: manage orders, inventory, shipments, campaigns, and billing via AI agents

Built for the next generation of intelligent experiences, ActiveCampaign's remote MCP server makes it easy for AI agents to understand, store, and use customer context across tools, channels, and workflows.