@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.
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"
| 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 |
📖 Documentation
Full documentation is available at nativine.com/docs.
For MCP-specific setup guides, visit nativine.com/mcp.
📄 License
ISC