{
  "markdown": "# PikaSim MCP Server\n\n> 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.\n\nPikaSim 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.\n\n- **Browse (no auth):** `https://pikasim.com/mcp`\n- **Purchase (OAuth):** `https://pikasim.com/mcp/wallet`\n- **Transport:** Streamable HTTP (JSON-RPC over HTTP POST)\n- **Docs:** https://pikasim.com/mcp-docs?utm_source=github_pikasim_mcp\n- **Agent wallet:** https://pikasim.com/agent-wallet?utm_source=github_pikasim_mcp\n- **Browsing needs no key.** Purchasing connects a prepaid agent wallet via one-click OAuth (or an `ak_live_` key on CLI clients).\n\n---\n\n## Install as an agent skill\n\nThis repo also ships a [`pikasim` agent skill](skills/pikasim/SKILL.md) — an\ninstallable instruction package that teaches any skill-capable agent (Claude\nCode, claude.ai, and other SKILL.md-compatible hosts) when and how to buy\nconnectivity from PikaSim, including the no-MCP REST fallback and the\ncold-start wallet flow:\n\n```bash\nnpx skills add codebruinc/pikasim-mcp\n```\n\nor copy `skills/pikasim/` into your agent's skills directory (e.g.\n`~/.claude/skills/pikasim/`).\n\n---\n\n## Quick start\n\nAdd PikaSim to your AI agent's MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"pikasim\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://pikasim.com/mcp\"\n    }\n  }\n}\n```\n\nThat'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.**\n\nTo **purchase** too, connect `https://pikasim.com/mcp/wallet` instead — it triggers a one-click OAuth flow where you authorize a free, prepaid [agent wallet](https://pikasim.com/agent-wallet) by pasting your wallet code (no key handling, no account, no email). See [Authentication](#authentication).\n\n---\n\n## Fully autonomous: from zero to buying, no human\n\nA 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:\n\n```jsonc\n// 1. The agent creates its own wallet — returns a wallet code, an ak_live_ key,\n//    and a small spend-only welcome credit. No account, email, KYC, or browser.\n{ \"tool\": \"create_wallet\", \"arguments\": { \"acceptTos\": true } }\n\n// 2. Reconnect with the returned key:  Authorization: Bearer ak_live_...\n//    (or use the URL https://pikasim.com/mcp/ak_live_YOUR_KEY)\n\n// 3. Confirm the welcome credit is there\n{ \"tool\": \"check_balance\", \"arguments\": {} }          // -> $1.00\n\n// 4. Buy — the welcome credit covers a first sub-$1 purchase, e.g. an SMS number\n{ \"tool\": \"order_sms_verification\", \"arguments\": { \"serviceId\": \"817\", \"countryId\": \"2\" } }\n```\n\nThat'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.\n\n---\n\n## Three product lines\n\nDon't assume \"eSIM\" means data-only. PikaSim sells:\n\n1. **Data eSIMs** — anonymous data plans across 190+ countries, from **$0.75**. Discover with `search_esim_packages` / `check_country_coverage`; buy with `purchase_esim`.\n2. **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`.\n3. **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`).\n\n`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.\n\n---\n\n## Setup guides\n\nPikaSim is a remote MCP server at `https://pikasim.com/mcp`. The config key and steps differ per client.\n\n### Claude Desktop\n\nRemote 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).\n\n### Claude Code (CLI)\n\n```bash\n# Browse only (also lets the agent self-onboard via the create_wallet tool)\nclaude mcp add --transport http pikasim https://pikasim.com/mcp\n\n# With purchasing via key (recommended for headless/terminal agents)\nclaude mcp add --transport http pikasim https://pikasim.com/mcp \\\n  --header \"Authorization: Bearer ak_live_YOUR_KEY\"\n\n# With purchasing via OAuth: add the wallet URL, then run /mcp inside Claude\n# Code and pick \"Authenticate\" — a browser opens the PikaSim consent page\n# where you paste your wallet code\nclaude mcp add --transport http pikasim https://pikasim.com/mcp/wallet\n```\n\n**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](#fully-autonomous-from-zero-to-buying-no-human).\n\n### Cursor / Windsurf / other JSON-config clients\n\n```json\n{\n  \"mcpServers\": {\n    \"pikasim\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://pikasim.com/mcp\"\n    }\n  }\n}\n```\n\nTo 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.\n\n### ChatGPT (custom connector)\n\nAdd 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).\n\n---\n\n## Tools\n\n### Public tools (no API key)\n\n| Tool | Description |\n|------|-------------|\n| `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. |\n| `search_esim_packages` | Search eSIM plans by country, region, or keyword. Returns **both** data and phone-number buckets. |\n| `search_phone_plans` | Search phone-number eSIMs (real carrier number + voice + SMS + data). |\n| `get_package_details` | Full details for a plan: coverage, data, voice/SMS allowance, duration, price, networks, purchase URL. |\n| `check_country_coverage` | What PikaSim plans cover a country — data and phone-number buckets with counts and price ranges. |\n| `get_pricing` | USD price for a specific plan (data or phone-number) by `packageCode`. |\n| `get_phone_plan_pricing` | USD price + voice/SMS/data allowance for a specific phone-number eSIM. |\n| `search_sms_services` | Search SMS verification services (Discord, Google, Telegram, … or \"Other\" for anything unlisted). |\n| `get_sms_service_countries` | Countries offering a quick SMS number for one service, with live price, success rate, and VoIP vs real-mobile flag. |\n| `list_sms_rentals` | Long-term SMS rental numbers with duration tiers, live prices, and **live stock** per duration. |\n\n### Authenticated tools (require an `ak_live_` agent-wallet key)\n\n| Tool | Description |\n|------|-------------|\n| `check_balance` | Check your agent-wallet balance. |\n| `purchase_esim` | Buy a data eSIM. Returns activation info (ICCID, QR, SM-DP+). |\n| `purchase_phone_plan` | Buy a phone-number eSIM (real number + voice + SMS + data). |\n| `get_esim_status` | Live status, data usage, and expiration of an eSIM. |\n| `get_topup_options` | List valid top-up packages for an existing eSIM. |\n| `topup_esim` | Add more data to an existing eSIM. |\n| `list_orders` | List recent orders with status and cost. |\n| `list_esims` | Fleet view: every eSIM the wallet owns (ICCID, plan, status, install link, remaining data for small fleets). |\n| `list_transactions` | Wallet ledger: every deposit, purchase, and refund with running balance. |\n| `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. |\n| `cancel_esim` | Cancel an **unused** eSIM and refund to your wallet (only if never installed/activated). |\n| `order_sms_verification` | Buy a quick SMS number for one verification code (single-use, 20 min, auto-refund if no SMS). |\n| `check_sms_verification` | Poll a quick SMS order for the incoming code. |\n| `cancel_sms_verification` | Cancel a waiting quick SMS order for an immediate refund. |\n| `list_sms_orders` | List your quick SMS orders and rental numbers. |\n| `rent_sms_number` | Rent a long-term receive-only SMS number (extendable; not for banking/financial verification). |\n| `get_sms_rental_messages` | Read a rental number's inbox. |\n| `extend_sms_rental` | Extend a rental before expiry — days are added on top of the current expiry. |\n\n---\n\n## Authentication\n\nBrowsing is open at `https://pikasim.com/mcp`. To purchase, connect `https://pikasim.com/mcp/wallet`, which supports two auth methods:\n\n1. **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.\n2. **Bearer key (for CLI clients):** send `Authorization: Bearer ak_live_YOUR_KEY`.\n\nThe 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](#fully-autonomous-from-zero-to-buying-no-human)). 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).\n\n### Wallet, in brief\n\n- Prepaid, crypto-funded balance. Retail pricing. Minimum deposit **$1** — and new wallets carry a small spend-only welcome credit, so a first sub-$1 purchase needs no deposit at all.\n- 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.\n- No personal account, email, or KYC required.\n- Welcome credit is spend-only (never withdrawable); deposits are.\n\n> 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.\n\n---\n\n## Example\n\n```jsonc\n// 1. Find data plans for Japan\n{ \"tool\": \"search_esim_packages\", \"arguments\": { \"country\": \"JP\", \"type\": \"data\" } }\n\n// 2. Get a real US phone number plan\n{ \"tool\": \"search_phone_plans\", \"arguments\": { \"country\": \"US\" } }\n\n// 3. Check your wallet, then buy (needs ak_live_ key)\n{ \"tool\": \"check_balance\", \"arguments\": {} }\n{ \"tool\": \"purchase_esim\", \"arguments\": { \"packageCode\": \"PACKAGE_CODE_FROM_SEARCH\" } }\n```\n\n---\n\n## Rate limits & errors\n\n- Public browsing is rate-limited per IP. Authenticated tools are scoped to your wallet.\n- Errors return a clear message (e.g. insufficient balance → fund via `create_deposit` or the wallet page).\n- Full reference: **https://pikasim.com/mcp-docs?utm_source=github_pikasim_mcp**\n\n---\n\n## About PikaSim\n\n[PikaSim](https://pikasim.com) 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.\n\n- Website: https://pikasim.com\n- MCP docs: https://pikasim.com/mcp-docs\n- Agent wallet: https://pikasim.com/agent-wallet\n- Agentic ordering guide: https://pikasim.com/agentic-esim-ordering\n\n## For registries (Dockerfile)\n\nYou do **not** need Docker to use PikaSim — just point your client at the URL above. The included [`Dockerfile`](Dockerfile) exists only so registries (e.g. [Glama](https://glama.ai/mcp/servers/codebruinc/pikasim-mcp)) can start a container, speak MCP over stdio, and introspect the tool set. It runs [`mcp-remote`](https://www.npmjs.com/package/mcp-remote), which bridges a local stdio client to the hosted Streamable HTTP endpoint. All public tools are discoverable with no key.\n\n## License\n\nMIT — see [LICENSE](LICENSE). This repository contains documentation for the hosted PikaSim MCP server; the server itself runs at `https://pikasim.com/mcp`.\n",
  "bytes": 13481,
  "sha": "39ba83dc42563688a24b36444481dcf0c2099621d7ff4b35bedad21e5fb515f8",
  "repo_slug": "codebruinc/pikasim-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_pikasim_pikasim_264a7dd5/readme"
}