Anonymous eSIMs, phone numbers, and SMS codes in 190+ countries. Crypto-paid; agents self-onboard.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Cancel an unused eSIM and receive a refund to your wallet balance. Only works if the eSIM has not been installed or activated. Requires an agent-wallet API key (ak_live_).
ICCID of the eSIM to cancel
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Cancel an unused eSIM and receive a refund to your wallet balance. Only works if the eSIM has not been installed or activated. Requires an agent-wallet API key (ak_live_).
| Argument | Type | Description |
|---|---|---|
| iccid* | string | ICCID of the eSIM to cancel |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"iccid"
],
"properties": {
"iccid": {
"type": "string",
"description": "ICCID of the eSIM to cancel"
}
}
}Cancel a long-term SMS rental and refund the full amount to the wallet. Only works within 2 hours of purchase AND only if the number has NOT received any message — this mirrors the provider refund window, so if the window has passed or a code already arrived it returns a clear reason and refunds nothing (the number worked). Use for a genuine change of mind or a wrong purchase shortly after renting. The receiptId comes from rent_sms_number or list_sms_orders. Requires a connected agent wallet.
| Argument | Type | Description |
|---|---|---|
| receiptId* | string | The rental receipt ID from rent_sms_number or list_sms_orders |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"receiptId"
],
"properties": {
"receiptId": {
"type": "string",
"description": "The rental receipt ID from rent_sms_number or list_sms_orders"
}
}
}Cancel a quick SMS order that is still waiting for a code and refund it to the wallet immediately. Refused if the SMS was already delivered (read it with check_sms_verification instead). Requires a connected agent wallet.
| Argument | Type | Description |
|---|---|---|
| orderId* | string | The Order ID of the waiting quick SMS order |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orderId"
],
"properties": {
"orderId": {
"type": "string",
"description": "The Order ID of the waiting quick SMS order"
}
}
}Returns the prepaid spending balance of the connected PikaSim agent wallet, in USD. Read-only; makes no changes. Call this before purchase_esim or purchase_phone_plan to confirm sufficient funds, or any time you need the current balance. Requires a connected agent wallet (OAuth or ak_live_ key). If no wallet is connected, the result explains how to connect one.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Check what PikaSim plans cover a country. Returns TWO buckets: DATA eSIMs (count, price range, data amounts) and PHONE-NUMBER eSIMs (count, price range — a real carrier number with voice + SMS).
| Argument | Type | Description |
|---|---|---|
| country* | string | ISO 3166-1 alpha-2 country code (e.g., JP, US, DE) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"country"
],
"properties": {
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code (e.g., JP, US, DE)"
}
}
}Poll a quick SMS order for the incoming verification code. Read-only. Call every 15-30 seconds after order_sms_verification until status is "received", then relay the code (and full message) to the user. Orders auto-refund if nothing arrives within 20 minutes. Requires a connected agent wallet.
| Argument | Type | Description |
|---|---|---|
| orderId* | string | The Order ID returned by order_sms_verification (also listed by list_sms_orders) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orderId"
],
"properties": {
"orderId": {
"type": "string",
"description": "The Order ID returned by order_sms_verification (also listed by list_sms_orders)"
}
}
}Creates a payment invoice to add funds to the connected prepaid PikaSim Wallet, and returns a payment page link (the human can pay by card with 3D Secure, or crypto) plus per-coin crypto payment details. Accepts Bitcoin, Lightning, Monero, Zcash, USDT, and 50+ altcoins, or card on the payment page. Does not move funds itself; it returns an invoice the user pays externally, and the balance updates once the payment confirms. Use when check_balance is too low to purchase. Minimum deposit is $1 (no prepaid float required). A fully-autonomous agent holding crypto can pay WITHOUT a human: the tool returns native destinations for Lightning, Bitcoin on-chain, USDT (TRC-20/Tron), and Monero — pay the amount to any one of them. Crypto has no fee; card payments add a 2.9% processing fee on top of the credited amount. Balance is prepaid credit for purchases on PikaSim, never expires, and is not redeemable for cash. Requires a connected agent wallet (OAuth or ak_live_ key).
| Argument | Type | Description |
|---|---|---|
| coin | string | Optional. The coin YOU intend to pay with. Lightning, Bitcoin and Monero destinations are always returned; pass USDT-TRON only if you will actually pay in USDT (TRC-20), since those addresses come from a small pool and are allocated on request. |
| amount* | number | Amount in whole US dollars to CREDIT to the wallet (minimum 1; e.g. 25 for a $25 deposit) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"amount"
],
"properties": {
"coin": {
"enum": [
"BTC-LN",
"BTC-CHAIN",
"XMR-CHAIN",
"USDT-TRON"
],
"type": "string",
"description": "Optional. The coin YOU intend to pay with. Lightning, Bitcoin and Monero destinations are always returned; pass USDT-TRON only if you will actually pay in USDT (TRC-20), since those addresses come from a small pool and are allocated on request."
},
"amount": {
"type": "number",
"description": "Amount in whole US dollars to CREDIT to the wallet (minimum 1; e.g. 25 for a $25 deposit)",
"exclusiveMinimum": 0
}
}
}Create a NEW PikaSim agent wallet for autonomous purchasing — no human, no browser, no account, no email, no KYC. Returns a wallet code + an ak_live_ API key + a small spend-only welcome credit (spendable on eSIM data only; SMS verification numbers need a deposit from $1), so you can immediately reconnect with the key (Authorization: Bearer ak_live_…) and buy an eSIM, phone number, or SMS verification number. Use this when the user has NO wallet yet and wants their agent to buy. If the user ALREADY has a wallet, do NOT create a new one — reconnect the existing wallet instead (ask them for it). You accept the Terms of Service (https://pikasim.com/tos) on the user's behalf by passing acceptTos=true.
| Argument | Type | Description |
|---|---|---|
| acceptTos* | boolean | Must be true: confirms the user accepts the PikaSim Terms of Service (https://pikasim.com/tos). Required to create the wallet. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"acceptTos"
],
"properties": {
"acceptTos": {
"type": "boolean",
"description": "Must be true: confirms the user accepts the PikaSim Terms of Service (https://pikasim.com/tos). Required to create the wallet."
}
}
}Extend a long-term SMS rental so the user keeps the same number — days are ADDED on top of the current expiry. This SPENDS the wallet balance at the live tier price (the tool checks the price first and reports what was charged). Valid day options are the same duration tiers the rental was offered at. Extend BEFORE expiry; an expired rental usually cannot be recovered. Requires a connected agent wallet.
| Argument | Type | Description |
|---|---|---|
| days* | number | How many days to add — one of the rental's duration tiers (see list_sms_rentals for this country) |
| receiptId* | string | The rental receipt ID |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"receiptId",
"days"
],
"properties": {
"days": {
"type": "number",
"description": "How many days to add — one of the rental's duration tiers (see list_sms_rentals for this country)"
},
"receiptId": {
"type": "string",
"description": "The rental receipt ID"
}
}
}Fetch full details for one PikaSim eSIM plan by the id returned from search: coverage, data, voice/SMS allowance, duration, price, networks, and its pikasim.com purchase URL. Read-only.
| Argument | Type | Description |
|---|---|---|
| id* | string | The plan id returned by the search tool (the packageCode) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The plan id returned by the search tool (the packageCode)"
}
}
}Returns the live status, remaining/used data, and expiration date for one eSIM you own, looked up by its ICCID. Read-only. Use this after a purchase to track an eSIM, or whenever a user asks "how much data is left" or "is my eSIM active". The ICCID is returned by purchase_esim/purchase_phone_plan and listed by list_orders. Requires a connected agent wallet (OAuth or ak_live_ key).
| Argument | Type | Description |
|---|---|---|
| iccid* | string | The ICCID (the eSIM's unique serial number) returned by purchase_esim, purchase_phone_plan, or list_orders |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"iccid"
],
"properties": {
"iccid": {
"type": "string",
"description": "The ICCID (the eSIM's unique serial number) returned by purchase_esim, purchase_phone_plan, or list_orders"
}
}
}Get full details for a specific plan (data eSIM OR phone-number eSIM): coverage, data, voice/SMS allowance, duration, price, networks, and purchase URL. Accepts the packageCode shown in [brackets] by the search tools.
| Argument | Type | Description |
|---|---|---|
| packageCode* | string | Package code from a search result (e.g., CKH001 for data, change-plus-7days-1gb for a phone plan) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packageCode"
],
"properties": {
"packageCode": {
"type": "string",
"description": "Package code from a search result (e.g., CKH001 for data, change-plus-7days-1gb for a phone plan)"
}
}
}Get the USD price and voice/SMS/data allowance for a specific PHONE-NUMBER eSIM. Accepts the packageCode from search_phone_plans.
| Argument | Type | Description |
|---|---|---|
| currency | string | Currency code (currently only USD supported) |
| packageCode* | string | Phone-plan package code from search_phone_plans (e.g., change-plus-7days-1gb) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packageCode"
],
"properties": {
"currency": {
"type": "string",
"description": "Currency code (currently only USD supported)"
},
"packageCode": {
"type": "string",
"description": "Phone-plan package code from search_phone_plans (e.g., change-plus-7days-1gb)"
}
}
}Get the USD price for a specific plan (data eSIM OR phone-number eSIM). Accepts the packageCode from any search result.
| Argument | Type | Description |
|---|---|---|
| currency | string | Currency code (currently only USD supported) |
| packageCode* | string | Package code (data or phone plan) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packageCode"
],
"properties": {
"currency": {
"type": "string",
"description": "Currency code (currently only USD supported)"
},
"packageCode": {
"type": "string",
"description": "Package code (data or phone plan)"
}
}
}Read the inbox of a long-term SMS rental: all received messages, newest first, plus the number's status and expiry. Read-only; poll it when the user expects a message. The receiptId comes from rent_sms_number or list_sms_orders. Requires a connected agent wallet.
| Argument | Type | Description |
|---|---|---|
| receiptId* | string | The rental receipt ID from rent_sms_number or list_sms_orders |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"receiptId"
],
"properties": {
"receiptId": {
"type": "string",
"description": "The rental receipt ID from rent_sms_number or list_sms_orders"
}
}
}List the countries offering a quick SMS verification number for one service, with live price, delivery success rate, and whether the number is a real mobile (non-VoIP) or VoIP line. Sorted by success rate — prefer high success rates, and prefer non-VoIP when the target service blocks virtual numbers. Returns each countryId in [brackets] for order_sms_verification.
| Argument | Type | Description |
|---|---|---|
| serviceId* | string | The serviceId from search_sms_services (e.g. "395"), or an exact service name |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"serviceId"
],
"properties": {
"serviceId": {
"type": "string",
"description": "The serviceId from search_sms_services (e.g. \"395\"), or an exact service name"
}
}
}List available top-up packages for an existing eSIM, including price and data amount. Use this before topup_esim to find valid package codes. Requires an agent-wallet API key (ak_live_).
| Argument | Type | Description |
|---|---|---|
| iccid* | string | ICCID of the eSIM to get top-up options for |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"iccid"
],
"properties": {
"iccid": {
"type": "string",
"description": "ICCID of the eSIM to get top-up options for"
}
}
}List every eSIM this wallet owns (the fleet view), newest first: ICCID, plan, order status, install link, and — for fleets of up to 8 — live remaining data inline. Read-only. Use this to answer "which eSIMs do I own / how much data is left" without already knowing an ICCID; then get_esim_status for any single eSIM's full detail. eSIMs only — SMS numbers are listed by list_sms_orders. Requires a connected agent wallet.
| Argument | Type | Description |
|---|---|---|
| page | number | 1-based page (50 eSIMs per page) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "number",
"description": "1-based page (50 eSIMs per page)"
}
}
}Returns the order history for the connected wallet, newest first: each order's ID, package, status, cost, date, ICCID, and install link. Read-only and paginated. Use this to find a past purchase, retrieve an ICCID for get_esim_status, or show a user what they have bought. Results are scoped to this wallet only. Requires a connected agent wallet (OAuth or ak_live_ key).
| Argument | Type | Description |
|---|---|---|
| page | number | 1-based page number to retrieve (default 1) |
| limit | number | Number of orders per page (default 20, maximum 50) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "number",
"description": "1-based page number to retrieve (default 1)"
},
"limit": {
"type": "number",
"description": "Number of orders per page (default 20, maximum 50)"
}
}
}List this wallet's SMS orders — quick verification orders (with their Order IDs) and long-term rentals (with their receipt IDs, numbers, and expiry dates). Read-only. Use it to re-find an order ID or check what is still active. Requires a connected agent wallet.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}List long-term SMS RENTAL numbers: keep the same receive-only number for days to months and receive multiple SMS (fair-use 25/day). Shows each country with its rentalId, duration tiers, live prices, and LIVE STOCK per duration — skip tiers marked OUT OF STOCK. US/UK numbers are real mobile (non-VoIP); Canada is VoIP. Not allowed for banking/financial/crypto-exchange verification. Purchase with rent_sms_number.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}The wallet ledger: every debit and credit (deposits, purchases, refunds) with amount, running balance, and description, newest first. Read-only and paginated; filter with type. Use this to reconcile spend or answer "where did the balance go" — check_balance only gives the current number.
| Argument | Type | Description |
|---|---|---|
| page | number | 1-based page (25 transactions per page) |
| type | string | Only show this transaction type |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "number",
"description": "1-based page (25 transactions per page)"
},
"type": {
"enum": [
"deposit",
"order",
"refund"
],
"type": "string",
"description": "Only show this transaction type"
}
}
}Buy a QUICK SMS verification number: returns a temporary phone number the user enters on the target service, then the incoming code is read with check_sms_verification. This SPENDS the wallet balance (typically $0.50-$5). Single-use, valid 20 minutes, auto-refunds if no SMS arrives. Use search_sms_services and get_sms_service_countries first to pick serviceId and countryId. Requires a connected agent wallet.
| Argument | Type | Description |
|---|---|---|
| countryId | string | The countryId from get_sms_service_countries (defaults to United States) |
| requestId | string | Idempotency key: generate a fresh UUID for each NEW order, and reuse the SAME value when retrying after a timeout or transport error — an identical retry returns the original order instead of charging again. Use a NEW id when deliberately ordering another number. |
| serviceId* | string | The serviceId from search_sms_services |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"serviceId"
],
"properties": {
"countryId": {
"type": "string",
"description": "The countryId from get_sms_service_countries (defaults to United States)"
},
"requestId": {
"type": "string",
"description": "Idempotency key: generate a fresh UUID for each NEW order, and reuse the SAME value when retrying after a timeout or transport error — an identical retry returns the original order instead of charging again. Use a NEW id when deliberately ordering another number."
},
"serviceId": {
"type": "string",
"description": "The serviceId from search_sms_services"
}
}
}Purchase a DATA eSIM. Deducts from your prepaid agent wallet and returns order details with activation info (ICCID, QR code, SM-DP+). Use the packageCode from search_esim_packages. For a daily-reset "Unlimited" plan, also pass days (the number of days to buy). For phone-number eSIMs use purchase_phone_plan instead. Requires an agent-wallet API key (ak_live_).
| Argument | Type | Description |
|---|---|---|
| days | integer | ONLY for daily-reset "Unlimited" plans (get_package_details shows "Type: Daily unlimited"): the number of days to purchase. Valid values: 3, 5, 7, 10, 15, 30. Required for those plans, and the total charged is the per-day price times this many days (minus a duration discount). Omit for fixed-data plans. |
| promoCode | string | Optional promo/discount code. Validated server-side; an invalid code rejects the order with the reason (nothing is charged). Only pass a code the user explicitly provided. |
| requestId | string | Idempotency key: generate a fresh UUID for each NEW purchase, and reuse the SAME value when retrying after a timeout or transport error — an identical retry returns the original order instead of charging again. |
| packageCode* | string | The data-eSIM package code shown in [brackets] by search_esim_packages or get_package_details (e.g. P6ZMSDS1G). Phone-plan codes are not valid here; use purchase_phone_plan for those. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packageCode"
],
"properties": {
"days": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "ONLY for daily-reset \"Unlimited\" plans (get_package_details shows \"Type: Daily unlimited\"): the number of days to purchase. Valid values: 3, 5, 7, 10, 15, 30. Required for those plans, and the total charged is the per-day price times this many days (minus a duration discount). Omit for fixed-data plans."
},
"promoCode": {
"type": "string",
"description": "Optional promo/discount code. Validated server-side; an invalid code rejects the order with the reason (nothing is charged). Only pass a code the user explicitly provided."
},
"requestId": {
"type": "string",
"description": "Idempotency key: generate a fresh UUID for each NEW purchase, and reuse the SAME value when retrying after a timeout or transport error — an identical retry returns the original order instead of charging again."
},
"packageCode": {
"type": "string",
"description": "The data-eSIM package code shown in [brackets] by search_esim_packages or get_package_details (e.g. P6ZMSDS1G). Phone-plan codes are not valid here; use purchase_phone_plan for those."
}
}
}Purchase a PHONE-NUMBER eSIM — a plan with a real carrier phone number (voice + SMS + data). Deducts from your prepaid agent wallet and returns order details with activation info (ICCID, QR code, SM-DP+). The real phone number is assigned by the carrier when the eSIM registers on the network and appears in the device settings after activation. Use the packageCode from search_phone_plans. Plans whose search result says "designated-date activation" REQUIRE activationDate. Requires an agent-wallet API key (ak_live_).
| Argument | Type | Description |
|---|---|---|
| promoCode | string | Optional promo/discount code. Validated server-side; an invalid code rejects the order with the reason (nothing is charged). Only pass a code the user explicitly provided. |
| requestId | string | Idempotency key: generate a fresh UUID for each NEW purchase, and reuse the SAME value when retrying after a timeout or transport error — an identical retry returns the original order instead of charging again. |
| packageCode* | string | Phone-plan package code (use search_phone_plans to find codes, e.g., change-plus-7days-1gb) |
| activationDate | string | Activation date in YYYY-MM-DD — ONLY for plans marked "designated-date activation" in search results (e.g. the Australia phone plan), where it is REQUIRED and must be at least 2 and at most 60 days from today. Ask the user for their service start date. Omit for all other plans. |
Rent a LONG-TERM receive-only SMS number: the user keeps the same number for the whole rental and can receive multiple SMS (fair-use 25/day). This SPENDS the wallet balance. Use list_sms_rentals first for rentalId, valid day tiers, prices, and live stock (do not order an OUT OF STOCK tier). Extendable before expiry with extend_sms_rental, and cancellable for a full refund with cancel_sms_rental within 2 hours if no messages arrived. Not allowed for banking/financial/crypto-exchange verification. Requires a connected agent wallet.
| Argument | Type | Description |
|---|---|---|
| days* | number | Rental duration in days — must be one of the duration tiers list_sms_rentals shows for this rentalId |
| rentalId* | string | The rentalId from list_sms_rentals (e.g. 11 for United States) |
| requestId | string | Idempotency key: generate a fresh UUID for each NEW rental, and reuse the SAME value when retrying after a timeout or transport error — an identical retry returns the original rental instead of charging again. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"rentalId",
"days"
],
"properties": {
"days": {
"type": "number",
"description": "Rental duration in days — must be one of the duration tiers list_sms_rentals shows for this rentalId"
},
"rentalId": {
"type": "string",
"description": "The rentalId from list_sms_rentals (e.g. 11 for United States)"
},
"requestId": {
"type": "string",
"description": "Idempotency key: generate a fresh UUID for each NEW rental, and reuse the SAME value when retrying after a timeout or transport error — an identical retry returns the original rental instead of charging again."
}
}
}Search the PikaSim eSIM catalog (data eSIMs and phone-number eSIMs) by free-text query and/or ISO country code. Returns a list of matching plans, each with an id, a title (name + price), and a pikasim.com URL. Pass an id to the fetch tool for full details. Read-only.
| Argument | Type | Description |
|---|---|---|
| query* | string | Free-text search, may include a country name and/or ISO 3166-1 alpha-2 code (e.g. "Japan 10GB", "US phone plan", "DE") |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Free-text search, may include a country name and/or ISO 3166-1 alpha-2 code (e.g. \"Japan 10GB\", \"US phone plan\", \"DE\")"
}
}
}Search PikaSim eSIM plans by country code, region, or keyword. Returns BOTH product lines in separate buckets: DATA eSIMs and PHONE-NUMBER eSIMs (real carrier number + voice + SMS). Each result shows its packageCode in [brackets] for purchasing. Use type to narrow to one line.
| Argument | Type | Description |
|---|---|---|
| type | string | Which product line to return: "data" (data-only eSIMs), "phone" (phone-number eSIMs with voice+SMS), or "all" (both, default) |
| query | string | Search keyword (e.g., "Japan 10GB") |
| region | string | Region name (e.g., Europe, Asia, Global) |
| country | string | ISO 3166-1 alpha-2 country code (e.g., JP, US, DE) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"type": {
"enum": [
"data",
"phone",
"all"
],
"type": "string",
"description": "Which product line to return: \"data\" (data-only eSIMs), \"phone\" (phone-number eSIMs with voice+SMS), or \"all\" (both, default)"
},
"query": {
"type": "string",
"description": "Search keyword (e.g., \"Japan 10GB\")"
},
"region": {
"type": "string",
"description": "Region name (e.g., Europe, Asia, Global)"
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code (e.g., JP, US, DE)"
}
}
}Search PikaSim PHONE-NUMBER eSIMs — plans that include a REAL carrier phone number (not VoIP) with voice calls, SMS, and data. US plans give a real +1 number on AT&T and T-Mobile; local country plans cover Europe (French +33 number), Australia, Mongolia, Vietnam, and Maldives; global plans cover 160+ countries. Use this when a user wants to call or text, not just data. Each result shows its packageCode in [brackets] for purchase_phone_plan.
| Argument | Type | Description |
|---|---|---|
| query | string | Search keyword (e.g., "US 5GB") |
| region | string | Region name (e.g., Global) |
| country | string | ISO 3166-1 alpha-2 country code (e.g., US for a real +1 number) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "string",
"description": "Search keyword (e.g., \"US 5GB\")"
},
"region": {
"type": "string",
"description": "Region name (e.g., Global)"
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code (e.g., US for a real +1 number)"
}
}
}Search the SMS VERIFICATION service list — websites/apps a receive-only verification number can get a code for (Discord, Google, Telegram, ...). This is the SMS product line (no eSIM, nothing to install): the user gets a temporary phone number and reads the incoming code. Returns service names with their serviceId in [brackets]. If the target service is not listed, search "Other" — the catch-all works for any site. Next step: get_sms_service_countries.
| Argument | Type | Description |
|---|---|---|
| query | string | Service name to search for (e.g. "Discord", "Google", "Tinder"). Omit to list the most popular services. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "string",
"description": "Service name to search for (e.g. \"Discord\", \"Google\", \"Tinder\"). Omit to list the most popular services."
}
}
}Adds more data (and on some plans voice/SMS) to an existing eSIM the user already owns, without issuing a new eSIM. This SPENDS the wallet balance and cannot be undone. First call get_topup_options with the same ICCID to get valid top-up package codes and prices, then pass one here. Use when a user wants to extend an eSIM that is running low rather than buy a new one. Requires a connected agent wallet (OAuth or ak_live_ key).
| Argument | Type | Description |
|---|---|---|
| iccid* | string | The ICCID of the eSIM to top up (from list_orders or a prior purchase) |
| promoCode | string | Optional promo/discount code. Validated server-side; an invalid code rejects the top-up with the reason (nothing is charged). Only pass a code the user explicitly provided. |
| packageCode* | string | A top-up package code returned by get_topup_options for this ICCID (top-up codes differ from new-purchase codes) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"iccid",
"packageCode"
],
"properties": {
"iccid": {
"type": "string",
"description": "The ICCID of the eSIM to top up (from list_orders or a prior purchase)"
},
"promoCode": {
"type": "string",
"description": "Optional promo/discount code. Validated server-side; an invalid code rejects the top-up with the reason (nothing is charged). Only pass a code the user explicitly provided."
},
"packageCode": {
"type": "string",
"description": "A top-up package code returned by get_topup_options for this ICCID (top-up codes differ from new-purchase codes)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packageCode"
],
"properties": {
"promoCode": {
"type": "string",
"description": "Optional promo/discount code. Validated server-side; an invalid code rejects the order with the reason (nothing is charged). Only pass a code the user explicitly provided."
},
"requestId": {
"type": "string",
"description": "Idempotency key: generate a fresh UUID for each NEW purchase, and reuse the SAME value when retrying after a timeout or transport error — an identical retry returns the original order instead of charging again."
},
"packageCode": {
"type": "string",
"description": "Phone-plan package code (use search_phone_plans to find codes, e.g., change-plus-7days-1gb)"
},
"activationDate": {
"type": "string",
"description": "Activation date in YYYY-MM-DD — ONLY for plans marked \"designated-date activation\" in search results (e.g. the Australia phone plan), where it is REQUIRED and must be at least 2 and at most 60 days from today. Ask the user for their service start date. Omit for all other plans."
}
}
}