GotCashback MCP Server

اربط Claude و ChatGPT وغيرهما من مساعدي الذكاء الاصطناعي المتوافقين مع MCP مباشرةً بمعدلات الكاش باك الحالية لدى GotCashback (عبر الإنترنت وداخل المتجر، لدى مختلف بوابات الكاش باك)، ومقارنات البوابات وشروط الدفع، وبيانات المتاجر، وعروض بطاقات الهدايا — تُحدَّث عدة مرات يوميًا.

يقارن sg.GotCashback.com معدلات الكاش باك عبر 122 من بوابات الكاش باك في 49 من الدول حول العالم، منها 1 من البوابات و 53 من المتاجر في مصر. تأسس عام 2020؛ تديره MNP Enterprises, LLC.

ما هو MCP؟

بروتوكول Model Context Protocol (MCP) معيار مفتوح يتيح لمساعدي الذكاء الاصطناعي استدعاء أدوات خارجية وجلب بيانات حالية أثناء المحادثة. فبدلًا من أن يخمّن الذكاء الاصطناعي معدلات الكاش باك من بيانات تدريب قديمة، يمكنه الاستعلام من خادم GotCashback مباشرةً والحصول على أرقام اليوم.

تعليمات التثبيت

Claude (claude.ai / Claude Desktop)

افتح Settings → Connectors (في Claude Desktop: Settings → Connectors؛ وفي claude.ai: أيقونة الموصّلات في المحادثة).
انقر على "Add custom connector".
أدخل عنوان URL: https://mcp.gotcashback.com
اختر له اسمًا (مثل "GotCashback") ثم احفظ.
فعّل الموصّل في أي محادثة تريد فيها البحث عن الكاش باك — سيستدعي Claude الأدوات تلقائيًا عند الحاجة.

Claude Code (الطرفية)

أضف الخادم بأمر واحد:

claude mcp add --transport http gotcashback https://mcp.gotcashback.com

شغّل /mcp داخل Claude Code للتحقق من الاتصال، ولتسجيل الدخول عندما تريد استخدام أدوات الحساب.

ChatGPT

افتح Settings → Connectors (متاح في الخطط التي تدعم الموصّلات المخصّصة أو موصّلات المطورين).
اختر إضافة موصّل مخصّص وأدخل عنوان URL الخاص بالخادم: https://mcp.gotcashback.com
اتبع التعليمات لتفويضه وتفعيله للاستخدام في المحادثة أو في إعدادات GPT مخصّص.

دعم الموصّلات في ChatGPT يُطرح على مراحل ويختلف توفره حسب الخطة. إذا لم تجد خيار "custom connector" أو "developer mode"، فراجع وثائق OpenAI الحالية الخاصة بنوع حسابك.

VS Code (وضع الوكيل في GitHub Copilot)

شغّل "MCP: Add Server" من لوحة الأوامر، أو أضف ما يلي إلى .vscode/mcp.json:

{
  "servers": {
    "gotcashback": {
      "type": "http",
      "url": "https://mcp.gotcashback.com"
    }
  }
}

عملاء آخرون متوافقون مع MCP (Cursor و Windsurf وغيرهما)

معظم عملاء MCP يقبلون إعداد JSON يشير إلى خادم بعيد. يبدو الإدخال النموذجي هكذا:

{
  "mcpServers": {
    "gotcashback": {
      "url": "https://mcp.gotcashback.com"
    }
  }
}

راجع وثائق عميلك لمعرفة مكان ملف الإعداد هذا (مثل ~/.cursor/mcp.json في Cursor) — عنوان URL والبنية أعلاه متطابقان لدى معظم العملاء لأنهم يتبعون مواصفة MCP نفسها.

أمثلة على الأسئلة بعد الاتصال

"ما أفضل معدل كاش باك لدى Best Buy الآن؟"
"هل توجد بطاقات هدايا مخفّضة لـ Target؟"
"What's the best cashback rate for Walmart in Canada?"
"Compare gift card discounts for Home Depot."
"ما بوابات الكاش باك المتاحة في المملكة المتحدة؟"
"أين يمكنني شراء منتجات Adidas بأفضل كاش باك؟"
"أين يمكنني شراء طعام الكلاب بأكبر خصم؟"
"أي بوابات الكاش باك البريطانية تدفع عبر PayPal، وأيها لديها أقل حد أدنى للسحب؟"
"هل يقدّم TopCashback مكافأة تسجيل، وكم مرة يدفع؟"
"نبّهني عندما يبلغ معدل كاش باك Nike 10%."
"أضف Best Buy إلى متاجري المفضّلة."

