Airalo MCP Server
Buy, top up and track eSIMs on your Airalo account.
Server MCP Terhosting
npx add-mcp 'https://cotlet.dev/mcp/v1/airalo'Terpasang ke Claude Code, Codex, Cursor, dan lainnya
Dokumentasi
Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up
Airalo API and MCP server: Let your AI agent watch your Airalo eSIM data.
Airalo has no MCP server and no API for a personal account (checked 27 Oct 2026). Its Partner API lets businesses sell Airalo eSIMs to their own customers. Cotlet runs 13 Airalo tools hosted, over MCP for agents and REST for scripts, on your own account.
Buy, top up and track eSIMs on your Airalo account. Use it in ChatGPT, Claude or any AI agent over MCP, or in n8n, Make and scripts over REST.
- Free 7-day trial, no card
- Unofficial, not affiliated with Airalo
- Page: https://cotlet.dev/integrations/airalo-api-mcp-server
What can you automate in Airalo?
- Find a package for the next trip
- Check data left every morning
- Top up before data runs out
- Fetch the QR code and install codes
- Turn renewals off after the trip
- Request a refund for a wrong eSIM
Does Airalo have an MCP server or an API?
- The Partner API manages eSIMs a partner sold, with sandbox, SDKs for Node.js, PHP and Python, and low data notifications. It never sees the eSIMs, orders or Airmoney in your own account. Version 1 switches off on 1 May 2027.
- Zapier and n8n have no Airalo app. Renewals in the app rebuy the same package with a saved card on some packages only, never with Airmoney.
- The eSIM connectors for Claude and ChatGPT that do exist come from other eSIM shops and sell their own plans.
| What you need | Partner API | eSIM comparison MCP | Cotlet |
|---|---|---|---|
| See the eSIMs in your own account | No, partner orders only | No | Yes |
| Data left and expiry | Partner eSIMs only | No | Yes, from My eSIMs |
| Top up and pay with Airmoney | Top-ups, no Airmoney | No | Yes, after your OK |
| Renewals and refunds | No | No | Yes, after your OK |
| Who can sign up | Approved businesses | Anyone | Anyone with Airalo |
Checked 27 Oct 2026. Sources: Airalo Partner API overview, Airalo Partner API docs, Airalo Help: What are renewals and how do they work?, Airalo Acceptable Use Policy
How does Cotlet connect to Airalo?
- Sign in to Airalo. Use your own account in its Cotlet Cloud Browser.
- Choose MCP or REST. Connect your agent or create a Cotlet API key.
- Run your workflow. Ask your agent or send an HTTP request.
We never keep your Airalo password or card, and nothing is bought or refunded until you approve it.
Connect Airalo to your agent or workflow
Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide.
- Enable Airalo for agents. Make a Cotlet account, log in to Airalo in its Cloud Browser with the emailed code, then press Enable for agents.
- Add the Cotlet address. Put https://cotlet.dev/mcp/v1 in the MCP server or connector list of your agent.
- Allow the connection. Chat apps show a Cotlet sign-in once. Editors, n8n and scripts send an API key from the console.
https://cotlet.dev/mcp/v1 is one address for all your apps, Airalo among them. Turned Airalo on after you connected? Refresh the connector and the eSIM tools appear.
Claude:
Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect
Claude Code:
claude mcp add --transport http cotlet-airalo \
https://cotlet.dev/mcp/v1 \
--header "Authorization: Bearer $COTLET_API_KEY"
ChatGPT:
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth
Cursor:
// ~/.cursor/mcp.json
{
"mcpServers": {
"cotlet-airalo": {
"url": "https://cotlet.dev/mcp/v1",
"headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
}
}
}
Codex:
# ~/.codex/config.toml
[mcp_servers.cotlet-airalo]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
n8n:
MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: airalo_read
Make, Zapier:
Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: airalo_write
How to use the Airalo REST API
Create your Cotlet API key
Create a Cotlet API key with access to Airalo and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.
Connect Airalo in Cotlet and enable it for agents. Account access: Your own Airalo account (email and password, or Google or Apple sign-in). Airalo emails a verification code on a login from a new device, which you enter once when you connect.
Make your first Airalo API request
REST:
curl https://cotlet.dev/api/v1/airalo/esims \
-H "Authorization: Bearer $COTLET_API_KEY"
Read my esims and apply the operation limits
A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.
Illustrative response excerpt:
{
"status": "success",
"app": "airalo",
"tool": "list_esims",
"result": {
"esims": [
{
"esim_id": "es_48213",
"destination": "Thailand",
"package": "Thailand 5 GB, 30 days",
"iccid": "8910300000000048213",
"rechargeable": true
},
{
"esim_id": "es_47790",
"destination": "Japan",
"package": "Japan 5 GB, 7 days",
"iccid": "8910300000000047790",
"rechargeable": false
}
]
}
}
Lists the eSIMs in your account with destination, package, ICCID and whether the eSIM is rechargeable. Use esim_id from each item with the other eSIM tools.
Set rechargeable_only to see only the eSIMs a top-up can reach.
Keep the same selection when continuing a list. Compare changed record values as well as identifiers when refreshing your destination.
Airalo workflows for agents and automations
| Tool | Connect through | Example workflow |
|---|---|---|
| n8n | HTTP Request | Remaining and used data on an eSIM and when the current package expires. Use get_data_usage in your configured travel brief. |
| Make | HTTP > Make a request | QR code, SM-DP+ address and activation code to install the eSIM, from Install or share. Use get_install_instructions in your configured travel brief. |
| Python or Node.js | REST API | Your orders from Profile > Orders: package, date, amount and order number. Use list_orders in your configured travel brief. |
Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.
Cotlet reads Airalo; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template.
Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports.
The API and MCP reference lists operations and inputs. The REST API guide explains authentication, errors and approvals.
Airalo API endpoints and MCP tools
eSIM store
Prices in USD as the store lists them. When checkout wants a card or 3-D Secure, the purchase stops at a checkout link you finish yourself.
- Search packages (
search_packages, read): eSIM packages from the store for a country or region, with data, validity and price. - Buy eSIM (
buy_esim, write, asks first): Buy a package from search_packages; the eSIM appears under My eSIMs, ready to install. - Redeem eSIM voucher (
redeem_voucher, write, asks first): Redeem an eSIM voucher code, which adds one package to your account.
My eSIMs, data and install codes
Some packages show no data bar; the usage tool then says so instead of guessing. Nothing installs on your phone: you scan the QR code.
- List my eSIMs (
list_esims, read): eSIMs under My eSIMs, with destination, ICCID and whether they can be topped up. - Get eSIM details (
get_esim, read): Details of one eSIM: ICCID, package history, whether it is rechargeable and whether renewals are offered and on. - Get data usage (
get_data_usage, read): Remaining and used data on an eSIM and when the current package expires. - Get install instructions (
get_install_instructions, read): QR code, SM-DP+ address and activation code to install the eSIM, from Install or share.
Top-ups and renewals
Only rechargeable eSIMs take a top-up. Renewals cannot be switched on once the data or the validity has run out.
- List top-up packages (
list_topup_packages, read): Top-up packages available for a rechargeable eSIM, with data, validity and price. - Top up eSIM (
top_up_esim, write, asks first): Add a top-up package to a rechargeable eSIM. - Set renewals (
set_renewals, write, asks first): Turn renewals on or off for an eSIM, when it offers them.
Orders, Airmoney and refunds
Airmoney applies from 1 USD. A refund works only where Airalo shows the Request Refund button.
- List orders (
list_orders, read): Your orders from Profile > Orders: package, date, amount and order number. - Get Airmoney (
get_airmoney, read): Airmoney balance in USD, from Airmoney & Membership. - Request refund (
request_refund, write, asks first): Ask for a refund on an eligible order, the same as the Request Refund button.
Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/airalo-api-mcp-server#tools
Who can see my Airalo session, and how do I revoke it?
- What we store. Your logged-in Airalo profile, AES-256-GCM encrypted, in Finland. No password, no card number.
- What your agent gets. The 13 Airalo tools. No cookie and no login.
- What the session sees. Your eSIMs and their ICCIDs, install codes, orders and Airmoney.
- What no tool touches. Card details, password, email, trusted devices, account deletion.
- If Airalo asks for a code. A new device gets a code by email. You type it, we never do.
- How to cut access. Disable for agents, reset the browser, or remove it under Profile > Trusted Devices.
Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results). No SOC 2 report or third-party pentest yet.
Is it against Airalo's terms? Account safety
You must not use any automated system, including without limitation "robots", "spiders" or "offline readers" to access the Services.
The Terms of Use of July 2026 let Airalo suspend or close an account at its sole discretion, and a breach of the policy costs the right to a refund. An agent in your account counts as an automated system on paper. We found no public case of an Airalo account closed for automation (checked 27 Oct 2026).
How we keep your account looking like you:
- Your own traveler account, logged in by you
- One Cloud Browser that Airalo keeps as a trusted device
- Every purchase, top-up, voucher and refund waits for your OK
- Card checkout and 3-D Secure stay with you
- If Airalo objects, we pause the Airalo tools for everyone within 24 h
Airalo may send a refund to manual review after several recent automated refunds. Ask for one refund at a time, and only where the button shows.
What happens when Airalo changes?
- 12 h between tests of the Airalo reads
- 24 h between tests of buys, top-ups and refunds
- $0 for a call to an Airalo tool paused for repair
Airalo redesigns My eSIMs or moves the Renewals toggle, and the repair happens on our side. status.cotlet.dev checks the site, console and API every 3 minutes.
Approvals, undo and mistakes
- Reads the data bar. Data left and expiry on the eSIM you use.
- Picks a top-up. The smallest one, or your rule, Airmoney first.
- Waits for your OK. Package, price and Airmoney show in your console.
- Reports or hands over. Order number, or a checkout link if a card is due.
| Action | Undo |
|---|---|
| Buy an eSIM | Refund before install; Wrong purchase pays back in Airmoney only |
| Top up an eSIM | Refund only if Airalo shows the button |
| Redeem a voucher | No, the code is used up |
| Request a refund | No, it goes out at once |
| Set renewals | Yes, same tool, while data and validity last |
5 of 13 tools ask first: all 5 writes, since each one spends or returns money or changes what Airalo buys next. Reads run at once. Switch the wait off per tool for a scheduled top-up.
The refund reason decides where the money goes. Wrong purchase and Plans changed refund to Airmoney only; a card refund takes 7 to 10 business days.
MCP call:
{
"name": "top_up_esim",
"arguments": {
"esim_id": "es_48213",
"package_id": "th-topup-3gb-30d",
"airmoney_usd": 2.4
}
}
REST:
curl -X POST https://cotlet.dev/api/v1/airalo/esims/es_48213/up-esim/top \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"package_id":"th-topup-3gb-30d","airmoney_usd":2.4}'
Response:
{
"esim_id": "es_48213",
"order_id": "2026101112399",
"package": "Thailand 3 GB, 30 days",
"price_usd": 6.5,
"airmoney_applied_usd": 2.4,
"due_usd": 4.1,
"status": "checkout_required",
"checkout_url": "https://example.com/checkout/2026101112399"
}
Scripts and cron jobs call the same tools over REST at /api/v1/airalo, one key, one price. A top-up on a non-rechargeable eSIM fails, and a failed call costs nothing. Each tool's REST path is in the tools table.
How much does the Airalo MCP server cost?
About $11 a month for one 10-day trip a month, 1,920 credits. Airalo bills your eSIM packages as before.
| Job | Calls | Credits |
|---|---|---|
| Pick and buy the trip eSIM, fetch the QR code | 3 × 1 | 30 |
| Morning data check during the trip | 2 × 10 | 200 |
| Top up when data runs low | 3 × 2 | 60 |
| Renewals off on the way home | 5 × 1 | 50 |
| Orders and Airmoney, weekly | 2 × 4 | 80 |
| Cloud Browser, 30 days | 1,500 | |
| Total | 1,920 |
- Free 7-day trial, no card
- 10 credits per successful call, MCP or REST
- 50 credits a day for the Cloud Browser
- Packs valid 12 months, so quiet months between trips cost nothing extra
The month is our example: Airalo publishes no trips per customer. A Japan 5 GB, 30-day package sold for 10.50 EUR on airalo.com on 27 Oct 2026, paid to Airalo, not to us. Dollars at the $29 pack rate.
Airalo MCP server on GitHub, Zapier or hosted: which to use
| Option | What it does | Where it stops |
|---|---|---|
| Airalo Partner SDKs | Official PHP, Node.js and Python SDKs for the Partner API (18, 8 and 2 stars, updated 13 Oct 2026). | For approved resellers; no MCP, no personal account. |
| eSIM Finder | Free Claude and ChatGPT connector: compare plans in 190+ countries, get a checkout link. | Search only: no purchase, no account, no data left. |
| vladkomudrich/esimagent-mcp and similar | GitHub servers that compare eSIM plans across providers (1 to 2 stars). | Read prices only; your Airalo eSIMs stay out. |
| Alt eSIM, eSIM SOS, Wigoo, eSIM Tabby | Other eSIM shops with their own MCP: search and buy their plans. | You switch provider; Airmoney and your Airalo eSIMs stay behind. |
No Airalo MCP server exists on GitHub, and Zapier and n8n have no Airalo app. A comparison connector helps you choose a plan before the trip. Another shop's MCP fits if you are ready to leave Airalo. Cotlet keeps your Airalo account and lets an agent handle data, top-ups, renewals and refunds in it.
Who runs Cotlet
Cotlet belongs to Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273), in business since 2019 and founded by Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the Airalo tools go to contact@cotlet.dev.
Airalo API and MCP: questions
How do I get access?
Open a free account at https://cotlet.dev, choose Airalo under Integrations in the console and log in to Airalo in its Cloud Browser. The trial starts when you sign up and asks for no card.
How do I connect Airalo to ChatGPT or Claude?
Sign up at cotlet.dev, log in to Airalo once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Airalo account through Cotlet, in their phone apps too.
What can ChatGPT do in Airalo?
With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Airalo: check how much eSIM data is left; top up an eSIM before data runs out; turn off eSIM renewals after a trip. You ask in plain words, and anything that reaches other people waits for your OK first.
Can my agent install the eSIM on my phone?
No. get_install_instructions returns the QR code and the manual codes, and you scan or enter them in your phone's Settings. Airalo's iOS guide describes manual installation with the SM-DP+ address, the activation code and a confirmation code if one is provided.
Can it pay with my Airmoney balance?
Yes, for purchases and top-ups, through airmoney_usd. Airalo needs a balance of at least 1 USD to apply Airmoney, and Airmoney cannot pay for renewals, which need a saved payment method.
Does Airalo have webhooks?
Not for travelers. Low data alerts at 25% and 10% go to the Airalo app only; the Partner API sends them to resellers. Run your agent on a schedule instead, for example a get_data_usage check each morning of the trip.
Can I use the Airalo Partner API for my own eSIMs?
No. It sees only the eSIMs a partner sold to its customers, and partners apply through Airalo's sales team. Your own eSIMs, orders and Airmoney are reachable only in your account.
Does the agent pay with my card?
No tool enters card details. Airmoney can be applied from 1 USD; when a card or 3-D Secure is due, the agent sends you Airalo's checkout link to finish.
Is the MCP server different from the REST API?
Just the entrance. Both carry the same 13 tools, inputs and answers, with one API key and one price. Agents use MCP; scripts and HTTP steps use REST.
Is Cotlet affiliated with Airalo?
No. Cotlet is independent and not affiliated with Airalo.
Can I use the Airalo API without an AI agent?
Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST.
Give your AI agents your signed-in browser.
Product: Integrations · How it works · Pricing · Security
Resources: Blog · API docs · Help center · Changelog · GitHub
Solutions: For developers · For automation agencies
Company: About · AI info: company facts · Contact
Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors
Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub
Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us
Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.