Shoppingate MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Shoppingate MCP Server recommend products for a gift under 200 SAR"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 onhttp://localhost:3005for 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:3005Health Check:
http://localhost:3005/health-checkOpenAPI Schema:
http://localhost:3005/openapi.jsonSSE 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 toolscheck_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
Scored across 14 tools
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.
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.
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.
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
AI shopping gateway for product search, inventory, carts, and merchant-hosted checkout.
Manage your Savanto store from your AI: catalog, content, prompts, and analytics, by chat.
Query, explore, and manage your databases through natural conversation.
AI-agent product catalog: search, lookup & purchase routing over verified merchant data.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables customer support across e-commerce platforms by providing order management, product guidance, and account assistance tools through natural language queries.7MIT
- FlicenseAqualityDmaintenanceEnables AI-powered shopping assistance by analyzing natural language shopping queries and automating product searches on multiple e-commerce platforms.15-
- FlicenseAqualityDmaintenanceEnables store operations including inventory and sales queries and automated replenishment ordering through natural language.3-
- FlicenseNot gradedqualityDmaintenanceEnables customer support interactions including answering FAQs, checking order status, and maintaining customer memory across sessions.-