PikaSim

Official31 toolsLive

by codebruinc · Dockerfile

Anonymous eSIMs, phone numbers, and SMS codes in 190+ countries. Crypto-paid; agents self-onboard.

PikaSim MCP Server (com.pikasim/pikasim)

This Model Context Protocol (MCP) server provides remote, hosted access to anonymous eSIMs, phone numbers, and SMS codes across 190+ countries. It is described as a Streamable HTTP service. The server supports browsing plan and pricing details and, when authorized, purchasing eSIMs and SMS numbers autonomously.

🛠️ Key Features

Anonymous eSIMs and anonymous data plans
Real carrier phone numbers
SMS verification numbers
Remote, hosted MCP server (Streamable HTTP)
31 tools (toolCount)

🚀 Use Cases

Search eSIM plans, check pricing, and coverage
Purchase eSIMs and SMS numbers autonomously
Use crypto settlement from a prepaid agent wallet

⚡ Developer Benefits

No local code to run; use the MCP URL
Browse endpoint available without auth
OAuth purchase endpoint for autonomous buying

⚠️ Limitations

Purchase requires OAuth and a funded agent wallet; browsing is stated as “no auth”

Topics

ai-agentsanthropicclaudecryptoesimllm-toolsmcpmcp-servermodel-context-protocol

Captured live from the server via tools/list.

search_esim_packages

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.

Parameters4

