io.github.nativine/mcp

@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

🔄 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

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

🌐 Environment Variables

📖 Documentation

Full documentation is available at nativine.com/docs.

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

📄 License

ISC