概覽
AI 整合（MCP）
連接 esimoa 官方 MCP 伺服器，AI 即可搜尋、比較 eSIM 並提供購買連結。
伺服器網址#
esimoa 官方 MCP 伺服器 https://api.esimoa.com/mcp，AI 即可搜尋、比較 eSIM 並提供購買連結。採用 Streamable HTTP（無狀態 JSON），無需金鑰也可使用（每個 IP 每分鐘 120 次）。
url
https://api.esimoa.com/mcp填入合作夥伴金鑰#
提示
合作夥伴請同時填入金鑰，這樣 AI 提供的連結會帶上您的合作夥伴代碼並累積佣金。在無法設定標頭的 Claude、ChatGPT 連接器畫面中，在 URL 末尾加上 ?key= 即可：
url
https://api.esimoa.com/mcp?key=esk_live_your_key_here支援標頭的用戶端也可以透過 X-API-Key 或 Authorization: Bearer 傳送。錯誤的金鑰會被 401 拒絕，若不使用金鑰請完全移除。
可用工具#
| 欄位 | 類型 | 說明 |
|---|---|---|
search_esims | tool | 搜尋 eSIM — country（ISO 代碼或任何語言的國家名）、days、data_gb、unlimited、sort、limit（≤10）、lang |
get_esim | tool | 商品詳情 — id、lang |
list_countries | tool | 販售國家 — query、lang |
search / fetch | tool | ChatGPT 相容工具 — search {query}、fetch {id} |
速率限制#
注意
公開 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 秒數。每分鐘限制拒絕的請求不計入小時配額。
不使用金鑰時每個 IP 每分鐘 120 次，使用合作夥伴金鑰時每組金鑰每分鐘 600 次。超出後回傳 JSON-RPC 錯誤（-32002）與 HTTP 429。