@nativine/mcp — Nativine MCP Server

Name: Nativine MCP
Author: nativine

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):

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

Authenticate — The server reads your NATIVINE_API_KEY from the environment.
List or Create Drafts — The AI calls nativine_list_drafts to show existing apps, or creates a new draft with nativine_save_draft.
Configure Your App — Set branding colors, permissions, splash screens, bottom navigation, deep links, push notifications, and 30+ native features.
Upload Assets — Upload app icons and splash images directly from your local filesystem.
Build — Trigger compilation with nativine_trigger_build and poll with nativine_build_status.
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