المثالان الأخيران يستخدمان أدوات الحساب الاختيارية وسيطلبان منك تسجيل الدخول بحسابك في GotCashback.

تفضّل المحادثة عبر Telegram؟ جرّب بوت GotCashback على Telegram

ما الذي يفعله خادم GotCashback MCP

بعد الاتصال، يستطيع مساعد الذكاء الاصطناعي مقارنة معدلات الكاش باك الحالية عبر الإنترنت وداخل المتجر لدى البوابات لمتجر معيّن، والعثور على بطاقات هدايا مخفّضة، وترتيب المتاجر التي تبيع علامة تجارية أو فئة تسوق حسب أفضل عرض، وتصفح المتاجر حسب الدولة، والاطلاع على شروط الدفع لدى كل بوابة (مكافأة التسجيل، الحد الأدنى للسحب، وتيرة الدفع، طرق الدفع). يخبر الخادم المساعد بالأداة التي تجيب عن كل نوع من الأسئلة، فيذهب سؤال بسيط مثل "best cashback for Walmart" مباشرةً إلى البحث الصحيح. تُحدَّث المعدلات عدة مرات يوميًا.

كيف يختار المساعد الأداة

يخبر الخادم المساعدين المتصلين بالأداة التي تجيب عن كل سؤال، فتستطيع أن تسأل بشكل طبيعي:

الكاش باك لمتجر محدد بالاسم ("best cashback for Walmart"، "Best Buy in-store cashback"، "compare Expedia cashback portals") → get_cashback_rates_by_store_name
بطاقات الهدايا المخفّضة لمتجر محدد بالاسم ("best Gap gift card discount") → get_gift_cards_by_store_name
أين تشتري منتجات علامة تجارية بأكبر توفير ("best cashback on Adidas products") → get_best_deals_by_brand
أين تشتري نوعًا من المنتجات بأكبر توفير ("cheapest dog food with cashback") → get_best_deals_by_category
مكافأة التسجيل لدى بوابة أو حدها الأدنى للسحب أو جدول الدفع أو طرق الدفع لديها → get_portals_by_name / get_portals
ما المتاجر التي تقدّم كاش باك في دولة معيّنة → get_stores_by_country

اذكر الدولة عندما يكون ذلك مهمًا ("in Canada"، "UK cashback"): يمرّر المساعد رمز الدولة بأحرف صغيرة مثل us أو ca أو gb (المملكة المتحدة) أو de، ويبحث في جميع الدول المدعومة إن لم تذكرها.

يتوجّه المساعدون إلى هذه الأدوات مباشرةً — ولا يحتاجون أبدًا إلى سرد الدول أو المتاجر أو البوابات أولًا.

الأدوات المتاحة

الأداة	وظيفتها	المدخلات الرئيسية
`get_cashback_rates_by_store_name`	تقارن معدلات الكاش باك الحالية عبر الإنترنت وداخل المتجر لدى البوابات لمتجر بالاسم — الإجابة المباشرة عن "best cashback for Walmart"	store_name, country_code (optional)
`get_cashback_rates_by_store_id`	الوظيفة نفسها عندما يكون معرّف المتجر معروفًا من نتيجة سابقة	store_id
`get_gift_cards_by_store_name`	تعثر على بطاقات الهدايا المخفّضة لمتجر بالاسم وتقارن الخصومات	store_name, country_code (optional)
`get_gift_cards_by_store_id`	الوظيفة نفسها عندما يكون معرّف المتجر معروفًا	store_id
`get_best_deals_by_brand`	ترتّب المتاجر التي تبيع علامة تجارية حسب أفضل معدل كاش باك وأفضل خصم على بطاقات الهدايا	brand_name, country_code (optional)
`get_best_deals_by_category`	الوظيفة نفسها لفئة تسوق (مثل "Pet Supplies")	category_name, country_code (optional)
`get_stores_by_name`	تعثر على معرّف المتجر ودولته ورابط صفحته (دون معدلات)	store_name, country_code (optional)
`get_stores_by_country`	تتصفح كل المتاجر التي تقدّم كاش باك في دولة معيّنة — معرّفات المتاجر وروابطها فقط، دون معدلات؛ وقد تكون القائمة طويلة	country_code
`get_portals`	تعرض بوابات الكاش باك مع شروط الدفع (مكافأة التسجيل، الحد الأدنى للسحب، وتيرة الدفع، طرق الدفع)، اختياريًا حسب الدولة — وليس معدلات المتاجر	country_code (optional)
`get_portals_by_name`	تبحث عن البوابات بالاسم وتعيد شروط الدفع لديها — وليس معدلات المتاجر	portal_name, country_code (optional)
`get_portal_by_id`	تجلب بوابة محددة بمعرّفها مع شروط الدفع لديها	portal_id
`get_countries`	تعرض الدول المدعومة ورموزها (رمز المملكة المتحدة هو gb)	—

