🤖 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 70+ 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

Sign in to app.jmpy.me.
Navigate to Dashboard > API Keys.
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 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)=>{res.pipe(process.stdout);});process.stdin.pipe(req);"
      ],
      "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.

📄 Resources

Organization Profile: github.com/jmpy-me
Technical Support: support@jmpy.me
Terms of Service: jmpy.me/terms

Built with ❤️ for a better-connected web by the Jmpy.me Team.

jmpy-mcp-server