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/mcpAdding 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 أو اسم الدولة بأي لغة)، days، data_gb، unlimited، sort، limit (≤10)، lang |
get_esim | tool | تفاصيل eSIM — id, lang |
list_countries | tool | البلدان المعروضة للبيع — query، lang |
search / fetch | tool | أدوات متوافقة مع ChatGPT — search {query}، fetch {id} |
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 في الدقيقة لكل مفتاح. عند التجاوز ستتلقى خطأ JSON-RPC (-32002) مع HTTP 429.