country_code هو رمز ISO بأحرف صغيرة مثل us أو ca أو gb (المملكة المتحدة) أو de؛ وهو اختياري ما لم يُذكر أنه مطلوب. أما store_id و portal_id والمعرّفات المشابهة فتأتي من نتيجة سابقة.

الروابط المتتبَّعة في النتائج

كل متجر ومعدل كاش باك وبطاقة هدايا ومكافأة تسجيل لدى بوابة في النتيجة يحمل رابط GotCashback متتبَّعًا (url، إضافةً إلى gift_cards_url عند الاقتضاء). لا يُحتسب الكاش باك ولا تُطبَّق خصومات بطاقات الهدايا ولا تُمنح مكافآت التسجيل إلا عند النقر على هذه الروابط. يوجّه الخادم عملاء الذكاء الاصطناعي إلى عرضها دائمًا — فإذا ذكر المساعد معدلًا دون رابط، اطلب منه الرابط.

أدوات الحساب (تسجيل دخول اختياري)

تسجيل الدخول بحسابك في GotCashback (OAuth 2.1 — سيعرضه عميل الذكاء الاصطناعي لديك تلقائيًا) يتيح أدوات إضافية خاصة بالمستخدم. وتبقى جميع أدوات المقارنة أعلاه تعمل دون تسجيل الدخول.

الأداة	وظيفتها	المدخلات الرئيسية	النطاق
`get_my_profile`	تعيد ملفك الشخصي في GotCashback (الاسم، البريد الإلكتروني، الصورة الرمزية)	—	`profile`
`get_my_favorite_stores`	تعرض متاجرك المفضّلة	—	`favorites`
`toggle_favorite_store`	تضيف متجرًا إلى مفضّلتك أو تزيله منها	store_id, favorite	`favorites`
`get_my_alerts`	تعرض تنبيهاتك للكاش باك وبطاقات الهدايا (المتجر، النوع، الحد، آخر إشعار)	—	`alerts`
`set_store_alert`	تنشئ أو تحدّث تنبيهًا يرسل إليك بريدًا إلكترونيًا عندما يبلغ معدل الكاش باك أو خصم بطاقات الهدايا لمتجر النسبة المئوية المحددة أو يتجاوزها	store_id, alert_type, threshold_percent	`alerts`
`remove_store_alert`	تزيل تنبيهًا لمتجر	store_id, alert_type	`alerts`

التنبيهات هي نفسها التي تديرها في الموقع ضمن الحساب ← التنبيهات: alert_type هو cashback أو gift_card، و threshold_percent بين 1 و 100، وإعادة حفظ تنبيه موجود تحدّث حدّه وتعيد تفعيله، ولكل حساب 10 تنبيهات نشطة على الأكثر.

كيف يعمل تسجيل الدخول

