What this MCP does
Creates and manages short links, custom domains, click tracking, analytics, exports, and click-event webhooks.
Capabilities
Tools
25
tools
batchDeleteLinks
Batch delete multiple links
Destructive
Input schema
{'type': 'object', 'required': ['ids'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'integer'}, 'description': 'Array of link IDs to delete'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
create_domain
Add a custom domain to the workspace. The domain must be configured to point to Linkly's servers.
Input schema
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': "The domain name (e.g., 'links.example.com')"}}}
Output schema
{'type': 'object', 'properties': {'name': {'type': ['string', 'null']}, 'workspace_id': {'type': ['integer', 'null']}}, 'description': 'A custom domain (mirrors the OpenAPI Domain schema)', 'additionalProperties': True}
create_link
Create short links and URL shorteners. Use this when the user asks to shorten a URL, create a short link, or make a link shorter.
Input schema
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The destination URL for the link (required)'}, 'name': {'type': 'string', 'description': 'A nickname for the link to identify it later'}, 'note': {'type': 'string', 'description': 'A private note about this link'}, 'slug': {'type': 'string', 'description': 'Custom slug/suffix for the link (must start with /). Only valid together with domain: setting slug without a workspace-owned domain is rejected by the API.'}, 'domain': {'type': 'string', 'description': 'Custom domain for the short link (without trailing /). Must be a domain that already belongs to this workspace — call list_domains to get valid values. Required whenever slug is set.'}, 'gtm_id': {'type': 'string', 'description': 'Google Tag Manager container ID'}, 'enabled': {'type': 'boolean', 'description': 'Whether the link is active (default: true)'}, 'cloaking': {'type': 'boolean', 'description': 'Hide destination URL by opening in an iframe'}, 'og_image': {'type': 'string', 'description': 'Open Graph image URL for social media previews'}, 'og_title': {'type': 'string', 'description': 'Open Graph title for social media previews'}, 'utm_term': {'type': 'string', 'description': 'UTM term parameter'}, 'block_bots': {'type': 'boolean', 'description': 'Block known bots and spiders from following the link'}, 'ga4_tag_id': {'type': 'string', 'description': 'Google Analytics 4 tag ID'}, 'utm_medium': {'type': 'string', 'description': 'UTM medium parameter'}, 'utm_source': {'type': 'string', 'description': 'UTM source parameter'}, 'fb_pixel_id': {'type': 'string', 'description': 'Meta/Facebook Pixel ID for tracking'}, 'utm_content': {'type': 'string', 'description': 'UTM content parameter'}, 'utm_campaign': {'type': 'string', 'description': 'UTM campaign parameter'}, 'hide_referrer': {'type': 'boolean', 'description': 'Hide referrer information when users click'}, 'forward_params': {'type': 'boolean', 'description': 'Forward URL parameters to the destination'}, 'og_description': {'type': 'string', 'description': 'Open Graph description for social media previews'}, 'expiry_datetime': {'type': 'string', 'description': 'ISO 8601 datetime when the link should expire'}, 'expiry_destination': {'type': 'string', 'description': 'Fallback URL after expiry (404 if blank)'}}}
Output schema
{'type': 'object', 'properties': {'id': {'type': ['integer', 'null'], 'description': 'Link ID'}, 'url': {'type': ['string', 'null'], 'format': 'uri', 'description': 'Destination URL'}, 'name': {'type': ['string', 'null']}, 'note': {'type': ['string', 'null']}, 'slug': {'type': ['string', 'null']}, 'rules': {'type': ['array', 'null'], 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'what': {'type': 'string'}, 'matches': {'type': 'string'}, 'rule_url': {'type': 'string'}, 'percentage': {'type': 'string'}}, 'additionalProperties': True}}, 'domain': {'type': ['string', 'null']}, 'gtm_id': {'type': ['string', 'null']}, 'deleted': {'type': ['boolean', 'null']}, 'enabled': {'type': ['boolean', 'null']}, 'cloaking': {'type': ['boolean', 'null']}, 'full_url': {'type': ['string', 'null'], 'format': 'uri', 'description': 'Full short-link URL'}, 'og_image': {'type': ['string', 'null']}, 'og_title': {'type': ['string', 'null']}, 'password': {'type': ['string', 'null']}, 'utm_term': {'type': ['string', 'null']}, 'webhooks': {'type': ['array', 'null'], 'items': {'type': 'string'}}, 'body_tags': {'type': ['string', 'null']}, 'head_tags': {'type': ['string', 'null']}, 'qr_styles': {'type': ['object', 'null'], 'additionalProperties': True}, 'block_bots': {'type': ['boolean', 'null']}, 'ga4_tag_id': {'type': ['string', 'null']}, 'utm_medium': {'type': ['string', 'null']}, 'utm_source': {'type': ['string', 'null']}, 'fb_pixel_id': {'type': ['string', 'null']}, 'utm_content': {'type': ['string', 'null']}, 'notify_slack': {'type': ['boolean', 'null']}, 'replacements': {'type': ['string', 'null']}, 'utm_campaign': {'type': ['string', 'null']}, 'workspace_id': {'type': ['integer', 'null']}, 'expiry_clicks': {'type': ['integer', 'null']}, 'hide_referrer': {'type': ['boolean', 'null']}, 'linkify_words': {'type': ['string', 'null']}, 'forward_params': {'type': ['boolean', 'null']}, 'og_description': {'type': ['string', 'null']}, 'expiry_datetime': {'type': ['string', 'null']}, 'notify_user_ids': {'type': ['array', 'null'], 'items': {'type': 'integer'}}, 'reddit_pixel_id': {'type': ['string', 'null']}, 'tiktok_pixel_id': {'type': ['string', 'null']}, 'pinterest_tag_id': {'type': ['string', 'null']}, 'public_analytics': {'type': ['boolean', 'null']}, 'twitter_pixel_id': {'type': ['string', 'null']}, 'snapchat_pixel_id': {'type': ['string', 'null']}, 'created_by_user_id': {'type': ['integer', 'null']}, 'expiry_destination': {'type': ['string', 'null'], 'format': 'uri'}, 'linkedin_partner_id': {'type': ['string', 'null']}, 'microsoft_uet_tag_id': {'type': ['string', 'null']}, 'skip_social_crawler_tracking': {'type': ['boolean', 'null']}}, 'description': 'A Linkly link (mirrors the OpenAPI Link schema)', 'additionalProperties': True}
delete_domain
Remove a custom domain from the workspace.
Destructive
Input schema
{'type': 'object', 'required': ['domain_id'], 'properties': {'domain_id': {'type': 'integer', 'description': 'The ID of the domain to delete'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
delete_link
Delete a Linkly link by its ID
Destructive
Input schema
{'type': 'object', 'required': ['link_id'], 'properties': {'link_id': {'type': 'integer', 'description': 'The ID of the link to delete'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
export_clicks
Export detailed click records with full information (timestamp, browser, country, URL, platform, referer, bot, ISP, params).
Read only
Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'end': {'type': 'string', 'description': 'End date in YYYY-MM-DD format (default: yesterday)'}, 'bots': {'enum': ['include', 'exclude', 'only'], 'type': 'string', 'description': 'Bot filtering'}, 'start': {'type': 'string', 'description': 'Start date in YYYY-MM-DD format (default: 30 days ago)'}, 'country': {'type': 'string', 'description': 'Filter by country code'}, 'link_id': {'type': 'integer', 'description': 'Filter by specific link ID'}, 'platform': {'type': 'string', 'description': 'Filter by platform'}}}
Output schema
{'type': 'object', 'properties': {'results': {'type': 'array'}}, 'description': 'Time-series click data', 'additionalProperties': True}
get_analytics
Get time-series click analytics data for charting. Returns click counts over time.
Read only
Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'end': {'type': 'string', 'description': 'End date in YYYY-MM-DD format (default: today)'}, 'bots': {'enum': ['include', 'exclude', 'only'], 'type': 'string', 'description': 'Bot filtering: include (default), exclude, or only'}, 'start': {'type': 'string', 'description': 'Start date in YYYY-MM-DD format (default: 30 days ago)'}, 'unique': {'type': 'boolean', 'description': 'Count unique clicks only (by IP)'}, 'browser': {'type': 'string', 'description': 'Filter by browser name'}, 'country': {'type': 'string', 'description': "Filter by country code (e.g., 'US', 'GB')"}, 'link_id': {'type': 'integer', 'description': 'Filter by specific link ID'}, 'platform': {'type': 'string', 'description': "Filter by platform (e.g., 'desktop', 'mobile', 'tablet')"}, 'frequency': {'enum': ['day', 'hour'], 'type': 'string', 'description': "Time granularity: 'day' (default) or 'hour'"}}}
Output schema
{'type': 'object', 'additionalProperties': True}
get_analytics_by
Get click counts grouped by a dimension (country, platform, referrer, etc.). Useful for breakdowns and top-N reports.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['counter'], 'properties': {'end': {'type': 'string', 'description': 'End date in YYYY-MM-DD format (default: today)'}, 'bots': {'enum': ['include', 'exclude', 'only'], 'type': 'string', 'description': 'Bot filtering'}, 'start': {'type': 'string', 'description': 'Start date in YYYY-MM-DD format (default: 30 days ago)'}, 'unique': {'type': 'boolean', 'description': 'Count unique clicks only'}, 'counter': {'enum': ['country', 'platform', 'referer', 'isp', 'link_id', 'destination', 'bot_name'], 'type': 'string', 'description': 'Dimension to group by (required)'}, 'country': {'type': 'string', 'description': 'Filter by country code'}, 'link_id': {'type': 'integer', 'description': 'Filter by specific link ID'}, 'platform': {'type': 'string', 'description': 'Filter by platform'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
get_clicks
Get recent click data for the workspace
Read only
Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'link_id': {'type': 'integer', 'description': 'Optional: filter clicks by link ID'}}}
Output schema
{'type': 'object', 'properties': {'results': {'type': 'array'}}, 'description': 'Time-series click data', 'additionalProperties': True}
get_link
Get details of a specific Linkly link by its ID
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['link_id'], 'properties': {'link_id': {'type': 'integer', 'description': 'The ID of the link to retrieve'}}}
Output schema
{'type': 'object', 'properties': {'id': {'type': ['integer', 'null'], 'description': 'Link ID'}, 'url': {'type': ['string', 'null'], 'format': 'uri', 'description': 'Destination URL'}, 'name': {'type': ['string', 'null']}, 'note': {'type': ['string', 'null']}, 'slug': {'type': ['string', 'null']}, 'rules': {'type': ['array', 'null'], 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'what': {'type': 'string'}, 'matches': {'type': 'string'}, 'rule_url': {'type': 'string'}, 'percentage': {'type': 'string'}}, 'additionalProperties': True}}, 'domain': {'type': ['string', 'null']}, 'gtm_id': {'type': ['string', 'null']}, 'deleted': {'type': ['boolean', 'null']}, 'enabled': {'type': ['boolean', 'null']}, 'cloaking': {'type': ['boolean', 'null']}, 'full_url': {'type': ['string', 'null'], 'format': 'uri', 'description': 'Full short-link URL'}, 'og_image': {'type': ['string', 'null']}, 'og_title': {'type': ['string', 'null']}, 'password': {'type': ['string', 'null']}, 'utm_term': {'type': ['string', 'null']}, 'webhooks': {'type': ['array', 'null'], 'items': {'type': 'string'}}, 'body_tags': {'type': ['string', 'null']}, 'head_tags': {'type': ['string', 'null']}, 'qr_styles': {'type': ['object', 'null'], 'additionalProperties': True}, 'block_bots': {'type': ['boolean', 'null']}, 'ga4_tag_id': {'type': ['string', 'null']}, 'utm_medium': {'type': ['string', 'null']}, 'utm_source': {'type': ['string', 'null']}, 'fb_pixel_id': {'type': ['string', 'null']}, 'utm_content': {'type': ['string', 'null']}, 'notify_slack': {'type': ['boolean', 'null']}, 'replacements': {'type': ['string', 'null']}, 'utm_campaign': {'type': ['string', 'null']}, 'workspace_id': {'type': ['integer', 'null']}, 'expiry_clicks': {'type': ['integer', 'null']}, 'hide_referrer': {'type': ['boolean', 'null']}, 'linkify_words': {'type': ['string', 'null']}, 'forward_params': {'type': ['boolean', 'null']}, 'og_description': {'type': ['string', 'null']}, 'expiry_datetime': {'type': ['string', 'null']}, 'notify_user_ids': {'type': ['array', 'null'], 'items': {'type': 'integer'}}, 'reddit_pixel_id': {'type': ['string', 'null']}, 'tiktok_pixel_id': {'type': ['string', 'null']}, 'pinterest_tag_id': {'type': ['string', 'null']}, 'public_analytics': {'type': ['boolean', 'null']}, 'twitter_pixel_id': {'type': ['string', 'null']}, 'snapchat_pixel_id': {'type': ['string', 'null']}, 'created_by_user_id': {'type': ['integer', 'null']}, 'expiry_destination': {'type': ['string', 'null'], 'format': 'uri'}, 'linkedin_partner_id': {'type': ['string', 'null']}, 'microsoft_uet_tag_id': {'type': ['string', 'null']}, 'skip_social_crawler_tracking': {'type': ['boolean', 'null']}}, 'description': 'A Linkly link (mirrors the OpenAPI Link schema)', 'additionalProperties': True}
list_domains
List all custom domains in the workspace.
Read only
Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {}}
Output schema
{'type': 'object', 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': ['string', 'null']}, 'workspace_id': {'type': ['integer', 'null']}}, 'description': 'A custom domain (mirrors the OpenAPI Domain schema)', 'additionalProperties': True}}}, 'additionalProperties': True}
list_links
List links with sorting and search
Read only
Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'page': {'type': 'integer'}, 'search': {'type': 'string', 'description': 'Search Query'}, 'sort_by': {'type': 'string', 'description': 'Field to sort by'}, 'sort_dir': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort direction'}, 'page_size': {'type': 'integer'}}}
Output schema
{'type': 'object', 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': ['integer', 'null'], 'description': 'Link ID'}, 'url': {'type': ['string', 'null'], 'format': 'uri', 'description': 'Destination URL'}, 'name': {'type': ['string', 'null']}, 'note': {'type': ['string', 'null']}, 'slug': {'type': ['string', 'null']}, 'rules': {'type': ['array', 'null'], 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'what': {'type': 'string'}, 'matches': {'type': 'string'}, 'rule_url': {'type': 'string'}, 'percentage': {'type': 'string'}}, 'additionalProperties': True}}, 'domain': {'type': ['string', 'null']}, 'gtm_id': {'type': ['string', 'null']}, 'deleted': {'type': ['boolean', 'null']}, 'enabled': {'type': ['boolean', 'null']}, 'cloaking': {'type': ['boolean', 'null']}, 'full_url': {'type': ['string', 'null'], 'format': 'uri', 'description': 'Full short-link URL'}, 'og_image': {'type': ['string', 'null']}, 'og_title': {'type': ['string', 'null']}, 'password': {'type': ['string', 'null']}, 'utm_term': {'type': ['string', 'null']}, 'webhooks': {'type': ['array', 'null'], 'items': {'type': 'string'}}, 'body_tags': {'type': ['string', 'null']}, 'head_tags': {'type': ['string', 'null']}, 'qr_styles': {'type': ['object', 'null'], 'additionalProperties': True}, 'block_bots': {'type': ['boolean', 'null']}, 'ga4_tag_id': {'type': ['string', 'null']}, 'utm_medium': {'type': ['string', 'null']}, 'utm_source': {'type': ['string', 'null']}, 'fb_pixel_id': {'type': ['string', 'null']}, 'utm_content': {'type': ['string', 'null']}, 'notify_slack': {'type': ['boolean', 'null']}, 'replacements': {'type': ['string', 'null']}, 'utm_campaign': {'type': ['string', 'null']}, 'workspace_id': {'type': ['integer', 'null']}, 'expiry_clicks': {'type': ['integer', 'null']}, 'hide_referrer': {'type': ['boolean', 'null']}, 'linkify_words': {'type': ['string', 'null']}, 'forward_params': {'type': ['boolean', 'null']}, 'og_description': {'type': ['string', 'null']}, 'expiry_datetime': {'type': ['string', 'null']}, 'notify_user_ids': {'type': ['array', 'null'], 'items': {'type': 'integer'}}, 'reddit_pixel_id': {'type': ['string', 'null']}, 'tiktok_pixel_id': {'type': ['string', 'null']}, 'pinterest_tag_id': {'type': ['string', 'null']}, 'public_analytics': {'type': ['boolean', 'null']}, 'twitter_pixel_id': {'type': ['string', 'null']}, 'snapchat_pixel_id': {'type': ['string', 'null']}, 'created_by_user_id': {'type': ['integer', 'null']}, 'expiry_destination': {'type': ['string', 'null'], 'format': 'uri'}, 'linkedin_partner_id': {'type': ['string', 'null']}, 'microsoft_uet_tag_id': {'type': ['string', 'null']}, 'skip_social_crawler_tracking': {'type': ['boolean', 'null']}}, 'description': 'A Linkly link (mirrors the OpenAPI Link schema)', 'additionalProperties': True}}}, 'additionalProperties': True}
list_link_webhooks
List all webhook URLs subscribed to a specific link.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['link_id'], 'properties': {'link_id': {'type': 'integer', 'description': 'The ID of the link'}}}
Output schema
{'type': 'object', 'properties': {'results': {'type': 'array', 'items': {'type': 'string', 'format': 'uri'}}}, 'additionalProperties': True}
list_webhooks
List all webhook URLs subscribed to the workspace. These receive click events for all links.
Read only
Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {}}
Output schema
{'type': 'object', 'properties': {'results': {'type': 'array', 'items': {'type': 'string', 'format': 'uri'}}}, 'additionalProperties': True}
list_workspaces
Return details of authenticated workspace
Read only
Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {}}
Output schema
{'type': 'object', 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'integer', 'description': 'Workspace ID'}, 'name': {'type': 'string', 'description': 'Workspace name'}}, 'additionalProperties': True}}}, 'additionalProperties': True}
ping
Health check
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['message'], 'properties': {'message': {'type': 'string', 'description': 'a message to ping , default to Hello From Linkkly'}}}
search_links
Search for links by name, URL, or note. Returns matching links with click statistics.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'Search query to match against link names, URLs, and notes'}}}
Output schema
{'type': 'object', 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': ['integer', 'null'], 'description': 'Link ID'}, 'url': {'type': ['string', 'null'], 'format': 'uri', 'description': 'Destination URL'}, 'name': {'type': ['string', 'null']}, 'note': {'type': ['string', 'null']}, 'slug': {'type': ['string', 'null']}, 'rules': {'type': ['array', 'null'], 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'what': {'type': 'string'}, 'matches': {'type': 'string'}, 'rule_url': {'type': 'string'}, 'percentage': {'type': 'string'}}, 'additionalProperties': True}}, 'domain': {'type': ['string', 'null']}, 'gtm_id': {'type': ['string', 'null']}, 'deleted': {'type': ['boolean', 'null']}, 'enabled': {'type': ['boolean', 'null']}, 'cloaking': {'type': ['boolean', 'null']}, 'full_url': {'type': ['string', 'null'], 'format': 'uri', 'description': 'Full short-link URL'}, 'og_image': {'type': ['string', 'null']}, 'og_title': {'type': ['string', 'null']}, 'password': {'type': ['string', 'null']}, 'utm_term': {'type': ['string', 'null']}, 'webhooks': {'type': ['array', 'null'], 'items': {'type': 'string'}}, 'body_tags': {'type': ['string', 'null']}, 'head_tags': {'type': ['string', 'null']}, 'qr_styles': {'type': ['object', 'null'], 'additionalProperties': True}, 'block_bots': {'type': ['boolean', 'null']}, 'ga4_tag_id': {'type': ['string', 'null']}, 'utm_medium': {'type': ['string', 'null']}, 'utm_source': {'type': ['string', 'null']}, 'fb_pixel_id': {'type': ['string', 'null']}, 'utm_content': {'type': ['string', 'null']}, 'notify_slack': {'type': ['boolean', 'null']}, 'replacements': {'type': ['string', 'null']}, 'utm_campaign': {'type': ['string', 'null']}, 'workspace_id': {'type': ['integer', 'null']}, 'expiry_clicks': {'type': ['integer', 'null']}, 'hide_referrer': {'type': ['boolean', 'null']}, 'linkify_words': {'type': ['string', 'null']}, 'forward_params': {'type': ['boolean', 'null']}, 'og_description': {'type': ['string', 'null']}, 'expiry_datetime': {'type': ['string', 'null']}, 'notify_user_ids': {'type': ['array', 'null'], 'items': {'type': 'integer'}}, 'reddit_pixel_id': {'type': ['string', 'null']}, 'tiktok_pixel_id': {'type': ['string', 'null']}, 'pinterest_tag_id': {'type': ['string', 'null']}, 'public_analytics': {'type': ['boolean', 'null']}, 'twitter_pixel_id': {'type': ['string', 'null']}, 'snapchat_pixel_id': {'type': ['string', 'null']}, 'created_by_user_id': {'type': ['integer', 'null']}, 'expiry_destination': {'type': ['string', 'null'], 'format': 'uri'}, 'linkedin_partner_id': {'type': ['string', 'null']}, 'microsoft_uet_tag_id': {'type': ['string', 'null']}, 'skip_social_crawler_tracking': {'type': ['boolean', 'null']}}, 'description': 'A Linkly link (mirrors the OpenAPI Link schema)', 'additionalProperties': True}}}, 'additionalProperties': True}
subscribe_link_webhook
Subscribe a webhook URL to receive click events for a specific link.
Input schema
{'type': 'object', 'required': ['link_id', 'url'], 'properties': {'url': {'type': 'string', 'description': 'The webhook URL to receive click event notifications'}, 'link_id': {'type': 'integer', 'description': 'The ID of the link'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
subscribe_webhook
Subscribe a webhook URL to receive click events for all links in the workspace.
Input schema
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The webhook URL to receive click event notifications'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
test_authentication
Test API Authentication
Read only
Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {}}
Output schema
{'type': 'object', 'additionalProperties': True}
unsubscribe_link_webhook
Unsubscribe a webhook URL from a specific link's click events.
Destructive
Input schema
{'type': 'object', 'required': ['link_id', 'url'], 'properties': {'url': {'type': 'string', 'description': 'The webhook URL to unsubscribe'}, 'link_id': {'type': 'integer', 'description': 'The ID of the link'}}}
unsubscribe_webhook
Unsubscribe a webhook URL from workspace click events.
Destructive
Input schema
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The webhook URL to unsubscribe'}}}
update_domain_favicon
Update the favicon URL for a custom domain.
Destructive
Idempotent
Input schema
{'type': 'object', 'required': ['domain_id', 'favicon_url'], 'properties': {'domain_id': {'type': 'integer', 'description': 'The ID of the domain to update'}, 'favicon_url': {'type': 'string', 'description': 'URL to the favicon image'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
update_link
Update an existing Linkly link by its ID
Destructive
Input schema
{'type': 'object', 'required': ['link_id'], 'properties': {'url': {'type': 'string', 'description': 'New destination URL'}, 'name': {'type': 'string', 'description': 'New nickname for the link'}, 'note': {'type': 'string', 'description': 'New private note'}, 'gtm_id': {'type': 'string', 'description': 'Google Tag Manager ID'}, 'enabled': {'type': 'boolean', 'description': 'Whether the link is active'}, 'link_id': {'type': 'integer', 'description': 'The ID of the link to update (required)'}, 'cloaking': {'type': 'boolean', 'description': 'Enable URL cloaking'}, 'og_image': {'type': 'string', 'description': 'Open Graph image URL'}, 'og_title': {'type': 'string', 'description': 'Open Graph title'}, 'utm_term': {'type': 'string', 'description': 'UTM term parameter'}, 'block_bots': {'type': 'boolean', 'description': 'Block bots'}, 'ga4_tag_id': {'type': 'string', 'description': 'Google Analytics 4 tag ID'}, 'utm_medium': {'type': 'string', 'description': 'UTM medium parameter'}, 'utm_source': {'type': 'string', 'description': 'UTM source parameter'}, 'fb_pixel_id': {'type': 'string', 'description': 'Meta Pixel ID'}, 'utm_content': {'type': 'string', 'description': 'UTM content parameter'}, 'utm_campaign': {'type': 'string', 'description': 'UTM campaign parameter'}, 'hide_referrer': {'type': 'boolean', 'description': 'Hide referrer'}, 'forward_params': {'type': 'boolean', 'description': 'Forward URL parameters'}, 'og_description': {'type': 'string', 'description': 'Open Graph description'}, 'expiry_datetime': {'type': 'string', 'description': 'Expiry datetime (ISO 8601)'}, 'expiry_destination': {'type': 'string', 'description': 'Fallback URL after expiry'}}}
Output schema
{'type': 'object', 'properties': {'id': {'type': ['integer', 'null'], 'description': 'Link ID'}, 'url': {'type': ['string', 'null'], 'format': 'uri', 'description': 'Destination URL'}, 'name': {'type': ['string', 'null']}, 'note': {'type': ['string', 'null']}, 'slug': {'type': ['string', 'null']}, 'rules': {'type': ['array', 'null'], 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'what': {'type': 'string'}, 'matches': {'type': 'string'}, 'rule_url': {'type': 'string'}, 'percentage': {'type': 'string'}}, 'additionalProperties': True}}, 'domain': {'type': ['string', 'null']}, 'gtm_id': {'type': ['string', 'null']}, 'deleted': {'type': ['boolean', 'null']}, 'enabled': {'type': ['boolean', 'null']}, 'cloaking': {'type': ['boolean', 'null']}, 'full_url': {'type': ['string', 'null'], 'format': 'uri', 'description': 'Full short-link URL'}, 'og_image': {'type': ['string', 'null']}, 'og_title': {'type': ['string', 'null']}, 'password': {'type': ['string', 'null']}, 'utm_term': {'type': ['string', 'null']}, 'webhooks': {'type': ['array', 'null'], 'items': {'type': 'string'}}, 'body_tags': {'type': ['string', 'null']}, 'head_tags': {'type': ['string', 'null']}, 'qr_styles': {'type': ['object', 'null'], 'additionalProperties': True}, 'block_bots': {'type': ['boolean', 'null']}, 'ga4_tag_id': {'type': ['string', 'null']}, 'utm_medium': {'type': ['string', 'null']}, 'utm_source': {'type': ['string', 'null']}, 'fb_pixel_id': {'type': ['string', 'null']}, 'utm_content': {'type': ['string', 'null']}, 'notify_slack': {'type': ['boolean', 'null']}, 'replacements': {'type': ['string', 'null']}, 'utm_campaign': {'type': ['string', 'null']}, 'workspace_id': {'type': ['integer', 'null']}, 'expiry_clicks': {'type': ['integer', 'null']}, 'hide_referrer': {'type': ['boolean', 'null']}, 'linkify_words': {'type': ['string', 'null']}, 'forward_params': {'type': ['boolean', 'null']}, 'og_description': {'type': ['string', 'null']}, 'expiry_datetime': {'type': ['string', 'null']}, 'notify_user_ids': {'type': ['array', 'null'], 'items': {'type': 'integer'}}, 'reddit_pixel_id': {'type': ['string', 'null']}, 'tiktok_pixel_id': {'type': ['string', 'null']}, 'pinterest_tag_id': {'type': ['string', 'null']}, 'public_analytics': {'type': ['boolean', 'null']}, 'twitter_pixel_id': {'type': ['string', 'null']}, 'snapchat_pixel_id': {'type': ['string', 'null']}, 'created_by_user_id': {'type': ['integer', 'null']}, 'expiry_destination': {'type': ['string', 'null'], 'format': 'uri'}, 'linkedin_partner_id': {'type': ['string', 'null']}, 'microsoft_uet_tag_id': {'type': ['string', 'null']}, 'skip_social_crawler_tracking': {'type': ['boolean', 'null']}}, 'description': 'A Linkly link (mirrors the OpenAPI Link schema)', 'additionalProperties': True}
update_workspace
Update workspace settings. Only the fields provided are changed; omitted fields keep their current values.
Destructive
Input schema
{'type': 'object', 'required': [], 'properties': {'name': {'type': 'string', 'description': 'Workspace name'}, 'webhooks': {'type': 'array', 'items': {'type': 'string'}, 'description': "REPLACES the workspace's full webhook subscription list. Omit to leave webhooks unchanged; prefer subscribe_webhook / unsubscribe_webhook for adding or removing a single URL."}}}
Output schema
{'type': 'object', 'additionalProperties': True}
History
Recent tool changes
Added
unsubscribe_link_webhook
Sept. 17, 2026, 12:35 p.m.
Added
subscribe_link_webhook
Sept. 17, 2026, 12:35 p.m.
Added
list_link_webhooks
Sept. 17, 2026, 12:35 p.m.
Added
unsubscribe_webhook
Sept. 17, 2026, 12:35 p.m.
Added
subscribe_webhook
Sept. 17, 2026, 12:35 p.m.
Added
list_webhooks
Sept. 17, 2026, 12:35 p.m.
Added
search_links
Sept. 17, 2026, 12:35 p.m.
Added
update_domain_favicon
Sept. 17, 2026, 12:35 p.m.
Added
delete_domain
Sept. 17, 2026, 12:35 p.m.
Added
create_domain
Sept. 17, 2026, 12:35 p.m.
Added
list_domains
Sept. 17, 2026, 12:35 p.m.
Added
export_clicks
Sept. 17, 2026, 12:35 p.m.
Added
get_analytics_by
Sept. 17, 2026, 12:35 p.m.
Added
get_analytics
Sept. 17, 2026, 12:35 p.m.
Added
get_clicks
Sept. 17, 2026, 12:35 p.m.
Added
get_link
Sept. 17, 2026, 12:35 p.m.
Added
delete_link
Sept. 17, 2026, 12:35 p.m.
Added
update_link
Sept. 17, 2026, 12:35 p.m.
Added
create_link
Sept. 17, 2026, 12:35 p.m.
Added
ping
Sept. 17, 2026, 12:35 p.m.
Added
list_links
Sept. 17, 2026, 12:35 p.m.
Added
update_workspace
Sept. 17, 2026, 12:35 p.m.
Added
batchDeleteLinks
Sept. 17, 2026, 12:35 p.m.
Added
list_workspaces
Sept. 17, 2026, 12:35 p.m.
Added
test_authentication
Sept. 17, 2026, 12:35 p.m.
Discover
Similar MCP servers
AdButler
com.adbutler/mcp-server
Manages AdButler advertisers, campaigns, ad items, audiences, zones, creatives, catalogs, and advertising reports.
neuron
io.github.conquext/neuron
Operates AI chatbots and messaging workflows across WhatsApp and social channels, including contacts, campaigns, conversations, p…
SharksAPI.AI
ai.sharksapi/marketing
Provides marketing analytics and actions across GA4, Search Console, Google Ads, social channels, SEO, WordPress, and marketing p…
Meta Council
com.meta-council/decision-intelligence
Provides governed workflows for consulting, outreach, sales deals, invoices, marketing campaigns, content approvals, accounting a…
synter-ads
io.github.Synter-Media-AI/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
synter-ads
io.github.jshorwitz/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
Stratalize Intelligence
com.stratalize/intelligence
Provides vendor, market, SaaS, workforce, government contract, public company, regulatory, competitive, and AI-brand intelligence…
Hermoso
io.github.hermoso-ai/hermoso
Supports ad research, competitor analysis, video and static ad creation, campaign policy checks, content publishing, and performa…