Skip to main content
Glama
Linkly MCP Server

Linkly MCP Server

Servidor MCP de Linkly

Claude connector directory Glama MCP registry

Servidor oficial del Model Context Protocol (MCP) para Linkly, la plataforma de acortador de URL y gestión de enlaces.

Este repositorio impulsa el servidor MCP alojado en https://mcp.linklyhq.com. Esa es la única forma compatible de conectar un asistente de IA a Linkly mediante MCP. Consulta https://linklyhq.com/support/mcp-server para obtener instrucciones de configuración.

⚠️ El paquete npm linkly-mcp-server está obsoleto. El flujo autohospedado / con clave de API ya no se mantiene. Todos los usuarios deben migrar al servidor alojado: utiliza OAuth 2.1 con PKCE, no requiere claves de API ni instalación local, y siempre ejecuta el conjunto de herramientas más reciente. El paquete npm seguirá existiendo en el registro por compatibilidad con versiones anteriores, pero no recibirá nuevas herramientas ni correcciones de errores, y podría dejar de publicarse en el futuro.

Documentación

Para documentación completa, guías de configuración y ejemplos, visita: https://linklyhq.com/support/mcp-server

Related MCP server: filoo MCP server

Características

  • Crear, actualizar y eliminar enlaces cortos

  • Ver análisis y estadísticas de clics

  • Gestionar dominios personalizados y favicons

  • Configurar webhooks para eventos de clics

  • Buscar y filtrar enlaces

  • Exportar datos de clics

Uso del servidor alojado

URL del servidor: https://mcp.linklyhq.com

Conecta tu cliente MCP al servidor alojado e inicia sesión en Linkly cuando se abra tu navegador. Eso es todo: sin claves de API, sin instalación, sin desviación de configuración.

Claude Desktop

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Claude Code (CLI)

claude mcp add --transport http linkly https://mcp.linklyhq.com

ChatGPT Desktop

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

Herramientas disponibles

Herramienta

Descripción

create_link

Crear un nuevo enlace corto

update_link

Actualizar un enlace existente

delete_link

Eliminar un enlace

get_link

Obtener detalles de un enlace

list_links

Listar todos los enlaces del espacio de trabajo

search_links

Buscar enlaces por nombre, URL o nota

get_analytics

Obtener datos de clics en series temporales

get_analytics_by

Obtener clics agrupados por dimensión

get_clicks

Obtener datos de clics recientes

export_clicks

Exportar registros de clics detallados

list_domains

Listar dominios personalizados

create_domain

Añadir un dominio personalizado

delete_domain

Eliminar un dominio personalizado

update_domain_favicon

Actualizar el favicon del dominio

list_webhooks

Listar webhooks del espacio de trabajo

subscribe_webhook

Añadir un webhook

unsubscribe_webhook

Eliminar un webhook

list_link_webhooks

Listar webhooks específicos de enlaces

subscribe_link_webhook

Añadir un webhook de enlace

unsubscribe_link_webhook

Eliminar un webhook de enlace

Enlaces

Soporte

Para ayuda y soporte, visita Soporte de Linkly o escribe a support@linklyhq.com.

Publicación en el registro de MCP (mantenedores)

El server.json en la raíz del repositorio es el manifiesto del registro oficial de MCP para el servidor com.linklyhq/linkly. Es solo remoto: apunta a los clientes al servidor alojado y, a propósito, no incluye ningún paquete (la distribución npm obsoleta se eliminó en v2.0.0).

La publicación requiere acceso DNS a linklyhq.com: el espacio de nombres com.linklyhq se verifica mediante un registro DNS TXT en el ápice del dominio:

# 1. Generate an Ed25519 key + TXT record (macOS: use openssl@3; system LibreSSL lacks Ed25519)
openssl genpkey -algorithm Ed25519 -out key.pem
PUBLIC_KEY="$(openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | base64)"
echo "linklyhq.com. IN TXT \"v=MCPv1; k=ed25519; p=${PUBLIC_KEY}\""   # add at the APEX of linklyhq.com

# 2. Authenticate the namespace + publish
PRIVATE_KEY="$(openssl pkey -in key.pem -noout -text | grep -A3 'priv:' | tail -n +2 | tr -d ' :\n')"
mcp-publisher login dns --domain linklyhq.com --private-key "$PRIVATE_KEY"
mcp-publisher publish

Consulta la guía de autenticación del registro para obtener más detalles.

Actualización de la aplicación de ChatGPT (mantenedores)

