@nativine/mcp — Nativine MCP Server

The official Model Context Protocol (MCP) server for Nativine — 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 → API Keys tab.

2. Configure Your IDE

Add the following to your MCP configuration:

Cursor / Claude Desktop / Antigravity (mcp_config.json):

{
  "mcpServers": {
    "nativine": {
      "command": "npx",
      "args": ["-y", "@nativine/mcp"],
      "env": {
        "NATIVINE_API_KEY": "ntvn_ak_your_key_here"
      }
    }
  }
}

VS Code (.vscode/settings.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.

---

🌐 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.

For MCP-specific setup guides, visit nativine.com/mcp.

---

📄 License

ISC