Servers Playground How we check Add a server Log in

Linkly

Working · 1.6 s

com.linklyhq/linklyv2.0.0 Domain verified

Create and manage short links, track clicks, and automate URL management

Marketing & SEO

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.linklyhq.com

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

batchDeleteLinks Destructive

Batch delete multiple links

idsarray, required

Array of link IDs to delete

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Linkly MCP server | mcptry

Tools (25)

batchDeleteLinks

Batch delete multiple links

destructive

Argument	Type	Description
ids*	array	Array of link IDs to delete

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ids"
  ],
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Array of link IDs to delete"
    }
  }
}

create_domain

Add a custom domain to the workspace. The domain must be configured to point to Linkly's servers.

Argument	Type	Description
name*	string	The domain name (e.g., 'links.example.com')

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The domain name (e.g., 'links.example.com')"
    }
  }
}

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.

Argument	Type	Description
url*	string	The destination URL for the link (required)
name	string	A nickname for the link to identify it later
note	string	A private note about this link
slug	string	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	string	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	string	Google Tag Manager container ID
enabled	boolean	Whether the link is active (default: true)
cloaking	boolean	Hide destination URL by opening in an iframe
og_image	string	Open Graph image URL for social media previews

delete_domain

Remove a custom domain from the workspace.

destructive

Argument	Type	Description
domain_id*	integer	The ID of the domain to delete

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain_id"
  ],
  "properties": {
    "domain_id": {
      "type": "integer",
      "description": "The ID of the domain to delete"
    }
  }
}

delete_link

Delete a Linkly link by its ID

destructive

Argument	Type	Description
link_id*	integer	The ID of the link to delete

Input schema (JSON)

{
  "type": "object",
  "required": [
    "link_id"
  ],
  "properties": {
    "link_id": {
      "type": "integer",
      "description": "The ID of the link to delete"
    }
  }
}

export_clicks

Export detailed click records with full information (timestamp, browser, country, URL, platform, referer, bot, ISP, params).

read-only

Argument	Type	Description
end	string	End date in YYYY-MM-DD format (default: yesterday)
bots	string	Bot filtering
start	string	Start date in YYYY-MM-DD format (default: 30 days ago)
country	string	Filter by country code
link_id	integer	Filter by specific link ID
platform	string	Filter by platform

Input schema (JSON)

{
  "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"
    }
  }
}

get_analytics

Get time-series click analytics data for charting. Returns click counts over time.

read-only

Argument	Type	Description
end	string	End date in YYYY-MM-DD format (default: today)
bots	string	Bot filtering: include (default), exclude, or only
start	string	Start date in YYYY-MM-DD format (default: 30 days ago)
unique	boolean	Count unique clicks only (by IP)
browser	string	Filter by browser name
country	string	Filter by country code (e.g., 'US', 'GB')
link_id	integer	Filter by specific link ID
platform	string	Filter by platform (e.g., 'desktop', 'mobile', 'tablet')
frequency	string	Time granularity: 'day' (default) or 'hour'

Input schema (JSON)

get_analytics_by

Get click counts grouped by a dimension (country, platform, referrer, etc.). Useful for breakdowns and top-N reports.

read-only

Argument	Type	Description
end	string	End date in YYYY-MM-DD format (default: today)
bots	string	Bot filtering
start	string	Start date in YYYY-MM-DD format (default: 30 days ago)
unique	boolean	Count unique clicks only
counter*	string	Dimension to group by (required)
country	string	Filter by country code
link_id	integer	Filter by specific link ID
platform	string	Filter by platform

Input schema (JSON)

{
  "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"
    }
  }
}

get_clicks

Get recent click data for the workspace

read-only

Argument	Type	Description
link_id	integer	Optional: filter clicks by link ID

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "link_id": {
      "type": "integer",
      "description": "Optional: filter clicks by link ID"
    }
  }
}

get_link

Get details of a specific Linkly link by its ID

read-only

Argument	Type	Description
link_id*	integer	The ID of the link to retrieve

Input schema (JSON)

{
  "type": "object",
  "required": [
    "link_id"
  ],
  "properties": {
    "link_id": {
      "type": "integer",
      "description": "The ID of the link to retrieve"
    }
  }
}

list_domains

List all custom domains in the workspace.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {}
}

list_link_webhooks

List all webhook URLs subscribed to a specific link.

read-only

Argument	Type	Description
link_id*	integer	The ID of the link

Input schema (JSON)

{
  "type": "object",
  "required": [
    "link_id"
  ],
  "properties": {
    "link_id": {
      "type": "integer",
      "description": "The ID of the link"
    }
  }
}

list_links

List links with sorting and search

read-only

Argument	Type	Description
page	integer
search	string	Search Query
sort_by	string	Field to sort by
sort_dir	string	Sort direction
page_size	integer

Input schema (JSON)

{
  "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"
    }
  }
}

list_webhooks

List all webhook URLs subscribed to the workspace. These receive click events for all links.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {}
}

list_workspaces

Return details of authenticated workspace

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {}
}

ping

Health check

read-only

Argument	Type	Description
message*	string	a message to ping , default to Hello From Linkkly

Input schema (JSON)

{
  "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

Argument	Type	Description
query*	string	Search query to match against link names, URLs, and notes

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query to match against link names, URLs, and notes"
    }
  }
}

subscribe_link_webhook

Subscribe a webhook URL to receive click events for a specific link.

Argument	Type	Description
url*	string	The webhook URL to receive click event notifications
link_id*	integer	The ID of the link

Input schema (JSON)

{
  "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"
    }
  }
}

subscribe_webhook

Subscribe a webhook URL to receive click events for all links in the workspace.

Argument	Type	Description
url*	string	The webhook URL to receive click event notifications

Input schema (JSON)

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "The webhook URL to receive click event notifications"
    }
  }
}

test_authentication

Test API Authentication

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {}
}

unsubscribe_link_webhook

Unsubscribe a webhook URL from a specific link's click events.

destructive

Argument	Type	Description
url*	string	The webhook URL to unsubscribe
link_id*	integer	The ID of the link

Input schema (JSON)

{
  "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

Argument	Type	Description
url*	string	The webhook URL to unsubscribe

Input schema (JSON)

{
  "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

Argument	Type	Description
domain_id*	integer	The ID of the domain to update
favicon_url*	string	URL to the favicon image

Input schema (JSON)

{
  "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"
    }
  }
}

update_link

Update an existing Linkly link by its ID

destructive

Argument	Type	Description
url	string	New destination URL
name	string	New nickname for the link
note	string	New private note
gtm_id	string	Google Tag Manager ID
enabled	boolean	Whether the link is active
link_id*	integer	The ID of the link to update (required)
cloaking	boolean	Enable URL cloaking
og_image	string	Open Graph image URL
og_title	string	Open Graph title
utm_term	string	UTM term parameter
block_bots

update_workspace

Update workspace settings. Only the fields provided are changed; omitted fields keep their current values.

destructive

Argument	Type	Description
name	string	Workspace name
webhooks	array	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.

Input schema (JSON)

{
  "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."
    }
  }
}

Input schema (JSON)

{
  "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)"
    }
  }
}

{
  "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'"
    }
  }
}

Input schema (JSON)

{
  "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"
    }
  }
}