# AskMia - eSIM for Travelers

> AskMia is an AI-powered eSIM marketplace that helps travelers stay connected worldwide with instant digital SIM cards.

## What is AskMia?

AskMia (askmia.app) provides prepaid eSIM data plans for 190+ countries. Users can browse plans, get personalized recommendations from our AI assistant Mia, and activate their eSIM instantly. No physical SIM card needed.

## Key Features

- **AI Assistant (Mia)**: A conversational assistant that helps users find the best eSIM plan for their trip, provides advice on data plans, answers questions about compatibility, installation, and troubleshooting.
- **eSIM Shop**: Browse and purchase data plans by country or region with transparent pricing.
- **Instant Activation**: eSIMs are delivered digitally and can be installed via QR code or direct links.
- **Top-Up Support**: Extend existing plans without losing your number or data.
- **14 Languages**: Mia and the interface support English, Russian, Spanish, French, German, Italian, Portuguese, Chinese, Japanese, Korean, Arabic, Estonian, Finnish, and Turkish.
- **MCP Server**: AI agents can programmatically search, browse, and purchase eSIM plans via the Model Context Protocol.

## How eSIM Works

An eSIM (embedded SIM) is a digital SIM that allows you to use a data plan without a physical SIM card. It works on most modern smartphones (iPhone XS and later, many Android devices). eSIM plans from AskMia provide **data only** (no calls/SMS). Users can make calls via VoIP apps like WhatsApp, FaceTime, or Skype.

## MCP Server (Agent-to-Agent Interface)

AskMia exposes an MCP-compatible endpoint for AI agents to interact with the eSIM marketplace programmatically.

**Endpoint**: `https://mcp.askmia.app`
**Auth**: Bearer token (API key required)
**Protocol**: MCP Streamable HTTP (JSON-RPC 2.0)

### Available Tools

| Tool | Description |
|------|-------------|
| `list_countries` | List all 190+ supported countries with codes and regions |
| `search_packages` | Search eSIM packages by country code, optionally filter by data size |
| `get_package_details` | Get full details: pricing, validity, coverage, supported networks |
| `check_coverage` | Check network operators and speeds for a specific country |
| `check_device_compatibility` | Check if a device supports eSIM by name, model, or vendor |
| `create_checkout` | Generate a Stripe payment link for a customer (by email) |

### Example: Search packages for France

```json
{"jsonrpc":"2.0","method":"tools/call","params":{"name":"search_packages","arguments":{"country_code":"FR"}},"id":1}
```

### Headless Commerce

The `create_checkout` tool enables headless purchases: pass a `package_id` and `customer_email`, get back a payment URL. After payment, the customer receives their eSIM via email with QR code and installation instructions. If they don't have an AskMia account, one is created automatically.

## Pages

- `/` - Landing page with quick access to AI assistant and eSIM shop
- `/shop` - Browse eSIM plans by country
- `/shop/:countryCode` - View available packages for a specific country
- `/chat` - Chat with Mia, the AI travel assistant
- `/signin` - Sign in to your account
- `/signup` - Create a new account
- `/my-account` - Manage your profile and view purchased eSIMs
- `/how-it-works` - Step-by-step guide: check compatibility, buy, install, activate, and manage eSIM plans

- `/contact` - Contact us
- `/developers` - MCP API documentation and API key request
- `/privacy` - Privacy policy
- `/terms` - Terms of service

## Contact

For questions or support, email info@askmia.app, visit [/contact](/contact), or chat with Mia at [/chat](/chat).
For MCP API access, visit [/developers](/developers) or email info@askmia.app.