com.pikasim/pikasim

Official15 tools

by codebruinc · Dockerfile

PikaSim

Buy anonymous eSIMs and phone-number plans in 190+ countries from a prepaid crypto wallet.

Purchase anonymous eSIMs and phone plans globally using cryptocurrency.

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.

Parameters (4)

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

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

Parameters (3)

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

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.

Parameters (1)

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

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

Parameters (1)

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

get_pricing

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

Parameters (2)

packageCodestringrequired
Package code (data or phone plan)
currencystring
Currency code (currently only USD supported)

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.

Parameters (2)

packageCodestringrequired
Phone-plan package code from search_phone_plans (e.g., change-plus-7days-1gb)
currencystring
Currency code (currently only USD supported)

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.

No parameters.

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 phone-number eSIMs use purchase_phone_plan instead. Requires an agent-wallet API key (ak_live_).

Parameters (1)

packageCodestringrequired
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_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. Requires an agent-wallet API key (ak_live_).

Parameters (1)

packageCodestringrequired
Phone-plan package code (use search_phone_plans to find codes, e.g., change-plus-7days-1gb)

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

Parameters (1)

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

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

Parameters (2)

iccidstringrequired
The ICCID of the eSIM to top up (from list_orders or a prior purchase)
packageCodestringrequired
A top-up package code returned by get_topup_options for this ICCID (top-up codes differ from new-purchase codes)

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

Parameters (2)

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

create_deposit

Creates a cryptocurrency payment invoice to add funds to the connected prepaid agent wallet, and returns a checkout link plus per-coin payment details. Accepts Bitcoin, Lightning, Monero, USDT, and 50+ altcoins. Does not move funds itself; it returns an invoice the user pays externally, and the balance updates once the on-chain payment confirms. Use when check_balance is too low to purchase. Minimum is $10. Requires a connected agent wallet (OAuth or ak_live_ key).

Parameters (1)

amountnumberrequired
Amount to deposit in whole US dollars (minimum 10, e.g. 25 for a $25 deposit)

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

Parameters (1)

iccidstringrequired
ICCID of the eSIM to get top-up options for

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

Parameters (1)

iccidstringrequired
ICCID of the eSIM to cancel

README.md8 KBView on GitHub

PikaSim MCP Server

Buy eSIMs from an AI agent — no account, no email, no KYC. Anonymous data plans and real carrier phone 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 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
Agent wallet: https://pikasim.com/agent-wallet
Browsing needs no key. Purchasing connects a prepaid agent wallet via one-click OAuth (or an ak_live_ key on CLI clients).

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.

Two product lines

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

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.

search_esim_packages and check_country_coverage return both 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
claude mcp add --transport http pikasim https://pikasim.com/mcp

# With an agent wallet (purchasing)
claude mcp add --transport http pikasim https://pikasim.com/mcp \
  --header "Authorization: Bearer ak_live_YOUR_KEY"

Cursor / Windsurf / other JSON-config clients

json

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

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

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.
`create_deposit`	Generate a crypto invoice to fund your wallet (BTC, Lightning, Monero, USDT, 50+ altcoins).
`cancel_esim`	Cancel an unused eSIM and refund to your wallet (only if never installed/activated).

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. Create a wallet and get your wallet code + key at https://pikasim.com/agent-wallet (save the wallet code; it's the only way back in).

Wallet, in brief

Prepaid, crypto-funded balance (min deposit $10). Retail pricing.
Fund via create_deposit (Bitcoin, Lightning, Monero, USDT, and 50+ altcoins) or at the wallet page.
No personal account, email, or KYC required.

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

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

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

Topics

search_esim_packages

search_phone_plans

get_package_details

check_country_coverage

get_pricing

get_phone_plan_pricing

check_balance

purchase_esim

purchase_phone_plan

get_esim_status

topup_esim

list_orders

create_deposit

get_topup_options

cancel_esim

PikaSim MCP Server

Quick start

Two 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

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