Skip to main content
Glama

Shoppingate MCP Server (TypeScript)

Model Context Protocol (MCP) Server for the Shoppingate AI Platform β€” powering both Merchant & Customer Super-App capabilities across Claude Desktop, ChatGPT, Claude.ai, and the Shoppingate AI Gateway.


πŸ› οΈ Complete Feature & Tool Coverage

1. Merchant Tools (src/tools/merchantTools.ts)

  • search_products: Search catalog with keyword, category, price range, and stock status filters.

  • get_product_details: Fetch product specs, images, pricing, and stock levels by ID.

  • update_product_stock: Update inventory quantity and stock availability.

  • list_merchant_orders: Filter customer orders by status (pending, processing, shipped, delivered, cancelled).

  • get_order_details: Retrieve full order line items, customer details, and shipping address.

  • update_order_status: Change order fulfillment status with tracking notes.

  • list_promotions: View active store deals and promotional offers.

  • create_coupon: Create percentage or fixed SAR discount coupon codes.

2. Customer Super-App Tools (src/tools/customerTools.ts)

  • customer_search_products: Natural language product search for end-customers by budget, category, or brand.

  • get_recommendations: Fetch personalized recommendation rails (Recommended for You, Trending, New Arrivals).

  • get_similar_products: Semantic similarity search for Product Detail Pages (PDP).

  • track_customer_order: Live order tracking and delivery status.

  • check_visa_guidance: Query visa requirements and packages for travel destinations.

  • search_travel_insurance: Query travel insurance plans by destination & trip duration.

3. MCP Resources & Prompts

  • Resources: shoppingate://catalog/summary & shoppingate://orders/summary.

  • Prompts: merchant_daily_briefing & product_copywriter (Bilingual English/Arabic PDP copywriting).


Related MCP server: Universal Shopping Agent MCP Server

βš™οΈ Transport Modes

  • Stdio Mode (npm run start:stdio): Native integration with Claude Desktop.

  • HTTP / SSE Mode (npm run start:sse): Express server listening on http://localhost:3005 for ChatGPT, Claude.ai, & AI Gateway.


πŸš€ Quick Start

cd Backend/MCP-SERVER

# Install dependencies
npm install

# Compile TypeScript
npm run build

# Start in SSE / Browser Playground Mode (Port 3005)
npm run start:sse

# Start in Stdio Mode (For Claude Desktop CLI)
npm run start:stdio

🌐 Browser Playground

Open http://localhost:3005 in Chrome to test both Merchant and Customer tools visually.

  • Playground UI: http://localhost:3005

  • Health Check: http://localhost:3005/health-check

  • OpenAPI Schema: http://localhost:3005/openapi.json

  • SSE Stream: http://localhost:3005/sse


πŸ’‘ Claude Desktop Setup

Config file location: %APPDATA%\Claude\claude_desktop_config.json (or Microsoft Store AppData path):

{
  "mcpServers": {
    "shoppingate-merchant": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Repository\\Shoppingate\\Backend\\MCP-SERVER\\dist\\index.js"
      ],
      "env": {
        "TRANSPORT_MODE": "stdio",
        "ECOM_SERVICE_URL": "https://microservices.shoppinggate.app/ecom",
        "SERVICE_API_KEY": "O5Xpb9Lho$NooI@7@Q>ztCpGVCQ"
      }
    }
  }
}

Available Tools

14 tools
check_visa_guidanceA

Check visa requirements and package guidance for travel destinations in Shoppingate.

Inputs: destinationCountry (required), nationality.

create_couponB

Create a new promotional discount coupon code for store customers.

Inputs: code (required), discountType (required), discountValue (required), endDate, +4 more.

customer_search_productsC

Search products for Shoppingate customers by title, category, budget, or brand.

Inputs: query (required), lang, limit, maxPrice, +1 more.

get_order_detailsA

Fetch full order details including line items, prices, shipping address, and payment status.

Inputs: orderId (required).

get_product_detailsA

Get full product details including images, inventory stock, brand, category, and pricing.

Inputs: productId (required), lang.

get_recommendationsA

Get personalized product recommendations for a customer (Recommended for You, Trending, New Arrivals).

Inputs: lang, userId.

get_similar_productsA

Find products similar to a given product ID for PDP recommendations.

Inputs: productId (required), lang, limit.

list_merchant_ordersA

List merchant store orders with optional status, date range, or search filtering.

Inputs: page, limit, search, status, +2 more.

list_promotionsB

List active promotions, deals, and discount coupons available in the store.

Inputs: page, limit.

search_productsC

Search the Shoppingate product catalog with keywords, category filters, and price ranges.

Inputs: lang, page, limit, query, +3 more.

search_travel_insuranceB

Search travel insurance coverage plans for upcoming trips.

Inputs: destination (required), tripDurationDays.

track_customer_orderB

Track the delivery status and shipping updates for a customer order.

Inputs: orderId (required).

update_order_statusC

Update order status (e.g., mark as processing, shipped, delivered, or cancelled).

Inputs: status (required), orderId (required), notes.

update_product_stockB

Update inventory stock level or availability status for a merchant product.

Inputs: stock (required), productId (required), inStock.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 14 tools

    Disambiguation3/5

    search_products and customer_search_products are nearly identical in purpose, differing only by implied audience, which creates ambiguity. Other tools are distinct and clearly separated by resource/action.

    Naming Consistency4/5

    Most tools follow a verb_noun pattern (search_products, get_product_details, list_merchant_orders, etc.). customer_search_products breaks this by prepending a noun, and a couple of verbs vary, but the overall convention is mostly consistent.

    Tool Count4/5

    14 tools is within the ideal range and each shopping-related tool serves a clear purpose. However, the inclusion of travel-specific tools (visa guidance, insurance) dilutes the focus and makes the set slightly less cohesive.

    Completeness3/5

    The shopping surface covers search, details, stock update, orders, and promotions, but lacks product creation/deletion and order placement. Coupon management is partial (create/list only), and travel tools are advisory with no booking flow, leaving notable gaps.

    Related MCP Connectors

    Related MCP Servers