country	string	optional	ISO 3166-1 alpha-2 country code (e.g., JP, US, DE)
region	string	optional	Region name (e.g., Europe, Asia, Global)
query	string	optional	Search keyword (e.g., "Japan 10GB")
type	string	optional	Which product line to return: "data" (data-only eSIMs), "phone" (phone-number eSIMs with voice+SMS), or "all" (both, default)

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "ISO 3166-1 alpha-2 country code (e.g., JP, US, DE)",
      "type": "string"
    },
    "region": {
      "description": "Region name (e.g., Europe, Asia, Global)",
      "type": "string"
    },
    "query": {
      "description": "Search keyword (e.g., \"Japan 10GB\")",
      "type": "string"
    },
    "type": {
      "description": "Which product line to return: \"data\" (data-only eSIMs), \"phone\" (phone-number eSIMs with voice+SMS), or \"all\" (both, default)",
      "type": "string",
      "enum": [
        "data",
        "phone",
        "all"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_phone_plans

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.

Parameters3

country	string	optional	ISO 3166-1 alpha-2 country code (e.g., US for a real +1 number)
region	string	optional	Region name (e.g., Global)
query	string	optional	Search keyword (e.g., "US 5GB")

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "ISO 3166-1 alpha-2 country code (e.g., US for a real +1 number)",
      "type": "string"
    },
    "region": {
      "description": "Region name (e.g., Global)",
      "type": "string"
    },
    "query": {
      "description": "Search keyword (e.g., \"US 5GB\")",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_package_details

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.

Parameters1

packageCode

string

required

Package code from a search result (e.g., CKH001 for data, change-plus-7days-1gb for a phone plan)

Raw schema

{
  "type": "object",
  "properties": {
    "packageCode": {
      "type": "string",
      "description": "Package code from a search result (e.g., CKH001 for data, change-plus-7days-1gb for a phone plan)"
    }
  },
  "required": [
    "packageCode"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_country_coverage

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

Parameters1

country

string

required

ISO 3166-1 alpha-2 country code (e.g., JP, US, DE)

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code (e.g., JP, US, DE)"
    }
  },
  "required": [
    "country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_pricing

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

Parameters2

packageCode	string	required	Package code (data or phone plan)
currency	string	optional	Currency code (currently only USD supported)

Raw schema

{
  "type": "object",
  "properties": {
    "packageCode": {
      "type": "string",
      "description": "Package code (data or phone plan)"
    },
    "currency": {
      "description": "Currency code (currently only USD supported)",
      "type": "string"
    }
  },
  "required": [
    "packageCode"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_phone_plan_pricing

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

Parameters2

packageCode	string	required	Phone-plan package code from search_phone_plans (e.g., change-plus-7days-1gb)
currency	string	optional	Currency code (currently only USD supported)

Raw schema

{
  "type": "object",
  "properties": {
    "packageCode": {
      "type": "string",
      "description": "Phone-plan package code from search_phone_plans (e.g., change-plus-7days-1gb)"
    },
    "currency": {
      "description": "Currency code (currently only USD supported)",
      "type": "string"
    }
  },
  "required": [
    "packageCode"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search

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.

Parameters1

query

string

required

Free-text search, may include a country name and/or ISO 3166-1 alpha-2 code (e.g. "Japan 10GB", "US phone plan", "DE")

Raw schema

{
  "type": "object",
  "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\")"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

fetch

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.

Parameters1

string

required

The plan id returned by the search tool (the packageCode)

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The plan id returned by the search tool (the packageCode)"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_wallet

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.

Parameters1

acceptTos

boolean

required

Must be true: confirms the user accepts the PikaSim Terms of Service (https://pikasim.com/tos). Required to create the wallet.

Raw schema

{
  "type": "object",
  "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."
    }
  },
  "required": [
    "acceptTos"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_balance

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

purchase_esim

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

Parameters4

packageCode	string	required	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.
days	integer	optional	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.
requestId	string	optional	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.
promoCode	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "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."
    },
    "days": {
      "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.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "requestId": {
      "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.",
      "type": "string"
    },
    "promoCode": {
      "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.",
      "type": "string"
    }
  },
  "required": [
    "packageCode"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

purchase_phone_plan

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

Parameters4

packageCode	string	required	Phone-plan package code (use search_phone_plans to find codes, e.g., change-plus-7days-1gb)
activationDate	string	optional	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.
requestId	string	optional	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.
promoCode	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "packageCode": {
      "type": "string",
      "description": "Phone-plan package code (use search_phone_plans to find codes, e.g., change-plus-7days-1gb)"
    },
    "activationDate": {
      "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.",
      "type": "string"
    },
    "requestId": {
      "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.",
      "type": "string"
    },
    "promoCode": {
      "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.",
      "type": "string"
    }
  },
  "required": [
    "packageCode"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_esim_status

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

Parameters1

iccid

string

required

The ICCID (the eSIM's unique serial number) returned by purchase_esim, purchase_phone_plan, or list_orders

Raw schema

{
  "type": "object",
  "properties": {
    "iccid": {
      "type": "string",
      "description": "The ICCID (the eSIM's unique serial number) returned by purchase_esim, purchase_phone_plan, or list_orders"
    }
  },
  "required": [
    "iccid"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

topup_esim

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

Parameters3

iccid	string	required	The ICCID of the eSIM to top up (from list_orders or a prior purchase)
packageCode	string	required	A top-up package code returned by get_topup_options for this ICCID (top-up codes differ from new-purchase codes)
promoCode	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "iccid": {
      "type": "string",
      "description": "The ICCID of the eSIM to top up (from list_orders or a prior purchase)"
    },
    "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)"
    },
    "promoCode": {
      "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.",
      "type": "string"
    }
  },
  "required": [
    "iccid",
    "packageCode"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_orders

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

Parameters2

page	number	optional	1-based page number to retrieve (default 1)
limit	number	optional	Number of orders per page (default 20, maximum 50)

Raw schema

{
  "type": "object",
  "properties": {
    "page": {
      "description": "1-based page number to retrieve (default 1)",
      "type": "number"
    },
    "limit": {
      "description": "Number of orders per page (default 20, maximum 50)",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_esims

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.

Parameters1

page

number

optional

1-based page (50 eSIMs per page)

Raw schema

{
  "type": "object",
  "properties": {
    "page": {
      "description": "1-based page (50 eSIMs per page)",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_transactions

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.

Parameters2

page	number	optional	1-based page (25 transactions per page)
type	string	optional	Only show this transaction type

Raw schema

{
  "type": "object",
  "properties": {
    "page": {
      "description": "1-based page (25 transactions per page)",
      "type": "number"
    },
    "type": {
      "description": "Only show this transaction type",
      "type": "string",
      "enum": [
        "deposit",
        "order",
        "refund"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_deposit

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

Parameters1

amount

number

required

Amount in whole US dollars to CREDIT to the wallet (minimum 1; e.g. 25 for a $25 deposit)

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Amount in whole US dollars to CREDIT to the wallet (minimum 1; e.g. 25 for a $25 deposit)"
    }
  },
  "required": [
    "amount"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_topup_options

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

Parameters1

iccid

string

required

ICCID of the eSIM to get top-up options for

Raw schema

{
  "type": "object",
  "properties": {
    "iccid": {
      "type": "string",
      "description": "ICCID of the eSIM to get top-up options for"
    }
  },
  "required": [
    "iccid"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

cancel_esim

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

Parameters1

iccid

string

required

ICCID of the eSIM to cancel

Raw schema

{
  "type": "object",
  "properties": {
    "iccid": {
      "type": "string",
      "description": "ICCID of the eSIM to cancel"
    }
  },
  "required": [
    "iccid"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_sms_services

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.

Parameters1

query

string

optional

Service name to search for (e.g. "Discord", "Google", "Tinder"). Omit to list the most popular services.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Service name to search for (e.g. \"Discord\", \"Google\", \"Tinder\"). Omit to list the most popular services.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

serviceId

string

required

The serviceId from search_sms_services (e.g. "395"), or an exact service name

Raw schema

{
  "type": "object",
  "properties": {
    "serviceId": {
      "type": "string",
      "description": "The serviceId from search_sms_services (e.g. \"395\"), or an exact service name"
    }
  },
  "required": [
    "serviceId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_sms_rentals

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

order_sms_verification

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.

Parameters3

serviceId	string	required	The serviceId from search_sms_services
countryId	string	optional	The countryId from get_sms_service_countries (defaults to United States)
requestId	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "serviceId": {
      "type": "string",
      "description": "The serviceId from search_sms_services"
    },
    "countryId": {
      "description": "The countryId from get_sms_service_countries (defaults to United States)",
      "type": "string"
    },
    "requestId": {
      "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.",
      "type": "string"
    }
  },
  "required": [
    "serviceId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_sms_verification

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.

Parameters1

orderId

string

required

The Order ID returned by order_sms_verification (also listed by list_sms_orders)

Raw schema

{
  "type": "object",
  "properties": {
    "orderId": {
      "type": "string",
      "description": "The Order ID returned by order_sms_verification (also listed by list_sms_orders)"
    }
  },
  "required": [
    "orderId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

cancel_sms_verification

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.

Parameters1

orderId

string

required

The Order ID of the waiting quick SMS order

Raw schema

{
  "type": "object",
  "properties": {
    "orderId": {
      "type": "string",
      "description": "The Order ID of the waiting quick SMS order"
    }
  },
  "required": [
    "orderId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_sms_orders

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rent_sms_number

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.

Parameters3

rentalId	string	required	The rentalId from list_sms_rentals (e.g. 11 for United States)
days	number	required	Rental duration in days — must be one of the duration tiers list_sms_rentals shows for this rentalId
requestId	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "rentalId": {
      "type": "string",
      "description": "The rentalId from list_sms_rentals (e.g. 11 for United States)"
    },
    "days": {
      "type": "number",
      "description": "Rental duration in days — must be one of the duration tiers list_sms_rentals shows for this rentalId"
    },
    "requestId": {
      "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.",
      "type": "string"
    }
  },
  "required": [
    "rentalId",
    "days"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_sms_rental_messages

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.

Parameters1

receiptId

string

required

The rental receipt ID from rent_sms_number or list_sms_orders

Raw schema

{
  "type": "object",
  "properties": {
    "receiptId": {
      "type": "string",
      "description": "The rental receipt ID from rent_sms_number or list_sms_orders"
    }
  },
  "required": [
    "receiptId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

extend_sms_rental

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.

Parameters2

receiptId	string	required	The rental receipt ID
days	number	required	How many days to add — one of the rental's duration tiers (see list_sms_rentals for this country)

Raw schema

{
  "type": "object",
  "properties": {
    "receiptId": {
      "type": "string",
      "description": "The rental receipt ID"
    },
    "days": {
      "type": "number",
      "description": "How many days to add — one of the rental's duration tiers (see list_sms_rentals for this country)"
    }
  },
  "required": [
    "receiptId",
    "days"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

cancel_sms_rental

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.

Parameters1

receiptId

string

required

The rental receipt ID from rent_sms_number or list_sms_orders

Raw schema

{
  "type": "object",
  "properties": {
    "receiptId": {
      "type": "string",
      "description": "The rental receipt ID from rent_sms_number or list_sms_orders"
    }
  },
  "required": [
    "receiptId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md13 KBView on GitHub

PikaSim MCP Server

Buy eSIMs from an AI agent — no account, no email, no KYC. Anonymous data plans, real carrier phone numbers, and SMS verification numbers across 190+ countries, settled in crypto from a prepaid agent wallet.

PikaSim is a remote, hosted MCP server (Streamable HTTP). You don't run any code — just point your AI agent at the URL and it can search plans, check coverage, get pricing, and (with a funded agent wallet) purchase eSIMs and SMS numbers autonomously.

Browse (no auth): https://pikasim.com/mcp
Purchase (OAuth): https://pikasim.com/mcp/wallet
Transport: Streamable HTTP (JSON-RPC over HTTP POST)
Docs: https://pikasim.com/mcp-docs?utm_source=github_pikasim_mcp
Agent wallet: https://pikasim.com/agent-wallet?utm_source=github_pikasim_mcp
Browsing needs no key. Purchasing connects a prepaid agent wallet via one-click OAuth (or an ak_live_ key on CLI clients).

Install as an agent skill

This repo also ships a pikasim agent skill — an installable instruction package that teaches any skill-capable agent (Claude Code, claude.ai, and other SKILL.md-compatible hosts) when and how to buy connectivity from PikaSim, including the no-MCP REST fallback and the cold-start wallet flow:

bash

npx skills add codebruinc/pikasim-mcp

or copy skills/pikasim/ into your agent's skills directory (e.g. ~/.claude/skills/pikasim/).

Quick start

Add PikaSim to your AI agent's MCP config:

json

{
  "mcpServers": {
    "pikasim": {
      "type": "streamable-http",
      "url": "https://pikasim.com/mcp"
    }
  }
}

That's it — your agent can now search data and phone-number eSIM plans, check country coverage, and get pricing for 190+ countries. No API key needed for browsing.

To purchase too, connect https://pikasim.com/mcp/wallet instead — it triggers a one-click OAuth flow where you authorize a free, prepaid agent wallet by pasting your wallet code (no key handling, no account, no email). See Authentication.

Fully autonomous: from zero to buying, no human

A terminal or headless agent (Claude Code, a script, an autonomous loop) needs no browser and no person. Connect the keyless https://pikasim.com/mcp and onboard in four calls:

jsonc

// 1. The agent creates its own wallet — returns a wallet code, an ak_live_ key,
//    and a small spend-only welcome credit. No account, email, KYC, or browser.
{ "tool": "create_wallet", "arguments": { "acceptTos": true } }

// 2. Reconnect with the returned key:  Authorization: Bearer ak_live_...
//    (or use the URL https://pikasim.com/mcp/ak_live_YOUR_KEY)

// 3. Confirm the welcome credit is there
{ "tool": "check_balance", "arguments": {} }          // -> $1.00

// 4. Buy — the welcome credit covers a first eSIM data plan (from $0.75); SMS numbers need a $1 deposit
{ "tool": "order_sms_verification", "arguments": { "serviceId": "817", "countryId": "2" } }

That's the whole loop: no human, no browser, no card, no account. When the agent needs more funds, create_deposit returns Lightning, USDT, Monero, and Bitcoin destinations it can pay itself. Save the wallet code and key from the create_wallet response — each is shown once.

Three product lines

Don't assume "eSIM" means data-only. PikaSim sells:

Data eSIMs — anonymous data plans across 190+ countries, from $0.75. Discover with search_esim_packages / check_country_coverage; buy with purchase_esim.
Phone-number eSIMs — 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; global plans cover 157 countries. Discover with search_phone_plans; buy with purchase_phone_plan.
SMS verification numbers — receive-only numbers for getting verification codes, no eSIM involved. Quick SMS: a one-time code on a temporary number, auto-refund if nothing arrives in 20 minutes (search_sms_services → get_sms_service_countries → order_sms_verification → poll check_sms_verification). Long-term rentals: keep a number for days to months and receive multiple SMS, with live stock shown per duration (list_sms_rentals → rent_sms_number → get_sms_rental_messages / extend_sms_rental).

search_esim_packages and check_country_coverage return both eSIM lines in separate buckets. Package codes appear in [brackets] — pass them to the matching purchase tool.

Setup guides

PikaSim is a remote MCP server at https://pikasim.com/mcp. The config key and steps differ per client.

Claude Desktop

Remote servers are added as Connectors, not via claude_desktop_config.json. Go to Settings → Connectors → Add custom connector. To browse, paste https://pikasim.com/mcp. To purchase, paste https://pikasim.com/mcp/wallet and click Connect — Claude opens a PikaSim page where you authorize a wallet by pasting your wallet code (one-click OAuth, no key in the URL).

Claude Code (CLI)

bash

# Browse only (also lets the agent self-onboard via the create_wallet tool)
claude mcp add --transport http pikasim https://pikasim.com/mcp

# With purchasing via key (recommended for headless/terminal agents)
claude mcp add --transport http pikasim https://pikasim.com/mcp \
  --header "Authorization: Bearer ak_live_YOUR_KEY"

# With purchasing via OAuth: add the wallet URL, then run /mcp inside Claude
# Code and pick "Authenticate" — a browser opens the PikaSim consent page
# where you paste your wallet code
claude mcp add --transport http pikasim https://pikasim.com/mcp/wallet

No wallet yet? Connect the browse URL above and ask the agent to call create_wallet — it mints a wallet + ak_live_ key + welcome credit in one call, then reconnect with the key (--header "Authorization: Bearer ak_live_…"). Fully autonomous, no browser. See Fully autonomous.

Cursor / Windsurf / other JSON-config clients

json

{
  "mcpServers": {
    "pikasim": {
      "type": "streamable-http",
      "url": "https://pikasim.com/mcp"
    }
  }
}

To purchase from clients that support MCP OAuth (Cursor does), use https://pikasim.com/mcp/wallet as the URL instead — the client opens the PikaSim consent page where you paste your wallet code.

ChatGPT (custom connector)

Add a custom connector with URL https://pikasim.com/mcp to browse, or https://pikasim.com/mcp/wallet to purchase (the wallet URL triggers OAuth — authorize by pasting your wallet code).

Tools

Public tools (no API key)

Tool	Description
`create_wallet`	Onboard autonomously. Create a new prepaid wallet in one call — returns a wallet code, an `ak_live_` API key, and a spend-only welcome credit. No account, email, KYC, or browser. Reconnect with the key and buy.
`search_esim_packages`	Search eSIM plans by country, region, or keyword. Returns both data and phone-number buckets.
`search_phone_plans`	Search phone-number eSIMs (real carrier number + voice + SMS + data).
`get_package_details`	Full details for a plan: coverage, data, voice/SMS allowance, duration, price, networks, purchase URL.
`check_country_coverage`	What PikaSim plans cover a country — data and phone-number buckets with counts and price ranges.
`get_pricing`	USD price for a specific plan (data or phone-number) by `packageCode`.
`get_phone_plan_pricing`	USD price + voice/SMS/data allowance for a specific phone-number eSIM.
`search_sms_services`	Search SMS verification services (Discord, Google, Telegram, … or "Other" for anything unlisted).
`get_sms_service_countries`	Countries offering a quick SMS number for one service, with live price, success rate, and VoIP vs real-mobile flag.
`list_sms_rentals`	Long-term SMS rental numbers with duration tiers, live prices, and live stock per duration.

Authenticated tools (require an `ak_live_` agent-wallet key)

Tool	Description
`check_balance`	Check your agent-wallet balance.
`purchase_esim`	Buy a data eSIM. Returns activation info (ICCID, QR, SM-DP+).
`purchase_phone_plan`	Buy a phone-number eSIM (real number + voice + SMS + data).
`get_esim_status`	Live status, data usage, and expiration of an eSIM.
`get_topup_options`	List valid top-up packages for an existing eSIM.
`topup_esim`	Add more data to an existing eSIM.
`list_orders`	List recent orders with status and cost.
`list_esims`	Fleet view: every eSIM the wallet owns (ICCID, plan, status, install link, remaining data for small fleets).
`list_transactions`	Wallet ledger: every deposit, purchase, and refund with running balance.
`create_deposit`	Fund your wallet (min $1). Returns agent-payable Lightning, USDT (TRC-20), Monero, and Bitcoin destinations inline so an agent holding crypto pays with no human, plus a payment page (card + 50+ altcoins) for a human.
`cancel_esim`	Cancel an unused eSIM and refund to your wallet (only if never installed/activated).
`order_sms_verification`	Buy a quick SMS number for one verification code (single-use, 20 min, auto-refund if no SMS).
`check_sms_verification`	Poll a quick SMS order for the incoming code.
`cancel_sms_verification`	Cancel a waiting quick SMS order for an immediate refund.
`list_sms_orders`	List your quick SMS orders and rental numbers.
`rent_sms_number`	Rent a long-term receive-only SMS number (extendable; not for banking/financial verification).
`get_sms_rental_messages`	Read a rental number's inbox.
`extend_sms_rental`	Extend a rental before expiry — days are added on top of the current expiry.

Authentication

Browsing is open at https://pikasim.com/mcp. To purchase, connect https://pikasim.com/mcp/wallet, which supports two auth methods:

OAuth (recommended, for app clients like Claude Desktop / ChatGPT): connecting the wallet URL triggers OAuth 2.1 (Dynamic Client Registration + PKCE). You're sent to a PikaSim consent page where you paste your wallet code to authorize. The client receives a revocable access token — never your wallet code or ak_live_ key. No account, no email, no KYC.
Bearer key (for CLI clients): send Authorization: Bearer ak_live_YOUR_KEY.

The plain https://pikasim.com/mcp URL is browse-only — but the create_wallet tool works there, so an agent can mint its own wallet + key + welcome credit with no browser (see Fully autonomous). A human can instead create a wallet at https://pikasim.com/agent-wallet?utm_source=github_pikasim_mcp (save the wallet code; it's the only way back in).

Wallet, in brief

Prepaid, crypto-funded balance. Retail pricing. Minimum deposit $1 — and new wallets carry a small spend-only welcome credit, so a first eSIM data plan (from $0.75) needs no deposit at all. SMS verification numbers always need a deposit.
Fund via create_deposit — it returns agent-payable Lightning, USDT (TRC-20), Monero, and Bitcoin destinations inline (an agent holding crypto pays without a human), plus a payment page (card + 50+ altcoins) for a human.
No personal account, email, or KYC required.
Welcome credit is spend-only (never withdrawable); deposits are.

There's also a separate reseller program at https://pikasim.com/reseller — a B2B track with its own pk_live_ key and a 10% discount. Reseller keys also work on this MCP server at wholesale pricing.

Example

jsonc

// 1. Find data plans for Japan
{ "tool": "search_esim_packages", "arguments": { "country": "JP", "type": "data" } }

// 2. Get a real US phone number plan
{ "tool": "search_phone_plans", "arguments": { "country": "US" } }

// 3. Check your wallet, then buy (needs ak_live_ key)
{ "tool": "check_balance", "arguments": {} }
{ "tool": "purchase_esim", "arguments": { "packageCode": "PACKAGE_CODE_FROM_SEARCH" } }

Rate limits & errors

Public browsing is rate-limited per IP. Authenticated tools are scoped to your wallet.
Errors return a clear message (e.g. insufficient balance → fund via create_deposit or the wallet page).
Full reference: https://pikasim.com/mcp-docs?utm_source=github_pikasim_mcp

About PikaSim

PikaSim is a privacy-first eSIM marketplace: no accounts, no email, no KYC, crypto settlement. The MCP server exposes the same catalog and ordering to AI agents.

Website: https://pikasim.com
MCP docs: https://pikasim.com/mcp-docs
Agent wallet: https://pikasim.com/agent-wallet
Agentic ordering guide: https://pikasim.com/agentic-esim-ordering

For registries (Dockerfile)

You do not need Docker to use PikaSim — just point your client at the URL above. The included Dockerfile exists only so registries (e.g. Glama) can start a container, speak MCP over stdio, and introspect the tool set. It runs mcp-remote, which bridges a local stdio client to the hosted Streamable HTTP endpoint. All public tools are discoverable with no key.

License

MIT — see LICENSE. This repository contains documentation for the hosted PikaSim MCP server; the server itself runs at https://pikasim.com/mcp.

Install

Tools (31)

search_esim_packagessearch_phone_plansget_package_detailscheck_country_coverageget_pricingget_phone_plan_pricingsearchfetch

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://pikasim.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "pikasim": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pikasim.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

PikaSim MCP Server (com.pikasim/pikasim)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

search_esim_packages

search_phone_plans

get_package_details

check_country_coverage

get_pricing

get_phone_plan_pricing

search

fetch

create_wallet

check_balance

purchase_esim

purchase_phone_plan

get_esim_status

topup_esim

list_orders

list_esims

list_transactions

create_deposit

get_topup_options

cancel_esim

search_sms_services

get_sms_service_countries

list_sms_rentals

order_sms_verification

check_sms_verification

cancel_sms_verification

list_sms_orders

rent_sms_number

get_sms_rental_messages

extend_sms_rental

cancel_sms_rental

PikaSim MCP Server

Install as an agent skill

Quick start

Fully autonomous: from zero to buying, no human

Three product lines

Setup guides

Claude Desktop

Claude Code (CLI)

Cursor / Windsurf / other JSON-config clients

ChatGPT (custom connector)

Tools

Public tools (no API key)

Authenticated tools (require an ak_live_ agent-wallet key)

Authentication

Wallet, in brief

Example

Rate limits & errors

About PikaSim

For registries (Dockerfile)

License

Install

Remote endpoint

Related servers

Authenticated tools (require an `ak_live_` agent-wallet key)