{"id":50949132,"url":"https://github.com/codebruinc/pikasim-mcp","last_synced_at":"2026-06-17T23:32:31.400Z","repository":{"id":363252931,"uuid":"1251844566","full_name":"codebruinc/pikasim-mcp","owner":"codebruinc","description":"PikaSim MCP Server - Browse, compare, and purchase eSIMs for 190+ countries via AI agents","archived":false,"fork":false,"pushed_at":"2026-06-08T04:18:50.000Z","size":2,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-08T06:17:13.670Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codebruinc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-28T00:54:37.000Z","updated_at":"2026-06-08T04:18:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/codebruinc/pikasim-mcp","commit_stats":null,"previous_names":["codebruinc/pikasim-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/codebruinc/pikasim-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codebruinc%2Fpikasim-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codebruinc%2Fpikasim-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codebruinc%2Fpikasim-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codebruinc%2Fpikasim-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codebruinc","download_url":"https://codeload.github.com/codebruinc/pikasim-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codebruinc%2Fpikasim-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34470323,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-17T23:32:30.461Z","updated_at":"2026-06-17T23:32:31.396Z","avatar_url":"https://github.com/codebruinc.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# PikaSim MCP Server\n\nBrowse, compare, and purchase eSIMs for 190+ countries via AI agents using the [Model Context Protocol](https://modelcontextprotocol.io).\n\n**Endpoint:** `https://pikasim.com/mcp`\n**Transport:** Streamable HTTP (stateless)\n**Documentation:** [pikasim.com/mcp-docs](https://pikasim.com/mcp-docs)\n\n## Quick Start\n\nAdd 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\nNo API key needed for browsing. Add an optional `Authorization` header to unlock purchasing tools:\n\n```json\n{\n  \"mcpServers\": {\n    \"pikasim\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://pikasim.com/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer pk_live_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\nGet a free API key at [pikasim.com/reseller](https://pikasim.com/reseller).\n\n## Tools\n\n### Public (no auth required)\n\n| Tool | Description |\n|------|-------------|\n| `search_esim_packages` | Search by country code, region, or keyword. Returns top 10 matching packages with prices. |\n| `get_package_details` | Full details for a package: coverage, data, duration, price, networks, and purchase URL. |\n| `check_country_coverage` | All available plans for a country with price ranges and data options. |\n| `get_pricing` | Price and accepted payment methods for a specific package. |\n\n### Authenticated (free reseller API key)\n\n| Tool | Description |\n|------|-------------|\n| `purchase_esim` | Buy an eSIM. Returns ICCID, QR code, and activation details. |\n| `check_balance` | Wallet balance and available credit. |\n| `get_esim_status` | Live status, data usage, and expiration of a purchased eSIM. |\n| `topup_esim` | Add more data to an existing eSIM. |\n| `get_topup_options` | Available top-up packages for an eSIM with prices. |\n| `list_orders` | Recent order history with status and cost. |\n| `create_deposit` | Fund wallet with crypto (BTC, XMR, USDT, 50+ altcoins). |\n| `cancel_esim` | Cancel an unused eSIM for a wallet refund. |\n\n## Supported Clients\n\nWorks with any MCP client that supports Streamable HTTP transport:\n\n- **Claude Desktop** - Add to `claude_desktop_config.json`\n- **Claude Code** - Add to `.mcp.json`\n- **Cursor** - Settings \u003e MCP Servers \u003e Add Server\n- **Windsurf** - MCP settings\n- **Custom agents** - Any client implementing the [Streamable HTTP transport](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)\n\n## Authentication\n\nPublic tools work without any API key. Authenticated tools require a PikaSim reseller API key (`pk_live_...`), which is free to obtain:\n\n1. Sign up at [pikasim.com/reseller](https://pikasim.com/reseller)\n2. Get approved (usually same day)\n3. Generate your API key from the dashboard\n4. Fund your wallet with crypto\n\nWhen authenticated, public browsing tools also show 10% discounted reseller pricing.\n\n## Examples\n\n### Test with cURL\n\n```bash\n# Search Japan eSIM packages\ncurl -X POST https://pikasim.com/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Accept: application/json, text/event-stream\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 1,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"search_esim_packages\",\n      \"arguments\": { \"country\": \"JP\" }\n    }\n  }'\n```\n\n### Python\n\n```python\nfrom mcp import ClientSession\nfrom mcp.client.streamable_http import streamablehttp_client\n\nasync def main():\n    async with streamablehttp_client(\"https://pikasim.com/mcp\") as (\n        read_stream, write_stream, _\n    ):\n        async with ClientSession(read_stream, write_stream) as session:\n            await session.initialize()\n            result = await session.call_tool(\n                \"search_esim_packages\",\n                arguments={\"country\": \"JP\"}\n            )\n            print(result.content[0].text)\n\nimport asyncio\nasyncio.run(main())\n```\n\n### Node.js\n\n```javascript\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StreamableHTTPClientTransport }\n  from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\n\nconst transport = new StreamableHTTPClientTransport(\n  new URL(\"https://pikasim.com/mcp\")\n);\n\nconst client = new Client(\n  { name: \"my-agent\", version: \"1.0\" },\n  { capabilities: {} }\n);\n\nawait client.connect(transport);\n\nconst result = await client.callTool(\n  \"search_esim_packages\",\n  { country: \"JP\" }\n);\nconsole.log(result.content[0].text);\n\nawait client.close();\n```\n\n## Rate Limits\n\n| Scope | Limit | Window |\n|-------|-------|--------|\n| MCP endpoint (per IP) | 60 requests | 1 minute |\n| Reseller API (per key) | 60 requests | 1 minute |\n| Orders (per key) | 100 orders | 1 day |\n\n## Links\n\n- [MCP Documentation](https://pikasim.com/mcp-docs)\n- [REST API Documentation](https://pikasim.com/api-docs-for-ai)\n- [OpenAPI Specification](https://pikasim.com/openapi.yaml)\n- [Reseller Program](https://pikasim.com/reseller)\n- [LLM.txt](https://pikasim.com/llm.txt)\n- [Website](https://pikasim.com)\n\n## License\n\nLicensed under the [MIT License](LICENSE).\n\nThis repository contains documentation and integration details for the PikaSim MCP server. The server itself is a hosted service at `pikasim.com/mcp`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodebruinc%2Fpikasim-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodebruinc%2Fpikasim-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodebruinc%2Fpikasim-mcp/lists"}