jmpy-mcp
Jmpy.me is a comprehensive link management and marketing platform designed to help creators, developers, and businesses take control of their digital footprint.
Community: Submitted by a user or imported; check the owner before granting accessOnlineAPI key requiredGlobalFreeCan modify data
What it can do
- ShortenUrl: ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If
- BulkShortenUrls: ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE*
- ListUrls: ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a
What data it sees
Do you need an account
An API key from the service settings is required
Jmpy.me is a comprehensive link management and marketing platform designed to help creators, developers, and businesses take control of their digital footprint. By moving beyond generic link shorteners, Jmpy.me allows users to brand, track, and optimize every interaction.
Key Features Branded Links: Create memorable, trustworthy URLs using your own custom domain or free subdomains to increase click-through rates.
Dynamic QR Codes: Generate high-conversion QR codes that can be updated instantly even after they are printed, eliminating the need for costly reprinting.
Actionable Analytics: Gain real-time insights into your traffic, including geographic location, device types, and referrer data, all presented in a unified dashboard.
Smart Tools: Utilize built-in features like a UTM parameter builder, A/B testing engine, link-in-bio pages, and password-protected links.
Developer Friendly: Integrate link generation directly into your own applications via a robust REST API and Model Context Protocol (MCP) server.
Whether you are looking to slash marketing costs by optimizing SMS campaigns, protect your brand reputation with isolated link infrastructure, or drive engagement with professional-grade assets, Jmpy.me provides the essential toolkit to own your brand, click by click.
Server tool list (60)
Raw names from tools/list. Only developers need these.
| shortenUrl | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. JMPY Link Management: Create a professional branded short URL. Use this for link sharing, campaigns, and social media. Note: This is a separate product from the standalone QR Code Generator. USE THIS TOOL WHEN: User says "shorten a link", "shorten url", "shorten this", "create short url", "create short link", or similar phrases. WHEN TO USE: User wants to create a new shortened URL from a long URL. They may mention 'shorten', 'create short link', or provide a long URL. WHEN NOT TO USE: User wants to view existing URLs (use listUrls), update an existing URL (use updateUrl), or get stats (use getStats). REQUIRED PARAMETERS: url OPTIONAL PARAMETERS: name, custom_alias, expires_at, tracking_enabled, password, qrCode, qrFormat, format, url_type, subdomain, branded_domain SEE ALSO: listUrls |
| bulkShortenUrls | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Create multiple short URLs in a single batch (mass shortening). Use this when the user says "shorten these 10 links", "bulk create urls", or provides a list of destinations. Ideal for campaign setups and high-volume link creation. OPTIONAL PARAMETERS: csv_content, qrCode, qrFormat, format, urls, expires_at |
| listUrls | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get a list of all your short URLs (also known as shortened links or short links). Use this when the user asks to "get short list", "show my links", "list urls", "see all urls", or "view my shortened urls". Supports optional filtering, search, and pagination. USE THIS TOOL WHEN: User says "get short list", "show my links", "list urls", "list my urls", "see all urls", or similar phrases. WHEN TO USE: User wants to see their existing short URLs. Phrases like 'get short list', 'show my links', 'list urls', 'my urls', 'see all urls' indicate this. WHEN NOT TO USE: User wants to create a new URL (use shortenUrl), or get details of a specific URL (use getUrl). OPTIONAL PARAMETERS: page, limit, search, dateRange, startDate, endDate, urlType, campaignId, source, sortBy, sortOrder, qrCode, qrFormat, format SEE ALSO: getUserUrlCount, getUserUrlStats |
| getUrl | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get details of a shortened URL by short code (e.g., "abc123") or custom alias. No UUID lookup required. NOTE: This may return multiple results if the same code exists across different domain contexts (standard, subdomain, branded). USE THIS TOOL WHEN: User says "get url details", "show link info", "lookup short code", "get link", "url info", or similar phrases. WHEN TO USE: User wants details about a specific short URL by its code or alias. They know the short code like 'abc123' or a custom alias. WHEN NOT TO USE: User wants to list all URLs (use listUrls) or get click statistics (use getStats). REQUIRED PARAMETERS: shortCode OPTIONAL PARAMETERS: url_type, subdomain, branded_domain |
| updateUrl | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Update one or more existing short URLs (Bulk Optimized). Use this for mass-updating link destinations, names, aliases, or domains. WARNING: Changing the custom_alias, url_type, branded_domain, or subdomain will change the final short link URL and break existing links. You MUST explicitly ask the user for confirmation before changing these fields. USE THIS TOOL WHEN: User says "change url", "update link", "edit short url", "modify url", "update url", or similar phrases. WHEN TO USE: User wants to change one or MORE existing short URLs. If multiple codes are provided, use the array mode for 'shortCode' (BULK UPDATE) for maximum performance. REMEMBER: Every JMPY link is dynamic; just update its target. WHEN NOT TO USE: User wants to create a brand new URL (use shortenUrl). NEVER use deleteUrl + shortenUrl to change a link's destination; always use updateUrl to preserve the short code. OPTIONAL PARAMETERS: shortCode, url, name, expires_at, custom_alias, tracking_enabled, qrCode, qrFormat, format, url_type, subdomain, branded_domain, urls SEE ALSO: deleteUrl |
| deleteUrl | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Delete a shortened URL by short code (e.g., "abc123"). No UUID lookup required - use the short code directly. USE THIS TOOL WHEN: User says "delete url", "remove link", "delete short url", "remove url", "delete link", or similar phrases. WHEN TO USE: User explicitly wants to delete or remove a short URL. This is destructive and permanent. WHEN NOT TO USE: User wants to update a URL (use updateUrl) or just view it (use getUrl). REQUIRED PARAMETERS: shortCode OPTIONAL PARAMETERS: url_type, subdomain, branded_domain SEE ALSO: updateUrl |
| checkAliasAvailability | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Check if a custom alias is available for use USE THIS TOOL WHEN: User says "check alias", "is alias available", "alias available", "check custom alias", "can i use alias", or similar phrases. WHEN TO USE: User wants to check if a custom alias is available before creating a short URL. WHEN NOT TO USE: User is ready to create the URL (use shortenUrl directly, it handles conflicts). REQUIRED PARAMETERS: alias |
| getUrlAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Premium Analytics Overview: Get comprehensive statistics for your short URLs. Use this for general statistics, click trends, top performing links, and performance overviews. This tool is HIGHLY VERSATILE: it can analyze a single short URL, multiple URLs (bulk), or your entire link portfolio. Supports date ranges (e.g., last 30 days) or specific days. USE THIS TOOL WHEN: User says "url analytics", "link analytics", "traffic source", "referrer data", "where clicks from", or similar phrases. WHEN TO USE: User wants detailed analytics including referrers and traffic sources for a URL. WHEN NOT TO USE: User wants basic click counts (use getUrlStats) or complete analytics (use getCompleteAnalytics). OPTIONAL PARAMETERS: page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder SEE ALSO: getStats |
| getUrlTimelineAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Premium Timeline Analytics: Get click trends and historical data (hourly, daily, weekly). Supports account-wide stats, multiple links (bulk), or a single specific link. You can filter by date range or specific days. OPTIONAL PARAMETERS: granularity, page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder |
| getUrlGeographicAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Premium Geographic Analytics: Get distribution of clicks by Country, Region, and City. Supports account-wide stats, multiple links (bulk), or a single specific link. You can filter by date range (e.g., last 30 days) or specific days. USE THIS TOOL WHEN: User says "geographic data", "location stats", "country stats", "where are clicks from", "visitor locations", or similar phrases. WHEN TO USE: User wants location/country data about where clicks are coming from. WHEN NOT TO USE: User wants general click stats (use getStats) or device info (use getUrlDeviceAnalytics). OPTIONAL PARAMETERS: shortUrlId, page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder SEE ALSO: getUrlDeviceAnalytics |
| getUrlDeviceAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Device Analytics: Get device type, OS, and browser breakdown for your traffic. Understand how your audience accesses your links. This tool supports powerful precision filtering: analyze a single short URL (via shortCode), multiple specific URLs (via comma-separated shortCodes), or your entire link portfolio for a specific date range. USE THIS TOOL WHEN: User says "device analytics", "browser stats", "device data", "mobile vs desktop", "device breakdown", or similar phrases. WHEN TO USE: User wants to see device, browser, and OS breakdown for clicks. WHEN NOT TO USE: User wants geographic data (use getUrlGeographicAnalytics) or general stats (use getStats). OPTIONAL PARAMETERS: shortUrlId, page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder SEE ALSO: getUrlGeographicAnalytics |
| getUrlUTMAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. UTM Marketing Analytics: Track UTM parameters (Source, Medium, Campaign, Term, Content). Supports account-wide stats, multiple links (bulk), or a single specific link. You can filter by date range (e.g., last 30 days) or specific days. USE THIS TOOL WHEN: User says "utm analytics", "campaign analytics", "utm data", "campaign tracking", "utm parameters", or similar phrases. WHEN TO USE: User wants to see UTM campaign tracking data and marketing attribution. WHEN NOT TO USE: User wants general analytics (use getStats) or device data (use getUrlDeviceAnalytics). OPTIONAL PARAMETERS: shortUrlId, page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder SEE ALSO: getUrlsWithUtm |
| getUrlTrafficQualityAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Premium Traffic Integrity: Analyze bot traffic vs human interaction and assess overall traffic quality. Essential for verifying traffic integrity. Metrics provided: human_clicks (Total organic engagement from real users, including high-intent QR scans), bot_clicks (Total automated traffic), social_bot_clicks (Traffic from social previews like WhatsApp, LinkedIn), crawler_clicks (Traffic from search engine bots), bot_percentage (Ratio of bot traffic to total), and traffic_health (Status indicator: "good" if human traffic > bot traffic, "poor" if bot traffic dominates, suggesting low-quality engagement). Support filtering by single/multiple shortCodes or entire portfolio. OPTIONAL PARAMETERS: shortCodes, dateRange, days |
| getUrlClickLogs | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Raw Interaction Logs (Row-per-Click): Access granular, row-by-row interaction data for deep-dive forensics and audit trails. Each record represent a single click/scan event and contains: - Time & Context: Precise timestamp (clicked_at), session identifiers, and uniqueness flags. - Traffic Attribution: Referral source (referer), traffic medium (e.g., social, search, direct), and traffic source (e.g., Facebook, Google). - Marketing Data: Full UTM parameter suite (utm_source, utm_medium, utm_campaign, utm_term, utm_content). - Geography & Local: Country, region, city, timezone, and approximate lat/long coordinates. - Technology & Security: Device type (mobile/desktop), OS, browser, anonymized IP, and bot classification (bot_name, bot_category). - Interaction Type: Identification of QR scans vs. organic clicks and prefetch detection. This feature is exclusive to Enterprise plans and is restricted for trial accounts. Supports complex filtering by shortCodes, date ranges, and includes pagination. OPTIONAL PARAMETERS: shortCodes, dateRange, days, page, limit |
| getUrlRecentActivityAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Recent Interaction Feed: Get a real-time feed of the most recent clicks across your link portfolio. By default, this covers ALL your short links, but you can filter for a single short URL (via shortCode) or multiple URLs (via comma-separated shortCodes). Ideal for monitoring live campaign activity. OPTIONAL PARAMETERS: shortCodes, limit |
| getUrlTopPerformersAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Premium Performance Ranking: Identify your best-performing short URLs based on click volume. This is a portfolio-wide ranking by default. Supports powerful filtering by date range to see winners for specific periods. You can also filter this ranking for a specific subset of links (via comma-separated shortCodes). OPTIONAL PARAMETERS: shortCodes, limit, dateRange, days |
| getUrlCreationSourceAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Premium Source Distribution: Analyze how your links were created (e.g., via Web App, API, Bulk Import). Essential for workflow optimization and usage audits. OPTIONAL PARAMETERS: dateRange |
| getQrAnalyticsOverview | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Premium QR Overview: Get comprehensive scan statistics for all your QR codes (portfolio-wide). Use this for total scans, unique scanners, growth rates, and a high-level performance summary. Supports date range filtering to analyze specific periods. OPTIONAL PARAMETERS: dateRange, days |
| getQrTimelineAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. QR Scan Timeline: Visualize scan trends over time for all your QR codes (portfolio-wide). Ideal for tracking the success of physical marketing campaigns across hourly, daily, or weekly intervals. Supports flexible day-lookback filtering. OPTIONAL PARAMETERS: days, granularity |
| getQrGeographicAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. QR Geographic Insights: See where all your QR codes are being scanned (Country and City level). This is a portfolio-wide view that reveals the geographic reach of your physical placements. Supports filtering by date. OPTIONAL PARAMETERS: days |
| getQrDeviceAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. QR Technology Breakdown: Analyze the devices, OS, and browsers used by scanners across your entire QR portfolio. Essential for optimizing mobile landing page experiences. Supports filtering by date. OPTIONAL PARAMETERS: days |
| getQrTrafficAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. QR Traffic Sources: Identify referrers and traffic categories for your QR scans portfolio-wide. Understand if users are scanning from specific apps or direct environments. Supports filtering by date. OPTIONAL PARAMETERS: days |
| getQrTopPerformersAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Top Performing QR Codes: Identify your most successful QR codes from your entire portfolio based on scan count and recent activity. Supports filtering by period to identify recent trending QR codes. OPTIONAL PARAMETERS: limit, days |
| checkSubdomainAvailabilityUrl | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Check if a subdomain is available for use USE THIS TOOL WHEN: User says "check subdomain", "is subdomain available", "subdomain available", "can i use subdomain", "verify subdomain", or similar phrases. WHEN TO USE: User wants to check if a subdomain is available on jmpy.me. WHEN NOT TO USE: User wants to create a subdomain (use createSubdomain after checking). REQUIRED PARAMETERS: subdomain |
| verifySubdomain | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Verify ownership of a subdomain prefix on jmpy.me USE THIS TOOL WHEN: User says "verify subdomain", "confirm subdomain", "subdomain verification", or similar phrases. WHEN TO USE: User needs to verify ownership of a subdomain they registered. WHEN NOT TO USE: User wants to list subdomains (use getUserDomains). REQUIRED PARAMETERS: subdomain |
| getShortUrlQr | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get a professional trackable QR code for any short URL using its short code and context (subdomain/branded domain). This is the recommended method for retrieving QR codes for existing short links. OPTIONAL PARAMETERS: shortCode, url, url_type, subdomain, branded_domain, qrFormat, format |
| generateQr | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. JMPY QR Generator: Create standalone professional QR codes (Static or Dynamic) for URLs, WiFi, vCards, etc. Use this tool for standalone QR products. For Dynamic QRs, set is_dynamic: true. USE THIS TOOL WHEN: User says "create qr", "make qr code", "generate qr", "qr code", "generate barcode", or similar phrases. WHEN TO USE: User wants to create a new QR code for a URL, text, WiFi, vCard, or other content. WHEN NOT TO USE: User wants to view existing QR codes (use listQrCodes) or update one (use updateQrCode). REQUIRED PARAMETERS: content_type, content_data OPTIONAL PARAMETERS: name, is_dynamic, tracking_enabled, visual_settings, qr_format, url_type, branded_domain, subdomain, expires_at SEE ALSO: listQrCodes |
| listQrCodes | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get a list of your QR codes with optional filtering USE THIS TOOL WHEN: User says "show my qr codes", "list qr", "get qr list", "my qr codes", "all qr codes", or similar phrases. WHEN TO USE: User wants to see their existing QR codes. Similar to listUrls but for QR codes. WHEN NOT TO USE: User wants to create a new QR code (use generateQr). OPTIONAL PARAMETERS: page, limit, qrType SEE ALSO: getQrCodeCount |
| getQrCode | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get details of a specific QR code by ID USE THIS TOOL WHEN: User says "get qr details", "qr info", "show qr code", "qr code details", "find qr", or similar phrases. WHEN TO USE: User wants details about a specific QR code by its ID. WHEN NOT TO USE: User wants to list QR codes (use listQrCodes) or get scan analytics (use getQrCodeAnalytics). REQUIRED PARAMETERS: id |
| updateQrCode | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Update an existing QR code (name, content, visual settings) USE THIS TOOL WHEN: User says "update qr", "edit qr code", "change qr", "modify qr", "update qr code", or similar phrases. WHEN TO USE: User wants to modify an existing QR code's content or styling. WHEN NOT TO USE: User wants to create a new QR code (use generateQr) or delete one (use deleteQrCode). REQUIRED PARAMETERS: id OPTIONAL PARAMETERS: name, content_data, visual_settings, tracking_enabled, is_dynamic, expires_at, is_password_protected, password, content_type SEE ALSO: deleteQrCode |
| deleteQrCode | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Delete a QR code USE THIS TOOL WHEN: User says "delete qr", "remove qr code", "delete qr code", "remove qr", "trash qr", or similar phrases. WHEN TO USE: User explicitly wants to delete a QR code. This is destructive. WHEN NOT TO USE: User wants to update (use updateQrCode) or view (use getQrCode) the QR code. REQUIRED PARAMETERS: id SEE ALSO: updateQrCode |
| trackQrScan | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Record a QR code scan event for analytics USE THIS TOOL WHEN: User says "track qr scan", "record qr scan", "log qr scan", or similar phrases. WHEN TO USE: System needs to record a QR code scan event (typically internal use). WHEN NOT TO USE: User wants to view scan data (use getQrCodeStats). REQUIRED PARAMETERS: id OPTIONAL PARAMETERS: userAgent, referrer |
| getTrackedQrCount | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get count of QR codes with tracking enabled USE THIS TOOL WHEN: User says "tracking count", "tracked qr count", "how many tracked qr codes", "count of tracked qr codes", or similar phrases. |
| getStats | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get performance overview for your short URLs. By default, it returns a 30-day summary for all active links (excluding QR scans). You can filter by one or multiple "shortCodes" to see stats for specific URLs, or use "dateRange" to adjust the time window. USE THIS TOOL WHEN: User says "get statistics", "show stats", "analytics", "click data", "performance data", or similar phrases. WHEN TO USE: User wants click statistics and performance data for a specific short URL. WHEN NOT TO USE: User wants to list URLs (use listUrls) or geographic data specifically (use getUrlGeographicAnalytics). OPTIONAL PARAMETERS: page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder |
| getGeographicStats | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get geographic distribution (countries, regions, cities) for your URLs. Supports batch analysis of specific links via "shortCodes" and time-filtering via "dateRange". Defaults to last 30 days of global traffic. OPTIONAL PARAMETERS: page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder |
| getUtmAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get UTM campaign analytics for a shortened URL REQUIRED PARAMETERS: shortUrlId OPTIONAL PARAMETERS: page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder |
| getDeviceAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get device and browser analytics for a shortened URL OPTIONAL PARAMETERS: shortUrlId, page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder |
| getCompleteAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get all analytics data for a short URL in one request USE THIS TOOL WHEN: User says "complete analytics", "full analytics", "all analytics", "comprehensive stats", "everything about", or similar phrases. WHEN TO USE: User wants ALL analytics data for a URL - clicks, geography, devices, UTM, referrers - in one call. WHEN NOT TO USE: User only needs specific analytics type (use specialized tools for efficiency). REQUIRED PARAMETERS: shortUrlId OPTIONAL PARAMETERS: startDate, endDate |
| getOverviewStats | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get high-level overview statistics for all your short URLs and QR codes. Includes totals, today's activity, and growth comparisons. USE THIS TOOL WHEN: User says "overview stats", "summary stats", "dashboard stats", "quick stats", or similar phrases. WHEN TO USE: User wants an account-wide overview of their URL performance. WHEN NOT TO USE: User wants stats for a specific URL (use getStats). OPTIONAL PARAMETERS: page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder |
| getClicksTimeline | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get multi-series timeline data for clicks and scans over time. Useful for creating performance charts. USE THIS TOOL WHEN: User says "clicks over time", "timeline", "click history", "clicks by day", "historical data", or similar phrases. WHEN TO USE: User wants to see clicks over time as a timeline/chart data. WHEN NOT TO USE: User wants current total clicks (use getStats). OPTIONAL PARAMETERS: granularity, page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder SEE ALSO: getRecentActivity |
| getTopPerformingUrls | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get your top performing links based on specific metrics and filters. USE THIS TOOL WHEN: User says "top urls", "best performing", "most clicked", "top links", "highest performers", or similar phrases. WHEN TO USE: User wants to see which URLs are getting the most clicks. WHEN NOT TO USE: User wants to list all URLs (use listUrls). OPTIONAL PARAMETERS: metric, page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder |
| getReferrersData | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get referrer data and traffic source distribution for your URLs USE THIS TOOL WHEN: User says "referrer data", "traffic sources", "where traffic from", "referrers", "source breakdown", or similar phrases. WHEN TO USE: User wants to see where traffic is coming from (referrer sites). WHEN NOT TO USE: User wants UTM campaign data (use getUrlUTMAnalytics). OPTIONAL PARAMETERS: page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder SEE ALSO: getUrlUTMAnalytics |
| getUserLocationAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get aggregated location analytics across your URLs with filtering support USE THIS TOOL WHEN: User says "user locations", "visitor countries", "geographic breakdown", "where visitors from", or similar phrases. WHEN TO USE: User wants detailed geographic breakdown of their audience. WHEN NOT TO USE: User wants basic geographic stats (use getUrlGeographicAnalytics). OPTIONAL PARAMETERS: page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder |
| getUrlsWithUtm | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get list of short URLs that have UTM parameters USE THIS TOOL WHEN: User says "urls with utm", "utm tagged urls", "campaign urls", "tagged links", or similar phrases. WHEN TO USE: User wants to find URLs that have UTM parameters attached. WHEN NOT TO USE: User wants UTM analytics (use getUrlUTMAnalytics). |
| getTrafficQuality | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get comprehensive traffic quality metrics for a short URL or entire portfolio. Metrics provided: human_clicks (Total organic engagement from real users, including high-intent QR scans), bot_clicks (Total automated traffic), social_bot_clicks (Traffic from social previews like WhatsApp, LinkedIn), crawler_clicks (Traffic from search engine bots), bot_percentage (Ratio of bot traffic to total), and traffic_health (Status: "good" if human > bot, "poor" if bot traffic dominates). Use this to verify traffic integrity and detect bot interactions. USE THIS TOOL WHEN: User says "traffic quality", "bot traffic", "human vs bot", "traffic analysis", "click quality", or similar phrases. WHEN TO USE: User wants to analyze bot vs human traffic quality. WHEN NOT TO USE: User wants general click stats (use getStats). OPTIONAL PARAMETERS: page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder |
| getAbTestAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get detailed A/B test analytics and performance metrics (clicks, unique visitors, conversions, conversion rates, conversion velocity, and statistical significance) for a short URL or test ID. USE THIS TOOL WHEN: User says "ab test", "a/b testing", "split test", "variant performance", "ab analytics", or similar phrases. WHEN TO USE: User wants to see A/B test results and variant performance. WHEN NOT TO USE: User wants general analytics (use getStats). REQUIRED PARAMETERS: id OPTIONAL PARAMETERS: days SEE ALSO: getStats |
| listAbTests | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get a list of all your URL A/B tests (including running, draft, paused, or completed tests). Supports pagination, status filtering, and archiving state. USE THIS TOOL WHEN: User says "list ab tests", "list a/b tests", "my ab tests", "show ab tests", "view split tests", or similar phrases. WHEN TO USE: User wants to see all their URL A/B tests. WHEN NOT TO USE: User wants to list campaigns (use listCampaigns) or standard URLs (use listUrls). OPTIONAL PARAMETERS: status, archived, page, limit SEE ALSO: createAbTest |
| createAbTest | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Create a new URL A/B test (split test) to split traffic between a control URL and one or more variant URLs. If no primary short URL is specified, a new rotator short link will be programmatically created and launched. USE THIS TOOL WHEN: User says "create ab test", "new ab test", "start split test", "make ab test", "create split test", or similar phrases. WHEN TO USE: User wants to set up a new split/rotator test with 2 or more target variants. WHEN NOT TO USE: User wants to shorten a single standard URL (use shortenUrl). REQUIRED PARAMETERS: name, variants OPTIONAL PARAMETERS: description, hypothesis, primary_url_id, short_code, url_type, subdomain, branded_domain, traffic_split_mode, conversions_enabled, min_sample_size, confidence_level SEE ALSO: listAbTests |
| getAbTest | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get detailed configuration and variant details of a specific A/B test by short code, custom alias, or A/B test UUID. USE THIS TOOL WHEN: User says "get ab test", "ab test details", "show ab test", "view ab test", or similar phrases. WHEN TO USE: User wants to get setup configurations and details of a specific A/B test by short code, custom alias, or UUID. WHEN NOT TO USE: User wants to see analytics (use getAbTestAnalytics). REQUIRED PARAMETERS: id SEE ALSO: getAbTestAnalytics |
| updateAbTest | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Update settings of a draft A/B test (name, description, sample sizes, confidence level, or variant details like destination URLs and weights). Note: Active or completed tests cannot be updated; pause or complete them instead. USE THIS TOOL WHEN: User says "update ab test", "edit ab test", "change ab test", or similar phrases. WHEN TO USE: User wants to update draft A/B test metadata or change weights/destinations of its variants. WHEN NOT TO USE: User wants to update a running test (pause it first, or use completeAbTest). REQUIRED PARAMETERS: id OPTIONAL PARAMETERS: name, description, min_sample_size, confidence_level, variants |
| deleteAbTest | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Permanently delete an A/B test and its variants. If the test was running/active, this also disables A/B testing on the primary short URL. USE THIS TOOL WHEN: User says "delete ab test", "remove ab test", or similar phrases. WHEN TO USE: User wants to permanently delete an A/B test. Note that if it was active, A/B testing flag on its primary URL is disabled. WHEN NOT TO USE: User wants to pause a test (use pauseAbTest). REQUIRED PARAMETERS: id |
| startAbTest | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Start a draft or paused A/B test. Traffic to the short URL will begin routing and splitting among variants. USE THIS TOOL WHEN: User says "start ab test", "run ab test", "activate ab test", or similar phrases. WHEN TO USE: User wants to start routing traffic through an A/B test's variants. WHEN NOT TO USE: User wants to create a test (use createAbTest). REQUIRED PARAMETERS: id |
| pauseAbTest | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Pause a running A/B test. Short URL traffic will fallback to the original/primary destination rather than routing/splitting to variants. USE THIS TOOL WHEN: User says "pause ab test", "stop ab test splitting", "hold ab test", or similar phrases. WHEN TO USE: User wants to pause traffic splitting and revert traffic to the original destination. WHEN NOT TO USE: User wants to complete the test permanently (use completeAbTest). REQUIRED PARAMETERS: id |
| resumeAbTest | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Resume a paused A/B test. Traffic to the short URL will resume routing and splitting among variants. USE THIS TOOL WHEN: User says "resume ab test", "restart ab test", "continue ab test", "resume split test", or similar phrases. WHEN TO USE: User wants to resume a paused A/B test to continue traffic splitting among variants. WHEN NOT TO USE: User wants to start a draft test for the first time (use startAbTest). REQUIRED PARAMETERS: id |
| completeAbTest | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Complete an active or paused A/B test. Traffic splitting will end, and the short URL will permanently redirect to the winner variant. If winner_variant_id is omitted, the variant with the highest conversions will be automatically declared the winner. USE THIS TOOL WHEN: User says "complete ab test", "finish ab test", "end ab test and declare winner", or similar phrases. WHEN TO USE: User wants to finish the test and permanently forward all traffic to the winning variant. WHEN NOT TO USE: User wants to temporarily stop the test (use pauseAbTest). REQUIRED PARAMETERS: id OPTIONAL PARAMETERS: winner_variant_id |
| recordConversion | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Record a custom conversion event (e.g., lead, purchase, signup) associated with a short URL click or A/B test. The event is queued and processed asynchronously. USE THIS TOOL WHEN: User says "record conversion", "track conversion", "log lead or purchase", "track conversion event", or similar phrases. WHEN TO USE: User/Client-side script wants to log a conversion (lead, purchase, signup) for a click ID. WHEN NOT TO USE: User wants to view conversion analytics (use getAbTestAnalytics). REQUIRED PARAMETERS: jmpy_click_id, event_name OPTIONAL PARAMETERS: value, currency, metadata |
| getClickDetails | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get detailed click data for a short URL USE THIS TOOL WHEN: User says "click details", "individual clicks", "click log", "detailed clicks", "click history", or similar phrases. WHEN TO USE: User wants individual click-level details and logs. WHEN NOT TO USE: User wants aggregated stats (use getStats). REQUIRED PARAMETERS: shortUrlId OPTIONAL PARAMETERS: page, limit SEE ALSO: getRecentActivity |
| getUserDeviceAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get aggregated device/browser analytics across all your URLs USE THIS TOOL WHEN: User says "user devices", "device breakdown", "mobile desktop tablet", "device types", or similar phrases. WHEN TO USE: User wants device analytics across all their URLs. WHEN NOT TO USE: User wants device data for specific URL (use getUrlDeviceAnalytics). OPTIONAL PARAMETERS: period |
| getRecentActivity | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get most recent engagement events (clicks and scans) across your account. USE THIS TOOL WHEN: User says "recent activity", "latest activity", "recent clicks", "activity log", "what happened recently", or similar phrases. WHEN TO USE: User wants to see recent click activity and events. WHEN NOT TO USE: User wants historical timeline (use getClicksTimeline). OPTIONAL PARAMETERS: page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder SEE ALSO: getClickDetails |
| getUserTrafficSourceAnalytics | ### 📜 JMPY CORE PRINCIPLES (MANDATORY): 1. **EVERY LINK IS DYNAMIC**: All JMPY short URLs allow their destination (target URL) to be changed at any time. 2. **NEVER DELETE TO UPDATE**: If a user wants to change where a link points or make it "dynamic", ALWAYS use 'updateUrl'. NEVER delete and recreate a link just to change its destination, as this breaks the existing short code. 3. **QR PRODUCT DISTINCTION**: - 'generateQr' is for standalone, professional QR codes (WiFi, vCards, etc.). - 'shortenUrl' with qrCode:true is for trackable links that also need a QR. 4. **BULK OPERATIONS**: When managing multiple assets (URLs, QR codes), ALWAYS check if the tool supports bulk/array inputs. Using one bulk call is 10x faster than multiple individual calls. 5. **ASSET DELIVERY**: When a response includes a 'downloadUrl', always provide it to the user as a clickable download link or button. Get aggregated traffic source data (Direct, Social, Referral, Email, etc.) for your links. OPTIONAL PARAMETERS: page, limit, dateRange, days, startDate, endDate, urlType, campaignId, tags, shortCodes, clickInsights, sortBy, sortOrder |