概要

AI連携（MCP）

esimoa公式MCPサーバーを接続すると、AIがeSIMを検索・比較し購入リンクを案内します。

このページの内容

サーバーURL#

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メッセージで、各メッセージを1回として数えます。残りの上限を超えるバッチは実行前に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が返ります。

概要