Overview
Integrasi AI (MCP)
Connect the official esimoa MCP server so AI assistants can search and compare eSIMs and share purchase links.
Server URL#
Server MCP resmi esimoa https://api.esimoa.com/mcp memungkinkan asisten AI mencari dan membandingkan eSIM serta membagikan tautan pembelian. Menggunakan Streamable HTTP (JSON stateless) dan berfungsi tanpa kunci (120 permintaan/menit per IP).
https://api.esimoa.com/mcpAdding your partner key#
Tip
https://api.esimoa.com/mcp?key=esk_live_your_key_hereKlien yang mendukung header dapat mengirim X-API-Key atau Authorization: Bearer sebagai gantinya. Kunci yang salah ditolak dengan 401 — untuk memakai server tanpa kunci, hilangkan kunci sepenuhnya.
Available tools#
| Field | Jenis | Deskripsi |
|---|---|---|
search_esims | tool | Cari eSIM — country (kode ISO atau nama negara dalam bahasa apa pun), days, data_gb, unlimited, sort, limit (≤10), lang |
get_esim | tool | Detail eSIM — id, lang |
list_countries | tool | Negara yang dijual — query, lang |
search / fetch | tool | Alat yang kompatibel dengan ChatGPT — search {query}, fetch {id} |
Rate limits#
Catatan
API Publik dan MCP terautentikasi berbagi kuota per jam untuk setiap mitra (default 20.000). Menambah atau merotasi kunci tidak menambah kuota.
Jendela 3,600 detik dimulai sejak permintaan pertama; batas per menit juga berlaku. Kuota menghitung jumlah panggilan, bukan MB yang ditransfer. Pengaturan operasional dapat mengubah kuota.
Batch MCP menerima hingga 100 pesan dan setiap pesan dihitung sebagai satu panggilan. Batch yang melebihi kuota tersedia mengembalikan 429 sebelum dieksekusi.
X-RateLimit-Hour-Limit · X-RateLimit-Hour-Remaining · X-RateLimit-Hour-Reset
Header ini menunjukkan batas per jam, sisa panggilan, dan waktu reset (detik Unix). Jika kuota per jam habis, akan dikembalikan HTTP 429 dan Retry-After dalam detik. Panggilan yang ditolak oleh batas per menit tidak dihitung dalam kuota per jam.
Tanpa kunci, batasnya 120 permintaan per menit per IP; dengan kunci mitra, 600 per menit per kunci. Jika melebihi, Anda menerima error JSON-RPC (-32002) dengan HTTP 429.