Connect tools

Shopify

Live commerce via Shopify's Storefront MCP. The agent can search your catalog, build carts, and drop visitors at checkout — all from the chat.

Find your Storefront MCP URL

The Shopify Storefront MCP URL follows this pattern:

https://your-store.myshopify.com/api/mcp

Replace your-store with your actual shop subdomain. If your store uses a custom domain, you still use the .myshopify.comURL — that's the canonical Storefront endpoint.

Connect it

1. Open the agent in your dashboard and scroll to Connections.
2. Enter your .myshopify.com domain and click Connect Shopify (OAuth). This links Storefront MCP and read-only order lookup for WISMO.
3. Or paste the Storefront MCP URL manually under the fallback field and save.

The next chat message routes through the new tools automatically — no widget rebuild.

What the agent can do

• Search the catalogby name, attribute, or natural language (“under $50”, “in stock”, “wide width”).
• Recommend products based on what the visitor described.
• Build carts with specific variants and quantities.
• Generate checkouts and share the URL with the visitor.
• Pull order status for guests (order number + email) or automatically for shoppers already logged into the storefront.

Logged-in shoppers (order status without re-asking)

After OAuth, configure the Partner app App Proxy so the storefront can issue a short-lived customer token:

• Subpath prefix: apps
• Subpath: agentmatica
• Proxy URL: https://<your-agentmatica-host>/api/shopify/proxy

Embed the Liquid widget snippet (see Install the widget) with data-amk-logged-in and data-amk-customer-token-url="/apps/agentmatica/customer-token". When a classic customer account is logged in, the widget fetches a token via the App Proxy; Agentmatica verifies it once and stores identity on the conversation — the agent should not ask for email or order number again for that chat.

If you previously connected Shopify before App Proxy scopes were added, open Connections and reconnect so the install includes write_app_proxy.

How it shows in the widget

When the agent calls search_catalog, matching products render as cards inside the conversation — image, title, price, link. The agent writes a short intro/outro around them, not a duplicate list of names and prices.

Post-purchase actions (optional)

After OAuth is connected, open Order lookup (WISMO) and enable Post-purchase agent actions. All writes are off by default:

• Cancel unfulfilled orders (refund original payment, or cancel without refund)
• Update shipping address on unfulfilled orders (same country/state by default)
• Create returns on fulfilled line items

Enabling a write action requires reconnecting Shopify so the install can add write_orders and, for returns, write_returns. The agent only runs these for logged-in Shopify customers, after they confirm in chat. Guests stay on read-only order lookup or get escalated.

Permissions

Storefront MCP exposes public catalog/cart data. OAuth adds Admin access for customers and orders (WISMO), plus App Proxy so logged-in identity can be proven without sharing storefront cookies with Agentmatica. Write scopes are requested only after you enable a post-purchase action and reconnect.