linkly
Create and manage short links, track clicks, and automate URL management
¿Debería usar esto?
Calidad y seguridad
B
Hallazgos (7)
- LOWTool 'list_workspaces' description lacks action verben list_workspaces
- LOWTool 'list_webhooks' suggests web access but openWorldHint=falseen list_webhooks
- LOWTool 'subscribe_webhook' suggests web access but openWorldHint=falseen subscribe_webhook
- LOWTool 'unsubscribe_webhook' suggests web access but openWorldHint=falseen unsubscribe_webhook
- LOWTool 'list_link_webhooks' suggests web access but openWorldHint=falseen list_link_webhooks
- LOWTool 'subscribe_link_webhook' suggests web access but openWorldHint=falseen subscribe_link_webhook
- LOWTool 'unsubscribe_link_webhook' suggests web access but openWorldHint=falseen unsubscribe_link_webhook
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~6,988Tokens (definiciones de herramientas)
~2.8 KBTamaño de respuesta típico
Impacto significativo en la atención (5.46% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"linkly": {
"url": "https://mcp.linklyhq.com"
}
}
}Puntos de conexión remotos
https://mcp.linklyhq.comstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (25)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢test_authentication
Test API Authentication
Esquema de entrada
{
"type": "object",
"properties": {},
"required": []
}Esquema de salida
{
"type": "object",
"additionalProperties": true
}🟢list_workspaces
Return details of authenticated workspace
Esquema de entrada
{
"type": "object",
"properties": {},
"required": []
}Esquema de salida
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"id": {
"type": "integer",
"description": "Workspace ID"
},
"name": {
"type": "string",
"description": "Workspace name"
}
}
}
}
},
"additionalProperties": true
}🔴batchDeleteLinks(ids)
Batch delete multiple links
Esquema de entrada
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Array of link IDs to delete"
}
},
"required": [
"ids"
]
}Esquema de salida
{
"type": "object",
"additionalProperties": true
}🔴update_workspace(name, webhooks)
Update workspace settings. Only the fields provided are changed; omitted fields keep their current values.
Esquema de entrada
{
"type": "object",
"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."
}
},
"required": []
}Esquema de salida
{
"type": "object",
"additionalProperties": true
}🟢list_links(page, page_size, search, sort_by, sort_dir)
List links with sorting and search
Esquema de entrada
{
"type": "object",
"properties": {
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"search": {
"type": "string",
"description": "Search Query"
},
"sort_by": {
"type": "string",
"description": "Field to sort by"
},
"sort_dir": {
"type": "string",
"enum": [
"asc",
"desc"
],
"description": "Sort direction"
}
},
"required": []
}Esquema de salida
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"description": "A Linkly link (mirrors the OpenAPI Link schema)",
"properties": {
"id": {
"type": [
"integer",
"null"
],
"description": "Link ID"
},
"url": {
"type": [
"string",
"null"
],
"format": "uri",
"description": "Destination URL"
},
"full_url": {
"type": [
"string",
"null"
],
"format": "uri",
"description": "Full short-link URL"
},
"domain": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"workspace_id": {
"type": [
"integer",
"null"
]
},
"created_by_user_id": {
"type": [
"integer",
"null"
]
},
"enabled": {
"type": [
"boolean",
"null"
]
},
"deleted": {
"type": [
"boolean",
"null"
]
},
"cloaking": {
"type": [
"boolean",
"null"
]
},
"forward_params": {
"type": [
"boolean",
"null"
]
},
"hide_referrer": {
"type": [
"boolean",
"null"
]
},
"block_bots": {
"type": [
"boolean",
"null"
]
},
"public_analytics": {
"type": [
"boolean",
"null"
]
},
"head_tags": {
"type": [
"string",
"null"
]
},
"body_tags": {
"type": [
"string",
"null"
]
},
"linkify_words": {
"type": [
"string",
"null"
]
},
"replacements": {
"type": [
"string",
"null"
]
},
"rules": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"what": {
"type": "string"
},
"url": {
"type": "string"
},
"rule_url": {
"type": "string"
},
"matches": {
"type": "string"
},
"percentage": {
"type": "string"
}
}
}
},
"utm_source": {
"type": [
"string",
"null"
]
},
"utm_medium": {
"type": [
"string",
"null"
]
},
"utm_campaign": {
"type": [
"string",
"null"
]
},
"utm_term": {
"type": [
"string",
"null"
]
},
"utm_content": {
"type": [
"string",
"null"
]
},
"og_title": {
"type": [
"string",
"null"
]
},
"og_description": {
"type": [
"string",
"null"
]
},
"og_image": {
"type": [
"string",
"null"
]
},
"fb_pixel_id": {
"type": [
"string",
"null"
]
},
"tiktok_pixel_id": {
"type": [
"string",
"null"
]
},
"linkedin_partner_id": {
"type": [
"string",
"null"
]
},
"twitter_pixel_id": {
"type": [
"string",
"null"
]
},
"pinterest_tag_id": {
"type": [
"string",
"null"
]
},
"microsoft_uet_tag_id": {
"type": [
"string",
"null"
]
},
"snapchat_pixel_id": {
"type": [
"string",
"null"
]
},
"reddit_pixel_id": {
"type": [
"string",
"null"
]
},
"gtm_id": {
"type": [
"string",
"null"
]
},
"ga4_tag_id": {
"type": [
"string",
"null"
]
},
"expiry_datetime": {
"type": [
"string",
"null"
]
},
"expiry_destination": {
"type": [
"string",
"null"
],
"format": "uri"
},
"expiry_clicks": {
"type": [
"integer",
"null"
]
},
"skip_social_crawler_tracking": {
"type": [
"boolean",
"null"
]
},
"password": {
"type": [
"string",
"null"
]
},
"qr_styles": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"webhooks": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"notify_user_ids": {
"type": [
"array",
"null"
],
"items": {
"type": "integer"
}
},
"notify_slack": {
"type": [
"boolean",
"null"
]
}
}
}
}
},
"additionalProperties": true
}🟢ping(message)
Health check
Esquema de entrada
{
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "a message to ping , default to Hello From Linkkly"
}
},
"required": [
"message"
]
}🟡create_link(url, name, note, domain, slug, ...)
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.
Esquema de entrada
{
"type": "object",
"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"
},
"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."
},
"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."
},
"enabled": {
"type": "boolean",
"description": "Whether the link is active (default: true)"
},
"utm_source": {
"type": "string",
"description": "UTM source parameter"
},
"utm_medium": {
"type": "string",
"description": "UTM medium parameter"
},
"utm_campaign": {
"type": "string",
"description": "UTM campaign parameter"
},
"utm_term": {
"type": "string",
"description": "UTM term parameter"
},
"utm_content": {
"type": "string",
"description": "UTM content parameter"
},
"og_title": {
"type": "string",
"description": "Open Graph title for social media previews"
},
"og_description": {
"type": "string",
"description": "Open Graph description for social media previews"
},
"og_image": {
"type": "string",
"description": "Open Graph image URL for social media previews"
},
"fb_pixel_id": {
"type": "string",
"description": "Meta/Facebook Pixel ID for tracking"
},
"ga4_tag_id": {
"type": "string",
"description": "Google Analytics 4 tag ID"
},
"gtm_id": {
"type": "string",
"description": "Google Tag Manager container ID"
},
"cloaking": {
"type": "boolean",
"description": "Hide destination URL by opening in an iframe"
},
"forward_params": {
"type": "boolean",
"description": "Forward URL parameters to the destination"
},
"block_bots": {
"type": "boolean",
"description": "Block known bots and spiders from following the link"
},
"hide_referrer": {
"type": "boolean",
"description": "Hide referrer information when users click"
},
"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)"
}
},
"required": [
"url"
]
}Esquema de salida
{
"type": "object",
"properties": {
"id": {
"type": [
"integer",
"null"
],
"description": "Link ID"
},
"url": {
"type": [
"string",
"null"
],
"format": "uri",
"description": "Destination URL"
},
"full_url": {
"type": [
"string",
"null"
],
"format": "uri",
"description": "Full short-link URL"
},
"domain": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"workspace_id": {
"type": [
"integer",
"null"
]
},
"created_by_user_id": {
"type": [
"integer",
"null"
]
},
"enabled": {
"type": [
"boolean",
"null"
]
},
"deleted": {
"type": [
"boolean",
"null"
]
},
"cloaking": {
"type": [
"boolean",
"null"
]
},
"forward_params": {
"type": [
"boolean",
"null"
]
},
"hide_referrer": {
"type": [
"boolean",
"null"
]
},
"block_bots": {
"type": [
"boolean",
"null"
]
},
"public_analytics": {
"type": [
"boolean",
"null"
]
},
"head_tags": {
"type": [
"string",
"null"
]
},
"body_tags": {
"type": [
"string",
"null"
]
},
"linkify_words": {
"type": [
"string",
"null"
]
},
"replacements": {
"type": [
"string",
"null"
]
},
"rules": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"what": {
"type": "string"
},
"url": {
"type": "string"
},
"rule_url": {
"type": "string"
},
"matches": {
"type": "string"
},
"percentage": {
"type": "string"
}
}
}
},
"utm_source": {
"type": [
"string",
"null"
]
},
"utm_medium": {
"type": [
"string",
"null"
]
},
"utm_campaign": {
"type": [
"string",
"null"
]
},
"utm_term": {
"type": [
"string",
"null"
]
},
"utm_content": {
"type": [
"string",
"null"
]
},
"og_title": {
"type": [
"string",
"null"
]
},
"og_description": {
"type": [
"string",
"null"
]
},
"og_image": {
"type": [
"string",
"null"
]
},
"fb_pixel_id": {
"type": [
"string",
"null"
]
},
"tiktok_pixel_id": {
"type": [
"string",
"null"
]
},
"linkedin_partner_id": {
"type": [
"string",
"null"
]
},
"twitter_pixel_id": {
"type": [
"string",
"null"
]
},
"pinterest_tag_id": {
"type": [
"string",
"null"
]
},
"microsoft_uet_tag_id": {
"type": [
"string",
"null"
]
},
"snapchat_pixel_id": {
"type": [
"string",
"null"
]
},
"reddit_pixel_id": {
"type": [
"string",
"null"
]
},
"gtm_id": {
"type": [
"string",
"null"
]
},
"ga4_tag_id": {
"type": [
"string",
"null"
]
},
"expiry_datetime": {
"type": [
"string",
"null"
]
},
"expiry_destination": {
"type": [
"string",
"null"
],
"format": "uri"
},
"expiry_clicks": {
"type": [
"integer",
"null"
]
},
"skip_social_crawler_tracking": {
"type": [
"boolean",
"null"
]
},
"password": {
"type": [
"string",
"null"
]
},
"qr_styles": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"webhooks": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"notify_user_ids": {
"type": [
"array",
"null"
],
"items": {
"type": "integer"
}
},
"notify_slack": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": true,
"description": "A Linkly link (mirrors the OpenAPI Link schema)"
}🔴update_link(link_id, url, name, note, enabled, ...)
Update an existing Linkly link by its ID
Esquema de entrada
{
"type": "object",
"properties": {
"link_id": {
"type": "integer",
"description": "The ID of the link to update (required)"
},
"url": {
"type": "string",
"description": "New destination URL"
},
"name": {
"type": "string",
"description": "New nickname for the link"
},
"note": {
"type": "string",
"description": "New private note"
},
"enabled": {
"type": "boolean",
"description": "Whether the link is active"
},
"utm_source": {
"type": "string",
"description": "UTM source parameter"
},
"utm_medium": {
"type": "string",
"description": "UTM medium parameter"
},
"utm_campaign": {
"type": "string",
"description": "UTM campaign parameter"
},
"utm_term": {
"type": "string",
"description": "UTM term parameter"
},
"utm_content": {
"type": "string",
"description": "UTM content parameter"
},
"og_title": {
"type": "string",
"description": "Open Graph title"
},
"og_description": {
"type": "string",
"description": "Open Graph description"
},
"og_image": {
"type": "string",
"description": "Open Graph image URL"
},
"fb_pixel_id": {
"type": "string",
"description": "Meta Pixel ID"
},
"ga4_tag_id": {
"type": "string",
"description": "Google Analytics 4 tag ID"
},
"gtm_id": {
"type": "string",
"description": "Google Tag Manager ID"
},
"cloaking": {
"type": "boolean",
"description": "Enable URL cloaking"
},
"forward_params": {
"type": "boolean",
"description": "Forward URL parameters"
},
"block_bots": {
"type": "boolean",
"description": "Block bots"
},
"hide_referrer": {
"type": "boolean",
"description": "Hide referrer"
},
"expiry_datetime": {
"type": "string",
"description": "Expiry datetime (ISO 8601)"
},
"expiry_destination": {
"type": "string",
"description": "Fallback URL after expiry"
}
},
"required": [
"link_id"
]
}Esquema de salida
{
"type": "object",
"properties": {
"id": {
"type": [
"integer",
"null"
],
"description": "Link ID"
},
"url": {
"type": [
"string",
"null"
],
"format": "uri",
"description": "Destination URL"
},
"full_url": {
"type": [
"string",
"null"
],
"format": "uri",
"description": "Full short-link URL"
},
"domain": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"workspace_id": {
"type": [
"integer",
"null"
]
},
"created_by_user_id": {
"type": [
"integer",
"null"
]
},
"enabled": {
"type": [
"boolean",
"null"
]
},
"deleted": {
"type": [
"boolean",
"null"
]
},
"cloaking": {
"type": [
"boolean",
"null"
]
},
"forward_params": {
"type": [
"boolean",
"null"
]
},
"hide_referrer": {
"type": [
"boolean",
"null"
]
},
"block_bots": {
"type": [
"boolean",
"null"
]
},
"public_analytics": {
"type": [
"boolean",
"null"
]
},
"head_tags": {
"type": [
"string",
"null"
]
},
"body_tags": {
"type": [
"string",
"null"
]
},
"linkify_words": {
"type": [
"string",
"null"
]
},
"replacements": {
"type": [
"string",
"null"
]
},
"rules": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"what": {
"type": "string"
},
"url": {
"type": "string"
},
"rule_url": {
"type": "string"
},
"matches": {
"type": "string"
},
"percentage": {
"type": "string"
}
}
}
},
"utm_source": {
"type": [
"string",
"null"
]
},
"utm_medium": {
"type": [
"string",
"null"
]
},
"utm_campaign": {
"type": [
"string",
"null"
]
},
"utm_term": {
"type": [
"string",
"null"
]
},
"utm_content": {
"type": [
"string",
"null"
]
},
"og_title": {
"type": [
"string",
"null"
]
},
"og_description": {
"type": [
"string",
"null"
]
},
"og_image": {
"type": [
"string",
"null"
]
},
"fb_pixel_id": {
"type": [
"string",
"null"
]
},
"tiktok_pixel_id": {
"type": [
"string",
"null"
]
},
"linkedin_partner_id": {
"type": [
"string",
"null"
]
},
"twitter_pixel_id": {
"type": [
"string",
"null"
]
},
"pinterest_tag_id": {
"type": [
"string",
"null"
]
},
"microsoft_uet_tag_id": {
"type": [
"string",
"null"
]
},
"snapchat_pixel_id": {
"type": [
"string",
"null"
]
},
"reddit_pixel_id": {
"type": [
"string",
"null"
]
},
"gtm_id": {
"type": [
"string",
"null"
]
},
"ga4_tag_id": {
"type": [
"string",
"null"
]
},
"expiry_datetime": {
"type": [
"string",
"null"
]
},
"expiry_destination": {
"type": [
"string",
"null"
],
"format": "uri"
},
"expiry_clicks": {
"type": [
"integer",
"null"
]
},
"skip_social_crawler_tracking": {
"type": [
"boolean",
"null"
]
},
"password": {
"type": [
"string",
"null"
]
},
"qr_styles": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"webhooks": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"notify_user_ids": {
"type": [
"array",
"null"
],
"items": {
"type": "integer"
}
},
"notify_slack": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": true,
"description": "A Linkly link (mirrors the OpenAPI Link schema)"
}🔴delete_link(link_id)
Delete a Linkly link by its ID
Esquema de entrada
{
"type": "object",
"properties": {
"link_id": {
"type": "integer",
"description": "The ID of the link to delete"
}
},
"required": [
"link_id"
]
}Esquema de salida
{
"type": "object",
"additionalProperties": true
}🟢get_link(link_id)
Get details of a specific Linkly link by its ID
Esquema de entrada
{
"type": "object",
"properties": {
"link_id": {
"type": "integer",
"description": "The ID of the link to retrieve"
}
},
"required": [
"link_id"
]
}Esquema de salida
{
"type": "object",
"properties": {
"id": {
"type": [
"integer",
"null"
],
"description": "Link ID"
},
"url": {
"type": [
"string",
"null"
],
"format": "uri",
"description": "Destination URL"
},
"full_url": {
"type": [
"string",
"null"
],
"format": "uri",
"description": "Full short-link URL"
},
"domain": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"workspace_id": {
"type": [
"integer",
"null"
]
},
"created_by_user_id": {
"type": [
"integer",
"null"
]
},
"enabled": {
"type": [
"boolean",
"null"
]
},
"deleted": {
"type": [
"boolean",
"null"
]
},
"cloaking": {
"type": [
"boolean",
"null"
]
},
"forward_params": {
"type": [
"boolean",
"null"
]
},
"hide_referrer": {
"type": [
"boolean",
"null"
]
},
"block_bots": {
"type": [
"boolean",
"null"
]
},
"public_analytics": {
"type": [
"boolean",
"null"
]
},
"head_tags": {
"type": [
"string",
"null"
]
},
"body_tags": {
"type": [
"string",
"null"
]
},
"linkify_words": {
"type": [
"string",
"null"
]
},
"replacements": {
"type": [
"string",
"null"
]
},
"rules": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"what": {
"type": "string"
},
"url": {
"type": "string"
},
"rule_url": {
"type": "string"
},
"matches": {
"type": "string"
},
"percentage": {
"type": "string"
}
}
}
},
"utm_source": {
"type": [
"string",
"null"
]
},
"utm_medium": {
"type": [
"string",
"null"
]
},
"utm_campaign": {
"type": [
"string",
"null"
]
},
"utm_term": {
"type": [
"string",
"null"
]
},
"utm_content": {
"type": [
"string",
"null"
]
},
"og_title": {
"type": [
"string",
"null"
]
},
"og_description": {
"type": [
"string",
"null"
]
},
"og_image": {
"type": [
"string",
"null"
]
},
"fb_pixel_id": {
"type": [
"string",
"null"
]
},
"tiktok_pixel_id": {
"type": [
"string",
"null"
]
},
"linkedin_partner_id": {
"type": [
"string",
"null"
]
},
"twitter_pixel_id": {
"type": [
"string",
"null"
]
},
"pinterest_tag_id": {
"type": [
"string",
"null"
]
},
"microsoft_uet_tag_id": {
"type": [
"string",
"null"
]
},
"snapchat_pixel_id": {
"type": [
"string",
"null"
]
},
"reddit_pixel_id": {
"type": [
"string",
"null"
]
},
"gtm_id": {
"type": [
"string",
"null"
]
},
"ga4_tag_id": {
"type": [
"string",
"null"
]
},
"expiry_datetime": {
"type": [
"string",
"null"
]
},
"expiry_destination": {
"type": [
"string",
"null"
],
"format": "uri"
},
"expiry_clicks": {
"type": [
"integer",
"null"
]
},
"skip_social_crawler_tracking": {
"type": [
"boolean",
"null"
]
},
"password": {
"type": [
"string",
"null"
]
},
"qr_styles": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"webhooks": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"notify_user_ids": {
"type": [
"array",
"null"
],
"items": {
"type": "integer"
}
},
"notify_slack": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": true,
"description": "A Linkly link (mirrors the OpenAPI Link schema)"
}🟢get_clicks(link_id)
Get recent click data for the workspace
Esquema de entrada
{
"type": "object",
"properties": {
"link_id": {
"type": "integer",
"description": "Optional: filter clicks by link ID"
}
},
"required": []
}Esquema de salida
{
"type": "object",
"properties": {
"results": {
"type": "array"
}
},
"additionalProperties": true,
"description": "Time-series click data"
}🟢get_analytics(start, end, link_id, frequency, country, ...)
Get time-series click analytics data for charting. Returns click counts over time.
Esquema de entrada
{
"type": "object",
"properties": {
"start": {
"type": "string",
"description": "Start date in YYYY-MM-DD format (default: 30 days ago)"
},
"end": {
"type": "string",
"description": "End date in YYYY-MM-DD format (default: today)"
},
"link_id": {
"type": "integer",
"description": "Filter by specific link ID"
},
"frequency": {
"type": "string",
"enum": [
"day",
"hour"
],
"description": "Time granularity: 'day' (default) or 'hour'"
},
"country": {
"type": "string",
"description": "Filter by country code (e.g., 'US', 'GB')"
},
"platform": {
"type": "string",
"description": "Filter by platform (e.g., 'desktop', 'mobile', 'tablet')"
},
"browser": {
"type": "string",
"description": "Filter by browser name"
},
"unique": {
"type": "boolean",
"description": "Count unique clicks only (by IP)"
},
"bots": {
"type": "string",
"enum": [
"include",
"exclude",
"only"
],
"description": "Bot filtering: include (default), exclude, or only"
}
},
"required": []
}Esquema de salida
{
"type": "object",
"additionalProperties": true
}🟢get_analytics_by(counter, start, end, link_id, country, ...)
Get click counts grouped by a dimension (country, platform, referrer, etc.). Useful for breakdowns and top-N reports.
Esquema de entrada
{
"type": "object",
"properties": {
"counter": {
"type": "string",
"enum": [
"country",
"platform",
"referer",
"isp",
"link_id",
"destination",
"bot_name"
],
"description": "Dimension to group by (required)"
},
"start": {
"type": "string",
"description": "Start date in YYYY-MM-DD format (default: 30 days ago)"
},
"end": {
"type": "string",
"description": "End date in YYYY-MM-DD format (default: today)"
},
"link_id": {
"type": "integer",
"description": "Filter by specific link ID"
},
"country": {
"type": "string",
"description": "Filter by country code"
},
"platform": {
"type": "string",
"description": "Filter by platform"
},
"unique": {
"type": "boolean",
"description": "Count unique clicks only"
},
"bots": {
"type": "string",
"enum": [
"include",
"exclude",
"only"
],
"description": "Bot filtering"
}
},
"required": [
"counter"
]
}Esquema de salida
{
"type": "object",
"additionalProperties": true
}🟢export_clicks(start, end, link_id, country, platform, ...)
Export detailed click records with full information (timestamp, browser, country, URL, platform, referer, bot, ISP, params).
Esquema de entrada
{
"type": "object",
"properties": {
"start": {
"type": "string",
"description": "Start date in YYYY-MM-DD format (default: 30 days ago)"
},
"end": {
"type": "string",
"description": "End date in YYYY-MM-DD format (default: yesterday)"
},
"link_id": {
"type": "integer",
"description": "Filter by specific link ID"
},
"country": {
"type": "string",
"description": "Filter by country code"
},
"platform": {
"type": "string",
"description": "Filter by platform"
},
"bots": {
"type": "string",
"enum": [
"include",
"exclude",
"only"
],
"description": "Bot filtering"
}
},
"required": []
}Esquema de salida
{
"type": "object",
"properties": {
"results": {
"type": "array"
}
},
"additionalProperties": true,
"description": "Time-series click data"
}🟢list_domains
List all custom domains in the workspace.
Esquema de entrada
{
"type": "object",
"properties": {},
"required": []
}Esquema de salida
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"description": "A custom domain (mirrors the OpenAPI Domain schema)",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"workspace_id": {
"type": [
"integer",
"null"
]
}
}
}
}
},
"additionalProperties": true
}🟡create_domain(name)
Add a custom domain to the workspace. The domain must be configured to point to Linkly's servers.
Esquema de entrada
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The domain name (e.g., 'links.example.com')"
}
},
"required": [
"name"
]
}Esquema de salida
{
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"workspace_id": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": true,
"description": "A custom domain (mirrors the OpenAPI Domain schema)"
}🔴delete_domain(domain_id)
Remove a custom domain from the workspace.
Esquema de entrada
{
"type": "object",
"properties": {
"domain_id": {
"type": "integer",
"description": "The ID of the domain to delete"
}
},
"required": [
"domain_id"
]
}Esquema de salida
{
"type": "object",
"additionalProperties": true
}🔴update_domain_favicon(domain_id, favicon_url)
Update the favicon URL for a custom domain.
Esquema de entrada
{
"type": "object",
"properties": {
"domain_id": {
"type": "integer",
"description": "The ID of the domain to update"
},
"favicon_url": {
"type": "string",
"description": "URL to the favicon image"
}
},
"required": [
"domain_id",
"favicon_url"
]
}Esquema de salida
{
"type": "object",
"additionalProperties": true
}🟢search_links(query)
Search for links by name, URL, or note. Returns matching links with click statistics.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search query to match against link names, URLs, and notes"
}
},
"required": [
"query"
]
}Esquema de salida
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"description": "A Linkly link (mirrors the OpenAPI Link schema)",
"properties": {
"id": {
"type": [
"integer",
"null"
],
"description": "Link ID"
},
"url": {
"type": [
"string",
"null"
],
"format": "uri",
"description": "Destination URL"
},
"full_url": {
"type": [
"string",
"null"
],
"format": "uri",
"description": "Full short-link URL"
},
"domain": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"workspace_id": {
"type": [
"integer",
"null"
]
},
"created_by_user_id": {
"type": [
"integer",
"null"
]
},
"enabled": {
"type": [
"boolean",
"null"
]
},
"deleted": {
"type": [
"boolean",
"null"
]
},
"cloaking": {
"type": [
"boolean",
"null"
]
},
"forward_params": {
"type": [
"boolean",
"null"
]
},
"hide_referrer": {
"type": [
"boolean",
"null"
]
},
"block_bots": {
"type": [
"boolean",
"null"
]
},
"public_analytics": {
"type": [
"boolean",
"null"
]
},
"head_tags": {
"type": [
"string",
"null"
]
},
"body_tags": {
"type": [
"string",
"null"
]
},
"linkify_words": {
"type": [
"string",
"null"
]
},
"replacements": {
"type": [
"string",
"null"
]
},
"rules": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"what": {
"type": "string"
},
"url": {
"type": "string"
},
"rule_url": {
"type": "string"
},
"matches": {
"type": "string"
},
"percentage": {
"type": "string"
}
}
}
},
"utm_source": {
"type": [
"string",
"null"
]
},
"utm_medium": {
"type": [
"string",
"null"
]
},
"utm_campaign": {
"type": [
"string",
"null"
]
},
"utm_term": {
"type": [
"string",
"null"
]
},
"utm_content": {
"type": [
"string",
"null"
]
},
"og_title": {
"type": [
"string",
"null"
]
},
"og_description": {
"type": [
"string",
"null"
]
},
"og_image": {
"type": [
"string",
"null"
]
},
"fb_pixel_id": {
"type": [
"string",
"null"
]
},
"tiktok_pixel_id": {
"type": [
"string",
"null"
]
},
"linkedin_partner_id": {
"type": [
"string",
"null"
]
},
"twitter_pixel_id": {
"type": [
"string",
"null"
]
},
"pinterest_tag_id": {
"type": [
"string",
"null"
]
},
"microsoft_uet_tag_id": {
"type": [
"string",
"null"
]
},
"snapchat_pixel_id": {
"type": [
"string",
"null"
]
},
"reddit_pixel_id": {
"type": [
"string",
"null"
]
},
"gtm_id": {
"type": [
"string",
"null"
]
},
"ga4_tag_id": {
"type": [
"string",
"null"
]
},
"expiry_datetime": {
"type": [
"string",
"null"
]
},
"expiry_destination": {
"type": [
"string",
"null"
],
"format": "uri"
},
"expiry_clicks": {
"type": [
"integer",
"null"
]
},
"skip_social_crawler_tracking": {
"type": [
"boolean",
"null"
]
},
"password": {
"type": [
"string",
"null"
]
},
"qr_styles": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"webhooks": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"notify_user_ids": {
"type": [
"array",
"null"
],
"items": {
"type": "integer"
}
},
"notify_slack": {
"type": [
"boolean",
"null"
]
}
}
}
}
},
"additionalProperties": true
}🟢list_webhooks
List all webhook URLs subscribed to the workspace. These receive click events for all links.
Esquema de entrada
{
"type": "object",
"properties": {},
"required": []
}Esquema de salida
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
}
},
"additionalProperties": true
}⚪subscribe_webhook(url)
Subscribe a webhook URL to receive click events for all links in the workspace.
Esquema de entrada
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The webhook URL to receive click event notifications"
}
},
"required": [
"url"
]
}Esquema de salida
{
"type": "object",
"additionalProperties": true
}🔴unsubscribe_webhook(url)
Unsubscribe a webhook URL from workspace click events.
Esquema de entrada
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The webhook URL to unsubscribe"
}
},
"required": [
"url"
]
}🟢list_link_webhooks(link_id)
List all webhook URLs subscribed to a specific link.
Esquema de entrada
{
"type": "object",
"properties": {
"link_id": {
"type": "integer",
"description": "The ID of the link"
}
},
"required": [
"link_id"
]
}Esquema de salida
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
}
},
"additionalProperties": true
}⚪subscribe_link_webhook(link_id, url)
Subscribe a webhook URL to receive click events for a specific link.
Esquema de entrada
{
"type": "object",
"properties": {
"link_id": {
"type": "integer",
"description": "The ID of the link"
},
"url": {
"type": "string",
"description": "The webhook URL to receive click event notifications"
}
},
"required": [
"link_id",
"url"
]
}Esquema de salida
{
"type": "object",
"additionalProperties": true
}🔴unsubscribe_link_webhook(link_id, url)
Unsubscribe a webhook URL from a specific link's click events.
Esquema de entrada
{
"type": "object",
"properties": {
"link_id": {
"type": "integer",
"description": "The ID of the link"
},
"url": {
"type": "string",
"description": "The webhook URL to unsubscribe"
}
},
"required": [
"link_id",
"url"
]
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada25 herramientas
verificadoversión no registrada25 herramientas
verificadoversión no registrada25 herramientas