Pikasim

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.

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

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.

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

Get the USD price for a specific plan (data eSIM OR phone-number eSIM). Accepts the packageCode from any search result.

Get the USD price and voice/SMS/data allowance for a specific PHONE-NUMBER eSIM. Accepts the packageCode from search_phone_plans.

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.

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.

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

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.

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

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

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

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

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

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.

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.

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

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

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.