عند أول استخدام لأداة حساب، يرد الخادم بطلب تفويض ويفتح عميل الذكاء الاصطناعي لديك صفحة تسجيل الدخول إلى GotCashback في متصفحك — وهو تسجيل الدخول نفسه عبر الشبكات الاجتماعية المستخدم في الموقع. لا حاجة إلى تسجيل أو مفتاح API.
وافق على الأذونات المطلوبة (scopes) ثم عُد إلى عميلك. يكتمل استدعاء الأداة ويبقى الاتصال مسجَّل الدخول — فالعملاء الذين يطلبون offline_access يحصلون على refresh tokens، ولن يُطلب منك ذلك مجددًا.
لقطع الاتصال، أزل الموصّل من عميل الذكاء الاصطناعي لديك. وإذا أبلغت أداة لاحقًا عن نطاق (scope) مفقود، فأزل الموصّل وأعد إضافته ليطلب العميل التفويض من جديد.

النطاق	ما يتيحه
`profile`	قراءة اسمك وبريدك الإلكتروني وصورتك الرمزية
`favorites`	قراءة متاجرك المفضّلة وتعديلها
`alerts`	قراءة تنبيهاتك للكاش باك وبطاقات الهدايا وإنشاؤها وإزالتها
`offline_access`	refresh tokens ليبقى الاتصال مسجَّل الدخول

عنوان الخادم

https://mcp.gotcashback.com

هذا خادم MCP بعيد (بروتوكول النقل Streamable HTTP). لا تحتاج إلى تثبيت أو استضافة أي شيء — يكفي توجيه مساعد ذكاء اصطناعي متوافق إلى عنوان URL أعلاه.

للمطورين ووكلاء الذكاء الاصطناعي

الخادم (الإصدار 1.1.1) يوفّر أدوات فقط (دون موارد أو قوالب أوامر). لكل أداة عنوان ووصف يوضّح متى تُستخدم وتعليقات توضيحية للقراءة فقط و — لأدوات المقارنة — مخطط مخرجات منشور. تتيح نقاط النهاية التالية لأي وكيل أو تكامل اكتشاف الخادم والاتصال به دون قراءة هذه الصفحة:

تعيد أدوات المقارنة JSON الخام من الواجهة البرمجية كنص، إضافةً إلى محتوى منظّم محدد الأنواع يطابق مخطط مخرجاتها، فتستطيع التكاملات قراءة حقول المتجر والبوابة والمعدل و"حتى" وعبر الإنترنت/داخل المتجر دون تخمين. المعرّفات غير المعروفة وانقطاعات الواجهة البرمجية تعود كأخطاء أدوات لا كإخفاقات في البروتوكول.

https://mcp.gotcashback.com — نقطة نهاية MCP — Streamable HTTP، JSON-RPC عبر POST، عديمة الحالة (لا تحتاج إلى session affinity)
https://mcp.gotcashback.com/.well-known/mcp/server-card.json — بطاقة خادم MCP تصف الخادم وبروتوكول النقل والمصادقة (متاحة أيضًا على هذا الموقع)
https://mcp.gotcashback.com/.well-known/oauth-protected-resource — بيانات OAuth الوصفية للمورد المحمي: النطاقات (scopes) المدعومة وخادم التفويض
https://www.gotcashback.com/.well-known/oauth-authorization-server — البيانات الوصفية لخادم التفويض — authorization code flow مع PKCE، تسجيل ديناميكي للعملاء (عملاء عامّون وسرّيون)، refresh tokens
https://www.gotcashback.com/auth.md — سياسة مصادقة الوكلاء
https://www.gotcashback.com/llms.txt — فهرس الموقع القابل للقراءة من الوكلاء
https://api.gotcashback.com/swagger/ — واجهة REST API المجانية التي تعتمد عليها الأدوات (مواصفة OpenAPI، دون مفتاح)
https://mcp.gotcashback.com/health — فحص الحالة (health check)

CORS مفتوح لأي origin، فيمكن للوكلاء العاملين في المتصفح الاتصال مباشرةً؛ وترويستا الاستجابة Mcp-Session-Id و WWW-Authenticate مكشوفتان.

أسئلة أو مشكلات؟

إذا فشل الاتصال أو انتهى استدعاء أداة بخطأ، فتأكد من إدخال عنوان URL تمامًا بالشكل https://mcp.gotcashback.com دون مسار إضافي في نهايته. وإذا ظلت أداة حساب تطلب منك تسجيل الدخول، فأزل الموصّل وأعد إضافته. للمزيد من المساعدة، تواصل مع دعم GotCashback.