Docs
Trung tâm nhà phát triểnBảng điều khiểnesimoa.com
    • Giới thiệu
    • Bắt đầu nhanh
    • Xác thực
    • Overview
    • Liệt kê eSIM
    • Mua eSIM
    • Quốc gia
    • OpenAPI
    • Theo dõi và hoa hồng
    • Giới hạn tần suất và lỗi
    • Overview
    • Danh sách MCP
    • Claude
    • ChatGPT
    • Gemini
    • Ứng dụng khách MCP khác
    • Overview
    • Xác thực
    • Sản phẩm
    • Chi tiết sản phẩm
    • Quốc gia
    • Errors & rate limits
  1. Docs
  2. Tích hợp AI (MCP)
  3. Overview

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.

On this page
  • Server URL
  • Adding your partner key
  • Available tools
  • Rate limits
  • Connect a client

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).

url
https://api.esimoa.com/mcp

Tiền boa

Mới dùng MCP? Hãy bắt đầu với Claude — dán một URL, không cần đăng nhập, và bạn sẽ kết nối xong trong khoảng một phút. Cách kết nối Claude

Adding your partner key#

Tiền boa

Đối tác: hãy thêm khóa của bạn để các liên kết do AI chia sẻ mang mã đối tác của bạn và tạo hoa hồng. Trên màn hình trình kết nối của Claude hoặc ChatGPT không thể đặt header, hãy thêm ?key= vào URL:
url
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ườngLoạiMô tả
search_esimstoolTì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_esimtoolChi tiết eSIM — id, lang
compare_esimstoolSo sánh 2–5 gói cạnh nhau — ids (từ search_esims), lang. Cho biết gói có giá thấp nhất, nhiều dữ liệu nhất, hiệu lực lâu nhất và giá mỗi GB thấp nhất
list_countriestoolCác quốc gia đang bán — query, lang
search / fetchtoolCô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}

Trong các ứng dụng hỗ trợ MCP Apps (như Claude, ChatGPT và VS Code), kết quả của search_esims, get_esim và compare_esims hiển thị dưới dạng thẻ gói. Xem gói sẽ mở trang gói trên esimoa.com; thẻ không bao giờ thu tiền.

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 là 600 yêu cầu mỗi phút cho mỗi khóa. Các lệnh gọi Claude và ChatGPT gửi từ máy chủ của họ được tính theo nền tảng, không theo IP. Vượt quá giới hạn, bạn nhận lỗi JSON-RPC (-32002) với HTTP 429.

Connect a client#

Danh sách MCP

Claudetrình kết nối claude.ai · Claude CodeChatGPTTrình kết nối chế độ nhà phát triểnGeminiGemini CLI · ~/.gemini/settings.jsonỨng dụng khách MCP khácJSON-RPC 2.0 · POST

Cập nhật lần cuối: 2 tháng 10, 2026

PreviousGiới hạn tần suất và lỗiTiếp theoDanh sách MCP

On this page

  • Server URL
  • Adding your partner key
  • Available tools
  • Rate limits
  • Connect a client

APIs and MCP for bringing esimoa eSIMs to your product

Resources

  • Docs
  • API reference
  • API đối tác (B2B)
  • MCP server
  • OpenAPI spec

esimoa

  • Trang chủ
  • eSIM gói cước
  • Trung tâm nhà phát triển
  • Bảng điều khiển
  • Cổng đối tác

Company

  • Về chúng tôi
  • Hợp tác
  • Điều khoản dịch vụ
  • Chính sách quyền riêng tư
  • Chính sách giao hàng và hoàn tiền

Hỗ trợ

  • support@esimoa.com
  • Chat hỗ trợ

NBase Korea Co., Ltd.

902, Bldg A, 767 Sinsu-ro, Suji-gu, Yongin-si, Gyeonggi-do (Dongcheon-dong, Bundang Suji U-TOWER)

Trụ sở tại Mỹ: NBASE CORP. · Corporate Park, Irvine, CA 92606, USA

© 2026 esimoa. Bảo lưu mọi quyền.