🤖 Jmpy.me Official MCP Server

Unlock the power 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

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

🔗 Link Management

• shortenUrl: Create branded short links with custom aliases, password protection, and expiration.
• updateUrl: Change destination URLs in real-time without breaking existing short links.
• listUrls: Search and filter your link inventory with advanced pagination.
• lookupUrl: Detect existing short URLs for any destination to prevent duplicates.

🔳 Advanced QR Suite

• generateQr: Create dynamic, branded QR codes for URLs, WiFi, vCards, Text, and SMS.
• listQrCodes: Manage your entire library of visual assets.
• customStyleQr: (Coming Soon) Programmatic control over logo overlays and branding colors.

📊 Marketing Analytics

• getStats: Real-time performance metrics (clicks, uniqueness, growth rates).
• getGeographicStats: Deep-dive into traffic by country and city for precise targeting.
• getDeviceAnalytics: Analyze audience technographics (browser, OS, device type).
• getOverviewStats: Account-wide marketing health and performance summaries.

👥 Team & Campaigns

• createCampaign: Organize your marketing efforts into logical groups.
• listCampaigns: Track link performance at the campaign level.
• createSubdomain: Provision and verify custom subdomains (e.g., brand.jmpy.me).

🚀 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 Guides

☁️ Claude Desktop

Add this entry to your claude_desktop_config.json:

{
  "mcpServers": {
    "jmpy": {
      "command": "node",
      "args": [
        "-e",
        "const http=require('https');const rl=require('readline').createInterface({input:process.stdin});rl.on('line',(line)=>{if(!line.trim())return;const req=http.request({hostname:'jmpy.me',port:443,path:'/mcp',method:'POST',headers:{'Content-Type':'application/json','x-mcp-key':process.env.JMPY_API_KEY}},(res)=>{let d='';res.on('data',(c)=>d+=c);res.on('end',()=>{if(d)process.stdout.write(d+'\\n');});});req.write(line);req.end();});"
      ],
      "env": {
        "JMPY_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://jmpy.me/mcp/sse
• Auth Header: x-mcp-key: your_api_key

💡 Example AI Prompts

• "Shorten https://google.com/search?q=mcp-protocol with a custom alias 'mcp-guide' and make a QR code for it."
• "Check the analytics for my 'Summer Sale' campaign and tell me which city is clicking the most."
• "I need to redirect all links for jmpy.me/old-promo to a new destination: https://jmpy.me/new-landing."

🛡️ Security & Reliability

• Encrypted Transport: All communication occurs over HTTPS with TLS 1.3.
• Unified Auth: Managed via the x-mcp-key header to ensure your account is only accessible by your authorized agents.
• Bot Detection: Integrated classification identifies and filters automated traffic for accurate marketing data.
• Uptime Monitoring: Real-time health checks available at [jmpy.me/status](https://jmpy.me

... View full README on GitHub