How do I install PikaSim?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does PikaSim need an API key?

No required environment variable is listed on this record.

When was PikaSim last checked?

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

PikaSim MCP server

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:

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:

{
  "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:

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

# 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

{
  "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`

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

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

PikaSim

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install PikaSim?

Does PikaSim need an API key?

What transport does PikaSim use?

When was PikaSim last checked?

Documentation

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

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install PikaSim?

Does PikaSim need an API key?

What transport does PikaSim use?

When was PikaSim last checked?

Documentation

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

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