Overview
عمليات التكامل مع الذكاء الاصطناعي (MCP)
Connect the official esimoa MCP server so AI assistants can search and compare eSIMs and share purchase links.
Server URL#
خادم MCP الرسمي من esimoa https://api.esimoa.com/mcp يتيح لمساعدي الذكاء الاصطناعي البحث عن شرائح eSIM ومقارنتها ومشاركة روابط الشراء. يستخدم Streamable HTTP (JSON عديم الحالة) ويعمل دون مفتاح (120 طلبًا/دقيقة لكل IP).
https://api.esimoa.com/mcpالبقشيش
Adding your partner key#
البقشيش
https://api.esimoa.com/mcp?key=esk_live_your_key_hereيمكن للعملاء الذين يدعمون الترويسات إرسال X-API-Key أو Authorization: Bearer بدلًا من ذلك. يُرفض المفتاح الخاطئ بالرمز 401 — لاستخدام الخادم دون مفتاح، احذفه تمامًا.
Available tools#
| الحقل | النوع | الوصف |
|---|---|---|
search_esims | tool | البحث عن eSIM — country (رمز ISO أو اسم بأي لغة) أو countries (كلها معًا)، days، data_gb / max_data_gb، unlimited، data_type (daily|total)، local_number، network (local|roaming)، multi_country، min_price_krw / max_price_krw، provider، hotspot / five_g، sort، limit (≤10)، lang |
get_esim | tool | تفاصيل eSIM — id, lang |
compare_esims | tool | قارن من 2 إلى 5 باقات جنبًا إلى جنب — ids (من search_esims)، lang. يبيّن الباقة الأقل سعرًا والأكثر بيانات والأطول صلاحية والأقل سعرًا لكل غيغابايت |
list_countries | tool | البلدان المعروضة للبيع — query، lang |
search / fetch | tool | أدوات متوافقة مع ChatGPT — search {query} (نص حر؛ يفهم غير المحدود واليومي ورقم الهاتف المحلي والشبكة المحلية ونقطة الاتصال و5G)، fetch {id} |
في التطبيقات التي تدعم MCP Apps (مثل Claude وChatGPT وVS Code) تظهر نتائج search_esims وget_esim وcompare_esims على شكل بطاقات باقات. يفتح زر «عرض الباقة» صفحة الباقة على esimoa.com، ولا تتم أي عملية دفع من البطاقات.
Rate limits#
ملاحظة
تتشارك API العامة وMCP المصادق عليه حصة بالساعة لكل شريك (20,000 افتراضيًا). لا تؤدي إضافة المفاتيح أو تدويرها إلى زيادتها.
تبدأ نافذة الـ 3,600 ثانية مع أول طلب، ويُطبَّق الحد لكل دقيقة أيضًا. تُحسب الحصص بعدد الاستدعاءات لا بحجم MB المنقولة. قد تغيّر الإعدادات التشغيلية الحصة.
تقبل دفعات MCP حتى 100 رسالة، وتُحتسب كل رسالة كاستدعاء واحد. الدفعة التي تتجاوز الحصة المتاحة تُرجع 429 قبل التنفيذ.
X-RateLimit-Hour-Limit · X-RateLimit-Hour-Remaining · X-RateLimit-Hour-Reset
تُظهر هذه الترويسات الحد بالساعة والاستدعاءات المتبقية ووقت إعادة التعيين (بثواني Unix). عند استنفاد الحد بالساعة يُرجَع HTTP 429 مع Retry-After بالثواني. لا تُحتسب الاستدعاءات المرفوضة بسبب الحد لكل دقيقة ضمن الحصة بالساعة.
بدون مفتاح يكون الحد 120 طلبًا في الدقيقة لكل عنوان IP، ومع مفتاح شريك 600 طلب في الدقيقة لكل مفتاح. تُحتسب الطلبات التي يرسلها Claude وChatGPT من خوادمهما حسب المنصة لا حسب عنوان IP. عند تجاوز الحد تتلقى خطأ JSON-RPC (-32002) مع HTTP 429.
