🛍️ SHOPLINE Storefront MCP

1️⃣ Customer Query

A shopper asks about products while browsing a SHOPLINE store in natural language.

2️⃣ AI Processing

Your AI agent searches the store's catalog, manages carts, and answers policy questions.

3️⃣ Purchase Complete

The shopper adds items to cart and completes checkout with AI assistance.

� search_shop_catalog

Searches the store's product catalog to find items that match customer needs

Parameters:

• query - Search query to find related products (required)
• context - Additional information to help tailor results (required)

Returns:

• Product name, price, and currency
• Variant ID and product URL
• Product images and descriptions

❓ search_shop_policies_and_faqs

Answers questions about store policies, products, and services to build customer trust

Parameters:

• query - Question about policies or FAQs (required)
• context - Additional context like current product (optional)

Returns:

• Accurate policy information
• FAQ answers and explanations
• Store-specific guidelines

� get_cart

Retrieves the current contents of a cart, including item details and checkout URL

Parameters:

• cart_id - ID of an existing cart (required)

Returns:

• Cart items with quantities and prices
• Total amount and currency
• Checkout URL for completion

✏️ update_cart

Updates quantities of items in an existing cart or adds new items. Creates a new cart if no cart ID is provided

Parameters:

• cart_id - ID of cart to update (optional, creates new if not provided)
• lines - Array of items to update or add (required)

Returns:

• Updated cart with new contents
• Cart ID for future operations
• Total price and item count

🔍 Product Search with Context

Customer: "I need wireless headphones for working out"

MCP Tool Call:
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "search_shop_catalog",
    "arguments": {
      "query": "wireless headphones",
      "context": "Customer needs workout/sports headphones, likely sweat-resistant"
    }
  }
}

Response:
{
  "content": [
    {
      "type": "text",
      "text": "Found these workout-suitable wireless headphones:\n\n1. [SportBuds Pro Wireless](https://store.com/sportbuds) - $89.99\n   • Sweat-resistant IPX7 rating\n   • 8-hour battery life\n   • Secure ear hooks\n\n2. [FitSound Active](https://store.com/fitsound) - $129.99\n   • Noise cancellation\n   • 12-hour battery\n   • Waterproof design"
    }
  ]
}

🛒 Cart Management

Customer: "Add the SportBuds to my cart"

MCP Tool Call:
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 2,
  "params": {
    "name": "update_cart",
    "arguments": {
      "lines": [
        {
          "merchandise_id": "gid://shopline/ProductVariant/sportbuds-pro",
          "quantity": 1
        }
      ]
    }
  }
}

Response:
{
  "content": [
    {
      "type": "text",
      "text": "✅ Added SportBuds Pro Wireless to your cart!\n\nCart Summary:\n• SportBuds Pro Wireless - $89.99\n• Subtotal: $89.99\n• Tax: $7.20\n• Total: $97.19\n\n[Proceed to Checkout](https://store.com/cart/checkout?cart_id=abc123)"
    }
  ]
}

❓ Policy Inquiry

Customer: "What's your return policy for electronics?"

MCP Tool Call:
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 3,
  "params": {
    "name": "search_shop_policies_and_faqs",
    "arguments": {
      "query": "return policy electronics",
      "context": "Customer asking about returning wireless headphones"
    }
  }
}

Response:
{
  "content": [
    {
      "type": "text",
      "text": "📋 Electronics Return Policy:\n\n• 30-day return window from purchase date\n• Items must be in original packaging\n• Electronics must be in working condition\n• Original receipt required\n• Return shipping: FREE for defective items, $9.99 for other returns\n• Refund processed within 3-5 business days\n\nFor wireless headphones specifically: Please test within 7 days for compatibility."
    }
  ]
}