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 sub-$1 purchase, e.g. an SMS number
{ "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:

1. Data eSIMs — anonymous data plans across 190+ countries, from $0.75. Discover with search_esim_packages / check_country_coverage; buy with purchase_esim.
2. 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.
3. 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)

Authenticated tools (require an ak_live_ agent-wallet key)

Authentication