# @nativine/mcp — Nativine MCP Server

[![NPM Version](https://img.shields.io/npm/v/@nativine/mcp.svg?style=flat-square)](https://www.npmjs.com/package/@nativine/mcp)
[![NPM Downloads](https://img.shields.io/npm/dm/@nativine/mcp.svg?style=flat-square)](https://www.npmjs.com/package/@nativine/mcp)
[![License](https://img.shields.io/npm/l/@nativine/mcp.svg?style=flat-square)](https://www.npmjs.com/package/@nativine/mcp)
[![Protocol](https://img.shields.io/badge/protocol-MCP-blue.svg?style=flat-square)](https://modelcontextprotocol.io)

The official [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for **[Nativine](https://nativine.com)** — the first website-to-app converter platform with MCP support.

Connect your AI IDE (Cursor, Claude Desktop, Antigravity, VS Code, Windsurf, or any MCP-compatible tool) and convert any website into a native Android (`.apk`/`.aab`) or iOS (`.ipa`) app through natural language chat.

---

## 🚀 Quick Start

### 1. Get Your API Key

Generate an API key from your [Nativine Dashboard](https://nativine.com/dashboard) → API Keys tab.

### 2. Configure Your IDE

Add the following to your MCP configuration:

**Cursor / Claude Desktop / Antigravity** (`mcp_config.json`):
```json
{
  "mcpServers": {
    "nativine": {
      "command": "npx",
      "args": ["-y", "@nativine/mcp"],
      "env": {
        "NATIVINE_API_KEY": "ntvn_ak_your_key_here"
      }
    }
  }
}
```

**VS Code** (`.vscode/settings.json`):
```json
{
  "mcp.servers": {
    "nativine": {
      "command": "npx",
      "args": ["-y", "@nativine/mcp"],
      "env": {
        "NATIVINE_API_KEY": "ntvn_ak_your_key_here"
      }
    }
  }
}
```

### 3. Start Building

Just chat with your AI:
> "Convert https://my-store.com into an Android app with a blue theme and bottom navigation"

---

## 🔧 Available Tools

| Tool | Description |
|------|-------------|
| `nativine_get_account` | Get authenticated user profile, plan tier, and currency |
| `nativine_list_drafts` | List all app drafts for the authenticated user |
| `nativine_get_draft` | Get full details of a specific app draft |
| `nativine_save_draft` | Create or update an app draft configuration |
| `nativine_upload_asset` | Upload a local file (icon, splash, logo) to Nativine cloud |
| `nativine_trigger_build` | Trigger APK/AAB/IPA compilation for a draft |
| `nativine_build_status` | Check build progress and get download links |
| `nativine_download_build` | Download a completed build to the local filesystem |

---

## 🔄 How It Works

1. **Authenticate** — The server reads your `NATIVINE_API_KEY` from the environment.
2. **List or Create Drafts** — The AI calls `nativine_list_drafts` to show existing apps, or creates a new draft with `nativine_save_draft`.
3. **Configure Your App** — Set branding colors, permissions, splash screens, bottom navigation, deep links, push notifications, and 30+ native features.
4. **Upload Assets** — Upload app icons and splash images directly from your local filesystem.
5. **Build** — Trigger compilation with `nativine_trigger_build` and poll with `nativine_build_status`.
6. **Download** — Once complete, the AI downloads the `.apk`/`.aab`/`.ipa` to your project directory.

---

## 📋 Configuration Options

The `nativine_save_draft` tool accepts a rich `config` object with these categories:

- **Branding** — `brandColor`, `statusBarColor`, `navBarColor`, `splashBackgroundColor`
- **Splash Screen** — `splashType` (logo/full/animation), `splashLogoSize`, `splashAnimationType`
- **Behavior** — `screenOrientation`, `enablePullToRefresh`, `enableProgressBar`, `enablePinchToZoom`, `pressAgainToExit`, `enableFullScreen`
- **Permissions** — `enableCamera`, `enableMicrophone`, `enableLocation`, `enableStorage` (with custom dialog text)
- **Web Overrides** — `userAgent`, `customCSS`, `customJS`, `supportedDomains`
- **Deep Links** — `enableDeepLinks`, `deepLinkScheme`, `enableUniversalLinks`
- **Addons** — Bottom Navigation, Header Bar, Floating Button, OneSignal Push, AdMob Ads, Biometrics, Haptic Feedback, In-App Updates/Reviews, Local Datastore, Contacts Access, Print Support, OAuth/Google Sign-In, Screenshot Blocker
- **Keystore** — Custom `.jks`/`.p12` signing for Play Store releases (Release plan only)
- **Versioning** — `versionCode`, `versionName`

---

## 💳 Plans

| Feature | Free Plan | Release Plan |
|---------|-----------|--------------|
| Trial APK builds | ✅ | ✅ |
| Production APK/AAB | ❌ | ✅ |
| iOS IPA builds | ❌ | ✅ |
| Push Notifications | ❌ | ✅ |
| AdMob Ads | ❌ | ✅ |
| Custom Keystore | ❌ | ✅ |
| Biometrics & Premium Addons | ❌ | ✅ |

If premium features are requested without a Release plan, the assistant will guide you to upgrade. Upgrade anytime at [nativine.com/pricing](https://nativine.com/pricing).

---

## 🌐 Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `NATIVINE_API_KEY` | ✅ | Your Nativine API key (`ntvn_ak_...`) |
| `NATIVINE_API_URL` | ❌ | Custom API endpoint (default: `https://api.nativine.com/api`) |
| `NATIVINE_PROJECT_DIR` | ❌ | Override project directory for local config and downloads |

---

## 📖 Documentation

Full documentation is available at [nativine.com/docs](https://nativine.com/docs).

For MCP-specific setup guides, visit [nativine.com/mcp](https://nativine.com/mcp).

---

## 📄 License

ISC