🤖 Jmpy.me Official MCP Server

Unlock the full potential of Jmpy.me directly within your AI agents. This official Model Context Protocol (MCP) server provides a high-performance bridge for AI assistants (Claude, ChatGPT, Cursor) to manage branded links, dynamic QR codes, and deep marketing analytics using natural language.

🛠️ Performance-Grade Tools

This server exposes a rich suite of 72+ tools, optimized for AI discovery and execution:

🔗 Link Management & Automation

• Dynamic Shortening: Create branded short URLs with custom aliases instantly.
• Built-in UTM Builder: Programmatically attach UTM parameters (Source, Medium, Campaign, Term, Content) for professional tracking.
• Real-Time Destination Editing: Update the target URL of any existing link without breaking the short link or QR code.
• Advanced Security:
  • Password Protection: Secure links with custom passwords for private distribution.
  • Link Expiration: Set auto-expiry based on specific dates or maximum click counts.
• Bulk Operations: Handle large-scale link creation and management in a single turn.
• Smart Discovery: Lookup existing short links for any URL to prevent duplication and maintain database hygiene.

🔳 Advanced QR Code Suite

• Dynamic QR Generation: Generate high-resolution QR codes for any short link. Since the links are dynamic, you can change the destination later without reprinting the QR code.
• Multimodal Support: Create QR codes for:
  • URLs & Links
  • WiFi Access (SSID, Password, Encryption Type)
  • vCards (Digital Business Cards)
  • SMS, Email, & Phone triggers
  • Plain Text
• Custom Branding: (Coming Soon) API support for logo overlays, custom colors, and pixel styling.
• Asset Management: Search, list, and manage your entire visual asset library.

📊 Micro-Detail Marketing Analytics

Get granular, real-time insights into every click with precision data:

• Core Metrics: Total clicks, unique visitors, and growth rates.
• Deep Geographic Intelligence:
  • Location: Detailed breakdown by Country, Region (State/Province), and City.
  • Precision: Identify high-performing markets with city-level accuracy.
• Audience Technographics:
  • Device Profiles: Identify if users are on Mobile, Desktop, Tablet, or Smart TVs.
  • Operating Systems: Precise detection of iOS, Android, Windows, macOS, and Linux versions.
  • Browser Engines: Granular data on Chrome, Safari, Firefox, Edge, Opera, and more.
  • Hardware Models: Identify specific hardware like iPhone 15, Samsung Galaxy S24, or MacBook M3.
• Traffic Origin: Track Referrer URLs to see exactly which social platforms or websites are driving traffic.
• Campaign Analytics: Aggregate performance data across campaigns and custom subdomains.

🚀 Quick Setup

1. Obtain Your API Key

1. Sign in to app.jmpy.me.
2. Navigate to Dashboard > API Keys.
3. Create a key and ensure the MCP Channel is enabled.

2. Integration with Claude Desktop

Add this entry to your claude_desktop_config.json:

{
  "mcpServers": {
    "jmpy": {
      "command": "npx",
      "args": [
        "-y",
        "jmpy-mcp-server"
      ],
      "env": {
        "JMPY_API_KEY": "YOUR_ACTUAL_API_KEY"
      }
    }
  }
}

🛡️ Security & Privacy Notice

If you see security warnings regarding "Network Access" or "Supply Chain Risk" (e.g., from Socket.dev), please note:

• Purpose of Network Access: This package is a Bridge Server. Its sole purpose is to proxy JSON-RPC requests from your local machine to the official Jmpy.me API over HTTPS.
• No Remotely Hosted Code: The bridge logic is fully contained within index.js. It does not download or execute remote scripts.
• Encrypted Transport: All communication uses TLS 1.3 to ensure your data and API keys remain private.
• Open Source: Audit the logic directly in the package repository.

💡 Example AI Prompts

• "Shorten https://google.com with UTMs for my 'Summer Sale' and generate a vCard QR code for my contact info."
• "Show me a breakdown of clicks by city and device model for my latest short link."
• "Password protect the link jmpy.me/secret and set it to expire after 50 clicks."

📄 Resources

• Homepage: jmpy.me
• Documentation: jmpy.me/docs/mcp
• Support: [email protected]

Built with ❤️ by the Jmpy.me Team.