概览
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。