{
  "markdown": "# 🤖 Jmpy.me Official MCP Server\n\n[![Status](https://img.shields.io/badge/System_Status-Online-green?style=for-the-badge)](https://jmpy.me/status)\n[![MCP](https://img.shields.io/badge/MCP-Ready-blue?style=for-the-badge)](https://modelcontextprotocol.io)\n[![Docs](https://img.shields.io/badge/Documentation-View_Docs-orange?style=for-the-badge)](https://jmpy.me/docs/mcp)\n\nUnlock 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.\n\n---\n\n## 🛠️ Performance-Grade Tools\n\nOur MCP server exposes a rich suite of 72+ tools, optimized for AI discovery and execution:\n\n### 🔗 Link Management\n- `shortenUrl`: Create branded short links with custom aliases, password protection, and expiration.\n- `updateUrl`: Change destination URLs in real-time without breaking existing short links.\n- `listUrls`: Search and filter your link inventory with advanced pagination.\n- `lookupUrl`: Detect existing short URLs for any destination to prevent duplicates.\n\n### 🔳 Advanced QR Suite\n- `generateQr`: Create dynamic, branded QR codes for URLs, WiFi, vCards, Text, and SMS.\n- `listQrCodes`: Manage your entire library of visual assets.\n- `customStyleQr`: (Coming Soon) Programmatic control over logo overlays and branding colors.\n\n### 📊 Marketing Analytics\n- `getStats`: Real-time performance metrics (clicks, uniqueness, growth rates).\n- `getGeographicStats`: Deep-dive into traffic by country and city for precise targeting.\n- `getDeviceAnalytics`: Analyze audience technographics (browser, OS, device type).\n- `getOverviewStats`: Account-wide marketing health and performance summaries.\n\n### 👥 Team & Campaigns\n- `createCampaign`: Organize your marketing efforts into logical groups.\n- `listCampaigns`: Track link performance at the campaign level.\n- `createSubdomain`: Provision and verify custom subdomains (e.g., `brand.jmpy.me`).\n\n---\n\n## 🚀 Quick Setup\n\n### 1. Obtain Your API Key\n1. Sign in to [app.jmpy.me](https://app.jmpy.me).\n2. Navigate to **Dashboard > API Keys**.\n3. Create a key and ensure the **MCP Channel** is enabled.\n\n### 2. Integration Guides\n\n#### ☁️ Claude Desktop\nAdd this entry to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"jmpy\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"jmpy-mcp-server\"\n      ],\n      \"env\": {\n        \"JMPY_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n#### 💻 Cursor / AI IDEs\nConfigure a **Remote SSE** connection in your IDE settings:\n- **Type:** Server-Sent Events (SSE)\n- **URL:** `https://jmpy.me/mcp/sse`\n- **Auth Header:** `x-mcp-key: your_api_key`\n\n---\n\n## 💡 Example AI Prompts\n\n- *\"Shorten https://google.com/search?q=mcp-protocol with a custom alias 'mcp-guide' and make a QR code for it.\"*\n- *\"Check the analytics for my 'Summer Sale' campaign and tell me which city is clicking the most.\"*\n- *\"I need to redirect all links for jmpy.me/old-promo to a new destination: https://jmpy.me/new-landing.\"*\n\n---\n\n## 🛡️ Security & Reliability\n\n- **Encrypted Transport:** All communication occurs over HTTPS with TLS 1.3.\n- **Unified Auth:** Managed via the `x-mcp-key` header to ensure your account is only accessible by your authorized agents.\n- **Bot Detection:** Integrated classification identifies and filters automated traffic for accurate marketing data.\n- **Uptime Monitoring:** Real-time health checks available at [jmpy.me/status](https://jmpy.me/status).\n\n---\n\n## 📄 Resources\n- **Organization Profile:** [github.com/jmpy-me](https://github.com/jmpy-me)\n- **Technical Support:** [support@jmpy.me](mailto:support@jmpy.me)\n- **Terms of Service:** [jmpy.me/terms](https://jmpy.me/terms)\n\nBuilt with ❤️ for a better-connected web by the [Jmpy.me Team](https://jmpy.me).\n",
  "bytes": 3904,
  "sha": "c979ec65707a2dc81b21386f539ce0c1682aed73fddd2cffe50f54cee0ecac17",
  "repo_slug": "jmpy-me/jmpy-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jmpy_me_jmpy_mcp_server_3fb39bc7/readme"
}