com.buyukesim/mcp

Check the balance of the agent wallet (pass the ak_live_ api key from create_wallet). Returns available USD balance.

Look up the status of a BuyUKeSIM order using its short lookup/magic code (the code the customer received). Returns only the order status - no personal data, no QR.

Check whether the UK +44 number has been reported working in a country, from buyers who told us after using it there. Pass a 2-letter ISO country code. Returns how many reports exist and how many said it worked, and says plainly when there are none - an absent country means no evidence either way, not a failure. This is evidence, not a promise: roaming depends on the local network. Read-only.

Top up the agent wallet with crypto (pass the ak_live_ api key from create_wallet). Returns a crypto payment address and amount; the balance is credited automatically once the payment confirms on-chain. Minimum $100.

Create a new BuyUKeSIM agent wallet - a prepaid, no-KYC balance an AI agent funds with crypto and spends on eSIMs. Returns an api_key (ak_live_...) and a wallet_code. Save both: pass the api_key as the api_key argument on the wallet tools; the wallet_code lets a human sign back in. Balance can only be spent on eSIMs, never withdrawn.

Describe the UK Number + Travel eSIM bundle: both products in ONE crypto checkout, delivered as TWO QR codes and opened with one order code. Use it when someone wants a +44 number for verification codes AND mobile data for a trip, so they are not told to make two separate purchases. Read-only; the bundle is bought on the website.

Where a BuyUKeSIM travel data eSIM reaches the public internet, per destination. A travel eSIM roams, so the data session is usually tunnelled to the sponsoring operator gateway and a website sees THAT country, not the country the plan is named after (a Germany plan can break out in France, the Netherlands or the UK). Returns the exit country and plan count for every destination, regenerated from the live catalogue on each site build. Use this for "what IP country will my eSIM show", "will my bank app see me in X", and geo-blocking questions. An exit country changes what a site sees, not who the user is. Read-only.

One-Time Codes are PAUSED and cannot be bought; this only works for orders placed before the pause. Poll a purchased One-Time Code order for its SMS code. Returns the phone number and, once it arrives, the verification code. Call repeatedly (every few seconds) until phase is code_ready or failed. Pass the ak_live_ api key and the order_id from purchase_one_time_code.

How long a crypto payment actually takes at BuyUKeSIM and what happens after it confirms. Returns measured confirmation times per coin (median, worst case, share confirmed within two minutes) taken from real orders against public blockchain block timestamps, plus the send delay buyers themselves add, plus how delivery works: it is automatic, triggered by the confirmation, with no human approval step. Use this for "how long does it take", "which coin is fastest", "is delivery instant" and "does someone have to approve my order". Read-only.

Get details of the BuyUKeSIM UK Number (+44) eSIM: a real UK mobile line for unlimited incoming SMS and calls (app and service verification codes, WhatsApp, Telegram), no KYC, paid in crypto, instant QR. This is distinct from the travel data eSIM.

Fetch a VPN client configuration for one server on a VPN order. Needs the order_id and its short lookup/magic code (both returned by purchase_vpn), a protocol (wireguard, openvpn or vless) and a server_id from list_vpn_plans. Returns the config file text, ready to import into any standard client. No wallet key needed - the order code is the credential. Call it again for another server or protocol; there is no limit.

List the countries/regions BuyUKeSIM travel eSIM data plans currently cover, with how many plans each has (2-letter ISO codes).

List the extra data packages that can be loaded onto a travel eSIM this wallet already bought, so it keeps working instead of being replaced. Pass the order_id from purchase_esim and the ak_live_ key. The offer is per eSIM and live, so call this rather than reusing codes from search_esim_plans - those are for NEW eSIMs and will not work here. Read-only: it spends nothing.

List One-Time Code services: apps for which BuyUKeSIM can supply a disposable number that receives a single SMS verification code (WhatsApp, Telegram, Google, Discord and more), each with a few high-success-rate countries and a live reliability %. Flat $6.99, paid from the wallet, no account. Read-only (no wallet needed). Call this before purchase_one_time_code.

Read real customer reviews of BuyUKeSIM, newest first, with the overall rating and how many there are. Reviews are published unmoderated: nothing approves one before it appears, and the buyer country shown on each card comes from the sale, so a low rating is as likely to appear as a high one. Where the shop has answered a review in public, that answer is included under it. Use this when you are deciding whether to recommend the shop, or when a user asks what buyers say. Read-only.

List the most recent transactions (deposits and purchases) on the agent wallet. Pass the ak_live_ api key from create_wallet.

List the BuyUKeSIM VPN access plans (7/15/30/90/180/365 days, USD price) and the server countries currently available, with protocols (WireGuard, OpenVPN, VLESS). VPN access, no account, paid in crypto. Read-only; buy a plan with purchase_vpn.

Buy a travel/data eSIM using the agent wallet balance (pass the ak_live_ api key from create_wallet). Deducts the plan price from the balance and returns the eSIM QR code instantly. Get a package_code from search_esim_plans first. Pass a stable request_id to make retries safe (no double charge). This provisions a real eSIM - only call it when the user has confirmed the purchase.

Add more data to a travel eSIM this wallet already bought, paid from the balance. The data lands on the profile the user already installed: same QR, same ICCID, nothing to install again, so there is no new eSIM and nothing to scan. Use this when someone runs out of data mid-trip or needs longer than one plan - buying a second eSIM instead means a second profile to install. Get package_code from list_esim_topups. An eSIM takes 10 top-ups in total. Pass request_id for safe retries. This spends real balance - only call it once the user has confirmed.

Buy a One-Time Code (a private, single-use number that receives one SMS verification code) using the agent wallet balance. Deducts $6.99, reserves a number, and returns the phone number + order_id. Then call get_one_time_code to read the code as it arrives. If no code ever arrives, the wallet is auto-refunded. Get service + country from list_one_time_code_services. Pass request_id for safe retries. Only call once the user has confirmed.

Buy a UK +44 Number eSIM (a real UK mobile line for incoming verification SMS and calls) using the agent wallet balance. Deducts about $25 and delivers a QR from stock instantly. Pass the ak_live_ api key from create_wallet. Pass request_id for safe retries. This delivers a real eSIM - only call it once the user has confirmed.

Buy VPN access using the agent wallet balance. Deducts the plan price and returns the username, password and expiry instantly. plan is one of 7d, 15d, 30d, 90d, 180d, 365d - call list_vpn_plans first for the current prices and server countries. One payment, no auto-renewal, no account. Configs are fetched afterwards with get_vpn_config, or from the order page. Pass request_id for safe retries. This spends real balance - only call it once the user has confirmed. Not an eSIM: it carries no phone number and no mobile data.

Search BuyUKeSIM travel/data eSIM plans for a country. Returns plan name, data amount, validity days, USD price, and package code. Pass a 2-letter ISO country code (e.g. GB, US, TR, JP). Omit country to get popular/featured plans.