Overview
Tích hợp AI (MCP)
Connect the official esimoa MCP server so AI assistants can search and compare eSIMs and share purchase links.
Server URL#
Máy chủ MCP chính thức của esimoa https://api.esimoa.com/mcp cho phép trợ lý AI tìm kiếm, so sánh eSIM và chia sẻ liên kết mua hàng. Dùng Streamable HTTP (JSON không trạng thái) và hoạt động không cần khóa (120 yêu cầu/phút mỗi IP).
https://api.esimoa.com/mcpTiền boa
Adding your partner key#
Tiền boa
https://api.esimoa.com/mcp?key=esk_live_your_key_hereỨng dụng khách hỗ trợ header có thể gửi X-API-Key hoặc Authorization: Bearer thay thế. Khóa sai sẽ bị từ chối với mã 401 — để dùng máy chủ không cần khóa, hãy bỏ hẳn khóa.
Available tools#
| Trường | Loại | Mô tả |
|---|---|---|
search_esims | tool | Tìm eSIM — country (mã ISO hoặc tên bằng bất kỳ ngôn ngữ nào) hoặc countries (tất cả cùng lúc), 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 | Chi tiết eSIM — id, lang |
list_countries | tool | Các quốc gia đang bán — query, lang |
search / fetch | tool | Công cụ tương thích ChatGPT — search {query} (văn bản tự do; hiểu không giới hạn, theo ngày, số điện thoại địa phương, mạng địa phương, điểm phát sóng và 5G), fetch {id} |
Rate limits#
Lưu ý
API công khai và MCP đã xác thực dùng chung hạn mức theo giờ cho mỗi đối tác (mặc định 20.000). Thêm hoặc xoay vòng khóa không làm tăng hạn mức này.
Khung 3,600 giây bắt đầu từ yêu cầu đầu tiên; giới hạn theo phút cũng được áp dụng. Hạn mức tính theo số lần gọi, không phải số MB truyền tải. Cài đặt vận hành có thể thay đổi hạn mức.
Lô MCP nhận tối đa 100 tin nhắn và mỗi tin nhắn được tính là một lệnh gọi. Lô vượt quá hạn mức khả dụng sẽ trả về 429 trước khi thực thi.
X-RateLimit-Hour-Limit · X-RateLimit-Hour-Remaining · X-RateLimit-Hour-Reset
Các header này cho biết giới hạn theo giờ, số lần gọi còn lại và thời điểm đặt lại (giây Unix). Khi hết hạn mức theo giờ, hệ thống trả về HTTP 429 kèm Retry-After tính bằng giây. Các lần gọi bị từ chối do giới hạn theo phút không tính vào hạn mức theo giờ.
Không có khóa, giới hạn là 120 yêu cầu mỗi phút cho mỗi IP; có khóa đối tác, giới hạn là 600 mỗi phút cho mỗi khóa. Vượt quá sẽ nhận lỗi JSON-RPC (-32002) kèm HTTP 429.