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/mcpTip
Adding 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 dalam bahasa apa pun) atau countries (semua sekaligus), 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 | Detail eSIM — id, lang |
compare_esims | tool | Bandingkan 2–5 paket berdampingan — ids (dari search_esims), lang. Menunjukkan paket dengan harga terendah, data terbanyak, masa berlaku terlama, dan harga per GB terendah |
list_countries | tool | Negara yang dijual — query, lang |
search / fetch | tool | Alat yang kompatibel dengan ChatGPT — search {query} (teks bebas; memahami tanpa batas, harian, nomor telepon lokal, jaringan lokal, hotspot, dan 5G), fetch {id} |
Di aplikasi yang mendukung MCP Apps (seperti Claude, ChatGPT, dan VS Code), hasil search_esims, get_esim, dan compare_esims tampil sebagai kartu paket. Lihat paket membuka halaman paket di esimoa.com; kartu tidak pernah menerima pembayaran.
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. Panggilan yang dikirim Claude dan ChatGPT dari server mereka dihitung per platform, bukan per IP. Jika melebihi, Anda menerima galat JSON-RPC (-32002) dengan HTTP 429.
