<p align="center">
  <img src="https://connextify.com/connextify-app-icon.png" width="110" height="110" alt="Connextify Logo" />
</p>

# 🤖 Connextify Official MCP Server

[![NPM Version](https://img.shields.io/npm/v/connextify-mcp-server?style=for-the-badge)](https://www.npmjs.com/package/connextify-mcp-server)
[![MCP Ready](https://img.shields.io/badge/MCP-Ready-blue?style=for-the-badge)](https://modelcontextprotocol.io)
[![Status](https://img.shields.io/badge/System_Status-Online-green?style=for-the-badge)](https://connextify.com/status)
[![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](https://opensource.org/licenses/MIT)
[![Docs](https://img.shields.io/badge/Documentation-View_Docs-orange?style=for-the-badge)](https://connextify.com/docs/mcp)

Unlock the full power of **Connextify** directly within your AI agents. This official **Model Context Protocol (MCP)** server provides a high-performance bridge for AI assistants (Claude Desktop, Cursor, ChatGPT, n8n, and custom agents) to programmatically manage branded links, dynamic QR codes, Link-in-Bio profiles, full-canvas responsive landing pages, and deep marketing analytics using natural language.

---

## 🛠️ Performance-Grade Tools (116+ Tools across 9 Domains)

Our MCP server exposes a rich suite of 116 production tools, optimized for AI discovery, minimal token overhead, and instant execution:

### 1. 🔗 Link Management & URL Shortening (21 Tools)
- `shortenUrl`: Create branded short links with custom aliases, password protection, and auto-expiry.
- `bulkShortenUrls`: Mass-shorten batches of links in a single operation.
- `updateUrl`: Change destination URLs in real-time without breaking short links or QR codes (supports bulk updates).
- `listUrls`: Search and filter your link inventory with advanced pagination and sorting.
- `getUrl`: Retrieve destination URL, settings, and short code details.
- `deleteUrl`: Safely decommission and permanently remove short links.
- `checkAliasAvailability`: Instantly verify custom alias availability before creation.
- `lookupUrl`: Detect existing short URLs for any destination to prevent duplicates.

### 2. 🔳 Dynamic QR Code Suite (15 Tools)
- `generateQr`: Create dynamic and static QR codes for URLs, WiFi access, vCards, SMS, Text, and Email.
- `listQrCodes`: Search, list, and manage your visual asset library.
- `getShortUrlQr`: Automatically generate trackable QR codes linked directly to any short URL.
- `updateQr`: Edit dynamic QR destinations and visual styling without re-printing physical materials.

### 3. 📱 Link-in-Bio Creator (10 Tools)
*Built for creators, influencers, and brands to launch mobile profiles and Bento grids directly via AI.*
- `checkLinkInBioSlug`: Verify custom alias availability with suggestions and 5-minute Redis reservation lock.
- `browseBioCatalog`: Search themes (`minimal-dark`, `bento-modern`, `neon-cyberpunk`, `glassmorphism`) and 16+ industry categories (Developer, Gaming, Fitness, Culinary, Music, Web3, Education, Real Estate).
- `getBioBlockSchema`: Lazy-load structural JSON validation schemas and designer tips for widgets (lead capture, streaming status, crypto tickers, digital menus, syllabus cards).
- `createLinkInBioPage`: Create bio page draft with title, custom slug, theme, and initial profile info.
- `getLinkInBioPage`: Retrieve bio structure, configured widgets, profile header, and visual settings.
- `updateBioContent`: Update and auto-save avatar, bio, badges, CTA button, announcement bar, and widget blocks.
- `updateLinkInBioSettings`: Configure SEO meta tags, custom domain routing, password protection, and tracking pixels (GA4, Meta, TikTok, GTM, Snap, Reddit, Pinterest).
- `publishLinkInBioPage`: Trigger SSR compilation, bind Connextify short link, generate dynamic QR code, and deploy to edge.
- `listLinkInBioPages`: List created bio pages with status filters, search, and visitor telemetry.
- `getLinkInBioSubmissions`: Retrieve captured newsletter leads and form inquiries.

### 4. 📄 Responsive Landing Page Builder (13 Tools)
*Full-canvas responsive landing page builder powered by GrapesJS.*
- `checkLandingPageSlug`: Verify slug availability across default or custom domains with reservation locking.
- `listLandingPageTemplates`: Browse system and user starter templates by category (SaaS, Agency, Mobile App, Lead Gen, Portfolio).
- `getLandingPageTemplate`: Fetch complete project JSON, sections, and styling for a template ID.
- `getLandingPageBlockSchema`: Lazy-load structural schemas for GrapesJS blocks (hero, features_grid, comparison_table, pricing_table, dedicated_cta, footer, faq_accordion).
- `createLandingPage`: Create landing page draft with structured section blocks and design tokens (auto-compiled to responsive HTML5 & CSS).
- `getLandingPage`: Retrieve landing page details, structured document (`LandingPageDoc`), and compiled HTML/CSS.
- `updateLandingPageContent`: Update section blocks, design tokens, or direct custom HTML/CSS.
- `updateLandingPageSettings`: Configure SEO meta tags, OpenGraph preview, custom domain routing, password protection, and tracking pixels.
- `publishLandingPage`: Compile responsive HTML5/CSS, bind Connextify short link, generate dynamic QR code, and deploy to global edge.
- `unpublishLandingPage`: Revert a live landing page back to draft status.
- `listLandingPages`: List pages with pagination, search, status filters, and subscriber metrics.
- `getLandingPageAnalytics`: Fetch views, unique visitors, device breakdown, top countries/cities, and referrers.
- `deleteLandingPage`: Soft delete a landing page and release its slug.

### 5. 📊 Micro-Detail Marketing Analytics (21 Tools)
- `getStats`: Real-time clicks, unique visitors, conversion metrics, and period-over-period growth rates.
- `getGeographicStats`: Granular traffic breakdown by **Country**, **Region (State/Province)**, and **City**.
- `getDeviceAnalytics`: Visitor technographics including **Mobile, Desktop, Tablet**, OS version, and browser engine.
- `getTrafficQuality`: Traffic quality auditing, bot classification, and human click ratios.
- `getReferrerStats`: Attribution tracking across social networks, search engines, and referring domains.
- `getOverviewStats`: Account-wide marketing health and performance summaries.

### 6. 🌐 Branded Domains & Subdomains (17 Tools)
- `createSubdomain`: Provision and verify custom branded subdomains (e.g., `go.yourbrand.com`).
- `listSubdomains`: Inspect DNS verification status and active subdomains.
- `createBrandedDomain` / `verifyDomain`: Manage apex branded domains with automated edge SSL certificates.

### 7. 🧪 A/B Testing & Conversions (9 Tools)
- `createSplitTest`: Deploy multi-variant link testing with percentage traffic routing.
- `getSplitTestStats`: Compare conversion performance between destination variants.

### 8. 👥 Campaign Management (9 Tools)
- `createCampaign`: Organize your links, QR codes, and pages into coordinated marketing campaigns.
- `listCampaigns`: Track link and conversion performance at the campaign level.

### 9. 💳 Account & Usage Telemetry (1 Tool)
- `getSubscriptionStatus`: Check active plan tier, feature flags, hourly/daily execution quotas, and trial status.

---

## 🚀 Quick Setup

### 1. Obtain Your API Key
1. Sign in to [app.connextify.com](https://app.connextify.com).
2. Navigate to **Dashboard > API Keys**.
3. Create a key and ensure the **MCP Channel** is enabled.

### 2. Integration Guides

#### ☁️ Claude Desktop
Add this entry to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "connextify": {
      "command": "npx",
      "args": [
        "-y",
        "connextify-mcp-server"
      ],
      "env": {
        "CONNEXTIFY_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

#### 💻 Cursor / AI IDEs
Configure a **Remote SSE** connection in your IDE settings:
- **Type:** Server-Sent Events (SSE)
- **URL:** `https://connextify.com/mcp/sse`
- **Auth Header:** `x-mcp-key: your_api_key_here`

#### 🌐 Claude.ai Web Connector
- **Type:** MCP (SSE)
- **URL:** `https://connextify.com/mcp/sse`
- **Auth Header:** `x-mcp-key: your_api_key_here`

#### ⚡ n8n Automation
- Add an **MCP Node** or HTTP Request node in your workflow.
- Set endpoint URL to `https://connextify.com/mcp`.
- Header: `x-mcp-key: your_api_key_here`.

---

## 💡 Example AI Prompts

- *"Shorten https://connextify.com/blog/mcp-guide with custom alias 'mcp-starter' and generate a vector QR code for it."*
- *"Build a Link-in-Bio profile for a fitness trainer named Sarah with theme 'minimal-dark', workout routine block, and lead capture form."*
- *"Create a SaaS landing page draft called 'DevMetrics Platform' using the SaaS template with hero, feature grid, pricing table, and publish it."*
- *"Analyze traffic quality and check city-level clicks for my 'Summer Campaign' links over the last 30 days."*

---

## 🛡️ Security & Privacy Notice

If you see security notices regarding **"Network Access"** (e.g., from Socket.dev):
- **Purpose of Network Access:** This package is a lightweight **Bridge Server**. Its sole purpose is to proxy JSON-RPC requests from your local machine to the official Connextify API over encrypted HTTPS (TLS 1.3).
- **No Remote Code Execution:** The bridge logic is fully open source within `index.js`. It does not download or execute remote scripts.
- **Audit:** Audit the bridge logic directly in our [GitHub repository](https://github.com/connextify-com/connextify-mcp-server).

---

## 📄 Resources
- **Homepage:** [connextify.com](https://connextify.com)
- **Documentation:** [connextify.com/docs/mcp](https://connextify.com/docs/mcp)
- **GitHub Repository:** [github.com/connextify-com/connextify-mcp-server](https://github.com/connextify-com/connextify-mcp-server)
- **System Status:** [connextify.com/status](https://connextify.com/status)
- **Support:** [support@connextify.com](mailto:support@connextify.com)

Built with ❤️ for a better-connected web by the [Connextify Team](https://connextify.com).