chatgpt-app-submission.json es la importación de envío del SDK de Apps de OpenAI: rellena previamente las anotaciones por herramienta y las tres justificaciones de seguridad (solo lectura / mundo abierto / destructivo) para las 25 herramientas, para que no haya que escribirlas a mano en el panel.

OpenAI congela una instantánea de metadatos en el momento de la publicación y no detecta automáticamente los cambios de MCP, por lo que después de implementar cambios en el servidor se publica una nueva versión:

  1. Implementa el worker (haz push a la rama conectada / wrangler deploy).

  2. Panel de la plataforma → la aplicación Linkly → crea una nueva versión borrador (mantén la misma URL de MCP https://mcp.linklyhq.com).

  3. En la sección MCP, haz clic en Scan Tools para volver a leer la lista de herramientas en vivo y las anotaciones.

  4. Arrastra chatgpt-app-submission.json al formulario (parte superior de la página) para rellenar las justificaciones.

  5. Revisa Testing y luego Submit. La versión publicada sigue ejecutándose contra el servidor en vivo hasta que se apruebe la nueva.

Mantén este archivo sincronizado con el worker siempre que se añadan o eliminen herramientas o cambien sus readOnlyHint/destructiveHint. La marca destructiva es true solo para las 5 herramientas realmente destructivas (delete_link, delete_domain, batchDeleteLinks, unsubscribe_webhook, unsubscribe_link_webhook); las creaciones/actualizaciones/suscripciones son aditivas (false).

Licencia

MIT

Available Tools

20 tools
create_domainCInspect

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

Inputs: name (required).

delete_domainCInspect

Remove a custom domain from the workspace.

Inputs: domain_id (required).

export_clicksCInspect

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

Inputs: end, bots, start, country, +2 more.

get_analyticsAInspect

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

Inputs: end, bots, start, unique, +5 more.

get_analytics_byBInspect

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

Inputs: counter (required), end, bots, start, +4 more.

get_clicksCInspect

Get recent click data for the workspace

Inputs: link_id.

list_domainsBInspect

List all custom domains in the workspace.

Inputs: no named parameters.

list_webhooksAInspect

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

Inputs: no named parameters.

subscribe_webhookCInspect

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

Inputs: url (required).

unsubscribe_webhookCInspect

Unsubscribe a webhook URL from workspace click events.

Inputs: url (required).

update_domain_faviconCInspect

Update the favicon URL for a custom domain.

Inputs: domain_id (required), favicon_url (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 20 tools

    Disambiguation5/5

    Each tool has a distinct purpose with clear boundaries, targeting specific resources (domains, links, webhooks, analytics) and actions (create, delete, get, list, update, subscribe, unsubscribe, export). There is no overlap or ambiguity; for example, get_analytics and get_analytics_by serve different analytical functions, and webhook tools are clearly separated by scope (link-specific vs. workspace-wide).

    Naming Consistency5/5

    Tool names follow a consistent verb_noun pattern throughout, with verbs like create, delete, get, list, update, subscribe, unsubscribe, export, and search applied to nouns such as domain, link, webhook, analytics, and clicks. There are no deviations in style (e.g., no camelCase or mixed conventions), making the set predictable and readable.

    Tool Count4/5

    With 20 tools, the count is slightly high but reasonable for a link management and analytics domain, covering domains, links, webhooks, and analytics comprehensively. It avoids being excessive (e.g., not over 25) and each tool appears justified, though it could be streamlined slightly without losing functionality.

    Completeness5/5

    The tool set provides complete CRUD/lifecycle coverage for domains (create, list, delete, update_favicon), links (create, get, list, update, delete, search), and webhooks (subscribe, unsubscribe, list for both link-specific and workspace-wide). Analytics tools (get_analytics, get_analytics_by, export_clicks, get_clicks) offer robust data access, leaving no obvious gaps for agent workflows in this domain.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables interaction with the Firelinks link shortening platform to create and manage short links, track click statistics, manage custom domains, and compare analytics periods through natural language.
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to shorten URLs, manage links, and track click analytics through 8 first-class tools, designed for use with Claude Desktop, Cursor, and other MCP clients.
      9
      46 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables users to shorten links, bulk create URLs, generate QR codes, manage and disable links, and retrieve click analytics from MCP clients like Claude, ChatGPT, Cursor, and n8n.
      9
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables users to shorten links, bulk-create URLs, generate QR codes, and retrieve click analytics through MCP clients such as Claude, ChatGPT, Cursor, and n8n.
      9
      40 npm
      MIT