{
  "markdown": "# @nativine/mcp — Nativine MCP Server\n\n[![NPM Version](https://img.shields.io/npm/v/@nativine/mcp.svg?style=flat-square)](https://www.npmjs.com/package/@nativine/mcp)\n[![NPM Downloads](https://img.shields.io/npm/dm/@nativine/mcp.svg?style=flat-square)](https://www.npmjs.com/package/@nativine/mcp)\n[![License](https://img.shields.io/npm/l/@nativine/mcp.svg?style=flat-square)](https://www.npmjs.com/package/@nativine/mcp)\n[![Protocol](https://img.shields.io/badge/protocol-MCP-blue.svg?style=flat-square)](https://modelcontextprotocol.io)\n\nThe official [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for **[Nativine](https://nativine.com)** — the first website-to-app converter platform with MCP support.\n\nConnect 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.\n\n---\n\n## 🚀 Quick Start\n\n### 1. Get Your API Key\n\nGenerate an API key from your [Nativine Dashboard](https://nativine.com/dashboard) → API Keys tab.\n\n### 2. Configure Your IDE\n\nAdd the following to your MCP configuration:\n\n**Cursor / Claude Desktop / Antigravity** (`mcp_config.json`):\n```json\n{\n  \"mcpServers\": {\n    \"nativine\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@nativine/mcp\"],\n      \"env\": {\n        \"NATIVINE_API_KEY\": \"ntvn_ak_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n**VS Code** (`.vscode/settings.json`):\n```json\n{\n  \"mcp.servers\": {\n    \"nativine\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@nativine/mcp\"],\n      \"env\": {\n        \"NATIVINE_API_KEY\": \"ntvn_ak_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### 3. Start Building\n\nJust chat with your AI:\n> \"Convert https://my-store.com into an Android app with a blue theme and bottom navigation\"\n\n---\n\n## 🔧 Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `nativine_get_account` | Get authenticated user profile, plan tier, and currency |\n| `nativine_list_drafts` | List all app drafts for the authenticated user |\n| `nativine_get_draft` | Get full details of a specific app draft |\n| `nativine_save_draft` | Create or update an app draft configuration |\n| `nativine_upload_asset` | Upload a local file (icon, splash, logo) to Nativine cloud |\n| `nativine_trigger_build` | Trigger APK/AAB/IPA compilation for a draft |\n| `nativine_build_status` | Check build progress and get download links |\n| `nativine_download_build` | Download a completed build to the local filesystem |\n\n---\n\n## 🔄 How It Works\n\n1. **Authenticate** — The server reads your `NATIVINE_API_KEY` from the environment.\n2. **List or Create Drafts** — The AI calls `nativine_list_drafts` to show existing apps, or creates a new draft with `nativine_save_draft`.\n3. **Configure Your App** — Set branding colors, permissions, splash screens, bottom navigation, deep links, push notifications, and 30+ native features.\n4. **Upload Assets** — Upload app icons and splash images directly from your local filesystem.\n5. **Build** — Trigger compilation with `nativine_trigger_build` and poll with `nativine_build_status`.\n6. **Download** — Once complete, the AI downloads the `.apk`/`.aab`/`.ipa` to your project directory.\n\n---\n\n## 📋 Configuration Options\n\nThe `nativine_save_draft` tool accepts a rich `config` object with these categories:\n\n- **Branding** — `brandColor`, `statusBarColor`, `navBarColor`, `splashBackgroundColor`\n- **Splash Screen** — `splashType` (logo/full/animation), `splashLogoSize`, `splashAnimationType`\n- **Behavior** — `screenOrientation`, `enablePullToRefresh`, `enableProgressBar`, `enablePinchToZoom`, `pressAgainToExit`, `enableFullScreen`\n- **Permissions** — `enableCamera`, `enableMicrophone`, `enableLocation`, `enableStorage` (with custom dialog text)\n- **Web Overrides** — `userAgent`, `customCSS`, `customJS`, `supportedDomains`\n- **Deep Links** — `enableDeepLinks`, `deepLinkScheme`, `enableUniversalLinks`\n- **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\n- **Keystore** — Custom `.jks`/`.p12` signing for Play Store releases (Release plan only)\n- **Versioning** — `versionCode`, `versionName`\n\n---\n\n## 💳 Plans\n\n| Feature | Free Plan | Release Plan |\n|---------|-----------|--------------|\n| Trial APK builds | ✅ | ✅ |\n| Production APK/AAB | ❌ | ✅ |\n| iOS IPA builds | ❌ | ✅ |\n| Push Notifications | ❌ | ✅ |\n| AdMob Ads | ❌ | ✅ |\n| Custom Keystore | ❌ | ✅ |\n| Biometrics & Premium Addons | ❌ | ✅ |\n\nIf 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).\n\n---\n\n## 🌐 Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `NATIVINE_API_KEY` | ✅ | Your Nativine API key (`ntvn_ak_...`) |\n| `NATIVINE_API_URL` | ❌ | Custom API endpoint (default: `https://api.nativine.com/api`) |\n| `NATIVINE_PROJECT_DIR` | ❌ | Override project directory for local config and downloads |\n\n---\n\n## 📖 Documentation\n\nFull documentation is available at [nativine.com/docs](https://nativine.com/docs).\n\nFor MCP-specific setup guides, visit [nativine.com/mcp](https://nativine.com/mcp).\n\n---\n\n## 📄 License\n\nISC\n",
  "bytes": 5371,
  "sha": "5ed4bd0d06ec13482e9cecd296a9c816d6ff1d6f09e7f986f8b5bafe88e97a63",
  "repo_slug": "nativine/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_nativine_mcp_02f41a57/readme"
}