Repository avatar
Monitoring
v1.0.0
active

linqes-mcp

io.github.giulianobr/linqes-mcp

Manage Link-in-Bio pages, /s/ shortlinks, UTM tags, analytics, and captured leads on Linq.es.

Documentation

Linq.es Official MCP Server (https://linq.es/mcp)

Official Model Context Protocol (MCP) server manifests, IDE plugins, and agent skills for Linq.es - the server-rendered Link-in-Bio, /s/ URL shortener, QR code, vCard, and lead capture platform.

  • Remote MCP Endpoint: https://linq.es/mcp (streamable-http, JSON-RPC 2.0, protocolVersion: "2025-03-26")
  • Documentation: https://linq.es/integrations/mcp
  • Authentication: Personal API Key (Bearer lnq_live_...) generated in Linq.es Account Settings (/admin/account-settings/:profile)

No local Node.js runtime, Python environment, or Docker container is required. Connect any MCP-compatible client directly over HTTPS.


Quickstart Configuration

Claude Code CLI

claude mcp add --transport http linqes https://linq.es/mcp \
  --header "Authorization: Bearer ${LINQES_API_KEY}"

Claude Desktop / .mcp.json

{
  "mcpServers": {
    "linqes": {
      "type": "http",
      "url": "https://linq.es/mcp",
      "headers": {
        "Authorization": "Bearer ${LINQES_API_KEY}"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json or .cursor/mcp.json)

{
  "mcpServers": {
    "linqes": {
      "url": "https://linq.es/mcp",
      "headers": {
        "Authorization": "Bearer lnq_live_YOUR_PERSONAL_API_KEY"
      }
    }
  }
}

Gemini CLI (~/.gemini/settings.json)

{
  "mcpServers": {
    "linqes": {
      "httpUrl": "https://linq.es/mcp",
      "headers": {
        "Authorization": "Bearer $LINQES_API_KEY"
      }
    }
  }
}

OpenAI Codex CLI (~/.codex/config.toml)

[mcp_servers.linqes]
url = "https://linq.es/mcp"
bearer_token_env_var = "LINQES_API_KEY"

Available MCP Tools (10 Tools)

ToolDescription
list_profilesList all Link-in-Bio profiles owned by the authenticated account (profileName, publicUrl, theme, viewCount).
get_profile_analyticsRetrieve 7-to-90-day views, link clicks, CTR, top referrers, countries, devices, and daily time series.
list_profile_linksList every link card and social icon on a profile, including click counts, schedules, and device URLs.
add_profile_linkAdd a new link card or social icon with optional badges, iOS/Android routing, countdowns, and RFC3339 schedules.
update_profile_linkUpdate title, URL, active visibility, or routing rules on an existing profile link and purge edge cache.
delete_profile_linkDelete a link by key and immediately invalidate cached public profile HTML.
import_bio_linksImport public links from an existing Linktree, Beacons, or external bio URL into a Linq.es profile.
list_shortlinksList /s/:code branded shortlinks, click totals, device overrides, and GA4 UTM parameters.
create_shortlinkCreate a /s/:code shortlink with custom vanity slug, iOS/Android redirects, and GA4 UTM tags.
list_leadsRetrieve recent contacts (Name, Email, WhatsApp/Phone, timestamp) captured through inline Lead Magnet forms.

Full tool schemas and workflows are documented in skills/linqes-mcp/SKILL.md and at https://linq.es/integrations/mcp.


Repository Manifests

linqes-mcp/
├── .claude-plugin/
│   └── plugin.json          # Claude Code Plugin Directory manifest
├── .cursor-plugin/
│   └── plugin.json          # Cursor Marketplace plugin manifest
├── .mcp.json                # Shared Streamable HTTP MCP config (${LINQES_API_KEY})
├── gemini-extension.json    # Gemini CLI Extensions gallery manifest
├── glama.json               # Glama maintainer verification & awesome-mcp-servers CI
├── server.json              # Official MCP Registry manifest (io.github.giulianobr/linqes-mcp)
├── skills/
│   └── linqes-mcp/
│       └── SKILL.md         # Agent skill covering lnq_live_ auth + all 10 MCP tools
├── LICENSE                  # MIT License
└── README.md                # Setup & registry reference

Publishing / Updating the Official MCP Registry

brew install mcp-publisher
mcp-publisher login github
mcp-publisher publish

Support & Contact

No installation packages available.

Remote

streamable-http
https://linq.es/mcp