MCP Server

Mosaiden Souq — سوق المساعدين

com.mosaiden/souq
Commerce & Retail Travel & Hospitality Public & reachable MCP 2025-11-25

What this MCP does

Searches a Saudi marketplace for products, classifieds, restaurants, hotels, and related services, with price comparisons, menus, and checkout links.

checkout_link
رابط سلّة للشراء
Build a Mosaiden cart link from store products the user chose (product URLs from search_souq / compare_prices, i.e. https://mosaiden.com/stores/<store>/p/<id>). Validates each product live and returns ONE link; the user opens it, reviews items and prices, adds them with one tap and pays on mosaiden.com. Nothing is added or charged by this tool. ابنِ رابط سلّةٍ من منتجات المتاجر التي اختارها المستخدم؛ يفتحه فيراجع ويضيف ويدفع على سوق المساعدين — الأداة لا تضيف ولا تدفع.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['product_url'], 'properties': {'quantity': {'type': 'integer', 'maximum': 20, 'minimum': 1}, 'product_url': {'type': 'string', 'maxLength': 500}}, 'additionalProperties': False}, 'maxItems': 20, 'minItems': 1, 'description': 'المنتجات: [{ product_url, quantity }] — product_url رابط منتجٍ من نتائجنا، quantity من 1 إلى 20 (افتراضي 1)'}}, 'additionalProperties': False}
compare_prices
مقارنة أسعار الجوالات والإلكترونيات
Compare prices of phones and electronics across the marketplace's stores (Jarir, eXtra, AliExpress stores…) — cheapest first, with discounts and our product links. Set category=phones for phones (tablets/laptops/wearables/audio/gaming likewise). قارن سعر جوال أو جهاز بين متاجر السوق (جرير، إكسترا، متاجر AliExpress…) من الأرخص، مع الخصم ورابط المنتج عندنا؛ حدّد category=phones للجوالات.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 100, 'minLength': 2, 'description': 'الموديل أو الماركة (مثال: iPhone 17 Pro Max 256، سامسونج S26، لابتوب لينوفو)'}, 'category': {'enum': ['phones', 'tablets', 'laptops', 'wearables', 'audio', 'gaming', 'accessories', 'any'], 'type': 'string', 'description': 'حصر المقارنة في فئة من متاجر جرير وإكسترا: phones للجوالات، tablets، laptops… (any = كل المتاجر، الافتراضي)'}, 'max_price': {'type': 'number', 'maximum': 1000000, 'minimum': 1, 'description': 'ميزانية قصوى بالريال (اختياري)'}, 'per_store': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'أقصى نتائج لكل متجر (افتراضي 3)'}, 'include_accessories': {'type': 'boolean', 'description': 'أدرج الأغطية والشواحن والواقيات (افتراضياً تُستبعد ما لم يطلبها السؤال)'}}, 'additionalProperties': False}
find_image
إيجاد صورة للإعلان
Find a suitable image for a listing or store product from our search engine when the user cannot give you a public photo URL (chat attachments are not public). Returns verified https image URLs; pass the chosen one in `images` of publish_listing / add_store_product. These are ILLUSTRATIVE images (not the seller's own item): the listing is published with the note «صورة توضيحية» and without our watermark — tell the user, and that they can replace it with a real photo at https://mosaiden.com/profile/listings. Classified-ad and social sites are excluded (their photos are other people's items). ابحث عن صورة مناسبة للإعلان أو المنتج من محرّك بحثنا حين لا يملك المستخدم رابطاً عامّاً لصورته: تُنشر بعلامة «صورة توضيحية»، ويستبدلها بصورته الحقيقية متى شاء.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 6, 'minimum': 1, 'description': 'عدد الصور (1–6، الافتراضي 4)'}, 'query': {'type': 'string', 'maxLength': 100, 'minLength': 2, 'description': 'وصف الصورة: الماركة والموديل والسنة واللون (مثال: تويوتا كورولا 2010 بيضاء)'}, 'purpose': {'enum': ['listing', 'product'], 'type': 'string', 'description': 'listing لإعلانٍ مبوّب (الافتراضي)، product لمنتجٍ جديد في متجر (يبدأ بصور المتاجر السعودية)'}, 'query_en': {'type': 'string', 'maxLength': 100, 'description': 'الوصف نفسه بالإنجليزية (يُفضَّل — صوره أنظف، مثال: Toyota Corolla 2010 white)'}}, 'additionalProperties': False}
get_restaurant_menu
قائمة مطعم بالأسعار
Get a restaurant brand's stored official menu (items, categories, SAR prices) and the nearest branch page to order from. قائمة مطعم أو سلسلة بأصنافها وأسعارها بالريال وأقرب فرع للطلب (كودو، البيك، ماكدونالدز، هرفي…). لا تخترع صنفاً غير موجود.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['restaurant'], 'properties': {'city': {'type': 'string', 'maxLength': 60, 'description': 'المدينة لاختيار أقرب فرع (اختياري)'}, 'limit': {'type': 'integer', 'maximum': 120, 'minimum': 5, 'description': 'أقصى عدد أصناف (افتراضي 40)'}, 'query': {'type': 'string', 'maxLength': 60, 'description': 'صنف أو كلمة داخل القائمة (برجر، فطور، عائلي) — اختياري'}, 'restaurant': {'type': 'string', 'maxLength': 80, 'minLength': 2, 'description': 'اسم المطعم أو السلسلة'}}, 'additionalProperties': False}
list_assistants
مساعدو السوق المتخصّصون
List the marketplace's specialized AI assistants (cars, real estate, mobiles, restaurants, hotels, flights, groceries…) with links to chat with each on mosaiden.com. مساعدو سوق المساعدين المتخصّصون (سيارات، عقار، جوالات، مطاعم، فنادق، طيران…) وروابط محادثتهم.
Read only Idempotent
Input schema
{'type': 'object', 'properties': {'query': {'type': 'string', 'maxLength': 60, 'description': 'تصفية بالاسم أو المجال (اختياري)'}}, 'additionalProperties': False}
list_categories
أقسام الإعلانات
List classified-ad categories (slug + Arabic name) to pick the right one before publish_listing. أقسام الإعلانات المبوّبة لاختيار القسم قبل النشر.
Read only Idempotent
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
search_assistants
البحث عن مساعدين (داخليين وخارجيين)
Find AI assistants for a need: the marketplace's own specialised assistants AND verified third-party MCP servers from other providers (from the official MCP Registry, live-checked). Returns connector URLs the user can add to their AI. ابحث عن مساعدٍ لحاجة: مساعدو سوق المساعدين ومساعدون من مزوّدين آخرين (خوادم MCP مفحوصة حيّاً) مع روابط إضافتهم.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'أقصى عدد للخارجيين (افتراضي 8)'}, 'query': {'type': 'string', 'maxLength': 100, 'minLength': 2, 'description': 'الحاجة أو المجال (رحلات، طقس، محاسبة، flights, github…) — الخارجيون أوصافهم إنجليزية غالباً'}, 'source': {'enum': ['all', 'internal', 'external'], 'type': 'string', 'description': 'all (افتراضي) أو internal (سوق المساعدين فقط) أو external (المزوّدون الآخرون فقط)'}}, 'additionalProperties': False}
search_flights
بحث الطيران
Find the cheapest flights between two cities (Saudi city names or IATA codes) for a date (YYYY-MM-DD) or month (YYYY-MM). Prices in SAR. Each result has the airline's own booking link first (booking and payment happen on the airline site), and a partner link when available. ابحث عن أرخص الرحلات بين مدينتين بتاريخ أو شهر: السعر بالريال ورابط الشركة المباشر أوّلاً — الحجز والدفع لدى الشركة.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['origin', 'destination', 'departure'], 'properties': {'origin': {'type': 'string', 'maxLength': 40, 'minLength': 3, 'description': 'مدينة الإقلاع أو رمزها (الرياض، JED)'}, 'departure': {'type': 'string', 'maxLength': 10, 'minLength': 7, 'description': 'YYYY-MM-DD أو YYYY-MM'}, 'destination': {'type': 'string', 'maxLength': 40, 'minLength': 3, 'description': 'مدينة الوصول أو رمزها'}}, 'additionalProperties': False}
search_hotels
البحث عن فنادق
Search 20,000+ hotels in Saudi Arabia, UAE, Egypt, Bahrain, Kuwait, Oman and Jordan (stars, review score, starting price) — booking and payment happen on mosaiden.com. ابحث عن فندق بالمدينة أو الاسم في السعودية والإمارات ومصر والبحرين والكويت وعُمان والأردن؛ الحجز والدفع على mosaiden.com.
Read only Idempotent
Input schema
{'type': 'object', 'properties': {'city': {'type': 'string', 'maxLength': 60, 'description': 'المدينة بالعربية أو الإنجليزية (الرياض، Jeddah، مكة، دبي)'}, 'page': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'الصفحة (10 فنادق لكل صفحة)'}, 'query': {'type': 'string', 'maxLength': 80, 'description': 'اسم الفندق أو سلسلة (هيلتون، موفنبيك) — اختياري'}, 'country': {'enum': ['SA', 'AE', 'EG', 'BH', 'KW', 'OM', 'JO'], 'type': 'string', 'description': 'رمز الدولة (SA افتراضياً إن لم تُذكر مدينة)'}}, 'additionalProperties': False}
search_restaurants
البحث عن مطاعم ووجبات
Find restaurants and meals in Saudi cities (2,600+ brands, 4,300+ branches on the map) by name, cuisine or dish. ابحث عن مطعم أو نوع أكل أو وجبة في مدن السعودية؛ للقائمة الكاملة بالأسعار استعمل get_restaurant_menu.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 80, 'minLength': 2, 'description': 'اسم مطعم أو نوع أكل أو وجبة (كودو، مندي، بيتزا، قهوة مختصة)'}}, 'additionalProperties': False}
search_souq
البحث في سوق المساعدين
Search the Saudi marketplace «سوق المساعدين» (mosaiden.com) in one call: classified ads (cars, real estate, phones…), store products, stores, restaurants and meals. ابحث في السوق كلّه دفعةً واحدة: الإعلانات المبوّبة، منتجات المتاجر، المتاجر، المطاعم والوجبات. استعملها أولاً لأي طلب شراء أو بحث عامّ في السعودية.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'أقصى عدد لكل نوع (افتراضي 6)'}, 'query': {'type': 'string', 'maxLength': 100, 'minLength': 2, 'description': 'ما يبحث عنه المستخدم بالعربية أو الإنجليزية (مثال: آيفون 17 برو، شقة للإيجار الرياض، برجر)'}}, 'additionalProperties': False}
web_search
بحث الويب السعودي
Search the web with a Saudi focus: first the search-ksa index of verified Saudi sites, then the global engine if results are few. Returns title, URL and snippet. ابحث في الويب بتركيزٍ سعوديّ: فهرس المواقع السعودية أوّلاً ثم المحرّك العالميّ.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'عدد النتائج (1–10، الافتراضي 8)'}, 'query': {'type': 'string', 'maxLength': 100, 'minLength': 2, 'description': 'نصّ البحث'}}, 'additionalProperties': False}
Added
find_image
Oct. 4, 2026, 2:41 a.m.
Added
search_flights
Oct. 4, 2026, 2:41 a.m.
Added
web_search
Oct. 4, 2026, 2:41 a.m.
Added
list_categories
Sept. 28, 2026, 2:40 a.m.
Added
checkout_link
Sept. 28, 2026, 2:40 a.m.
Added
search_assistants
Sept. 28, 2026, 2:40 a.m.
Added
list_assistants
Sept. 28, 2026, 2:40 a.m.
Added
search_hotels
Sept. 28, 2026, 2:40 a.m.
Added
get_restaurant_menu
Sept. 28, 2026, 2:40 a.m.
Added
search_restaurants
Sept. 28, 2026, 2:40 a.m.
Added
compare_prices
Sept. 28, 2026, 2:40 a.m.
Added
search_souq
Sept. 28, 2026, 2:40 a.m.