Linq.es MCP Server

● Active

io.github.giulianobr/linqes-mcp

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

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "linqes-mcp": {
      "url": "https://linq.es/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http linqes-mcp https://linq.es/mcp
VS Code
code --add-mcp '{"name":"linqes-mcp","type":"http","url":"https://linq.es/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Data & Analytics
Version
1.0.0
Registry
active
Published
11/15/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: Linq.es MCP Server is maintained, open source, hosted endpoint answering without a key.

Maintained
Active
Last commit 6 days ago (Nov 16, 2026), 0 open issues.
Official registry
Active
Published as io.github.giulianobr/linqes-mcp in the official MCP registry, version 1.0.0.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
Hosted by the publisher
Your client talks to linq.es: prompts and tool arguments leave your machine for that host.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 08:08 UTCStatus history & uptime →
● Working282 msprotocol 2025-03-26v1.0.0tools

The endpoint answered the MCP handshake as "linqes-mcp" and listed 10 tools. Answering since Nov 18, 2026.

Context cost ≈ 5.4k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 10 tools.

Tools (10)

  • list_profiles

    Lists every Linq.es Link-in-Bio profile owned by the authenticated user. When to use: call this first to discover valid 'profile' handles before calling get_profile_analytics, list_profile_links, add_profile_link, update_profile_link, import_bio_links, or list_leads; use list_shortlinks instead for standalone linq.es/s/:code redirects. Prerequisites: requires an authenticated Linq.es Pro credential via Authorization: Bearer lnq_live_<key> on tools/call. Validation: requires no input parameters; returns isError: true if the authenticated user account cannot be loaded. Side effects: read-only and idempotent; modifies no data or caches. Returns: JSON text with {username, subscription, profiles: [{profileName, name, headline, theme, listedInExplore, publicUrl, viewCount}]}.

  • get_profile_analytics2 params

    Returns aggregated page views, link clicks, click-through rate (ctrPercent), top referrers, visitor countries, device categories, and daily time-series buckets for a Linq.es profile. When to use: choose this for traffic, referrer, geo, device, and CTR reporting on a Link-in-Bio page; use list_profile_links for per-link configuration and all-time link click totals, list_shortlinks for /s/:code shortlink clicks, or list_leads for contact form submissions. Prerequisites: requires Bearer lnq_live_<key> Pro authentication and a 'profile' handle owned by the caller (call list_profiles first if unknown). Validation: 'profile' must be non-empty and owned by the authenticated user (otherwise returns isError: true); 'days' defaults to 7, values <= 0 reset to 7, and values > 90 clamp to 90. Side effects: read-only and idempotent; performs no state mutations. Returns: JSON text with {profile, days, totalViews, totalClicks, ctrPercent, referrers, countries, devices, dailySeries: [{date, views, clicks, referrers, countries, devices, links}]}.

    Show parameters
    • daysintegerLookback window in UTC calendar days between 1 and 90 (defaults to 7 when omitted or <= 0; values above 90 are clamped to 90).
    • profilestringrequiredOwned Linq.es profile handle without leading '@' or URL prefix (e.g. 'alex'). Obtain valid handles from list_profiles.
  • list_profile_links1 param

    Lists all link buttons and header social icons (both active and inactive) configured on a Linq.es Link-in-Bio profile. When to use: call this to inspect profile links and obtain each link's unique 'key' and current field values before calling update_profile_link or delete_profile_link; use list_shortlinks instead for standalone linq.es/s/:code redirect URLs. Prerequisites: requires Bearer lnq_live_<key> Pro authentication and a 'profile' handle owned by the caller (discoverable via list_profiles). Validation: returns isError: true if 'profile' is empty or does not belong to the authenticated user. Side effects: read-only and idempotent; does not modify links or caches. Returns: JSON text with {profile, count, links: [{key, title, url, description, active, profile, owner, order, isSocial, sectionId, badgeText, animation, type, scheduleStart, scheduleEnd, showCountdown, showClickBadge, iosUrl, androidUrl, isPasswordProtected, isSensitive, isFeatured, createDate, editDate, analytics: {clickCount, lastClicked}}]}.

    Show parameters
    • profilestringrequiredOwned Linq.es profile handle whose link cards and social icons should be listed (e.g. 'alex').
  • add_profile_link11 params

    Creates a new active link card or header social icon on a Linq.es Link-in-Bio profile, with automatic rich media type detection (YouTube, Spotify, etc.), optional highlight badge, iOS/Android smart routing, scheduled visibility window, countdown badge, and live click counter badge. When to use: choose add_profile_link to append one new link to a profile page; use update_profile_link to edit or toggle an existing link by 'key', import_bio_links to bulk-import from an external bio page, or create_shortlink to create a standalone linq.es/s/:code redirect. Prerequisites: requires Bearer lnq_live_<key> Pro authentication and an owned 'profile' handle (call list_profiles first if unknown). Validation and limits: 'title' must be non-empty; 'url' (and optional 'iosUrl', 'androidUrl' when provided) must use http:// or https://; optional 'scheduleStart' and 'scheduleEnd' must be valid RFC3339 timestamps (e.g. '2026-10-15T14:00:00Z'); enforces the Pro quota of 100 links per profile, returning isError: true on validation or quota errors. Side effects: non-idempotent (each call inserts a new Firestore link document with active: true) and immediately purges in-memory, HTML, and CDN caches for https://linq.es/<profile>. Returns: JSON text with {status, cacheStatus, message, profile, title, url} where cacheStatus is 'purged' when all cache tiers evicted cleanly or 'degraded' if an external cache purge failed (call list_profile_links afterward if you need the newly generated 'key').

    Show parameters
    • androidUrlstringOptional http:// or https:// override URL opened specifically for Android visitors (e.g. Google Play URL).
    • badgeTextstringOptional short pill badge label displayed on the link card (e.g. 'NEW', 'HOT', 'LIVE').
    • iosUrlstringOptional http:// or https:// override URL opened specifically for iPhone and iPad visitors (e.g. Apple App Store URL).
    • isSocialbooleanSet true to render as a compact social icon in the profile header instead of a full-width link button (defaults to false).
    • profilestringrequiredOwned Linq.es profile handle to append the link to (e.g. 'alex').
    • scheduleEndstringOptional RFC3339 UTC timestamp when the link automatically hides from the public profile (e.g. '2026-10-20T14:00:00Z').
    • scheduleStartstringOptional RFC3339 UTC timestamp when the link becomes publicly clickable (e.g. '2026-10-15T14:00:00Z').
    • showClickBadgebooleanSet true to display a public click-count social-proof badge on the link card (defaults to false).
    • showCountdownbooleanSet true to render a live countdown timer on the public card until 'scheduleStart' is reached (defaults to false).
    • titlestringrequiredVisible button label or social network name displayed on the profile (e.g. 'Download on iOS & Android').
    • urlstringrequiredDefault destination URL starting with http:// or https:// used for desktop and fallback visitors.
  • update_profile_link11 params

    Updates an existing link card or header social icon on a Linq.es Link-in-Bio profile by its unique 'key', while preserving its section placement, animation, and existing schedule timestamps. When to use: choose update_profile_link to change a link's title, URLs, badge, or visibility (set active: false to hide a link non-destructively while keeping its click history); use delete_profile_link only for permanent removal, or add_profile_link to create a new link. Prerequisites: requires Bearer lnq_live_<key> Pro authentication; call list_profile_links first to obtain 'key' and current values, because omitted optional string fields ('badgeText', 'iosUrl', 'androidUrl') are cleared to empty strings whereas omitted boolean flags ('isSocial', 'showCountdown', 'showClickBadge') retain their stored values. Validation: 'key', 'profile', and 'title' must be non-empty; 'url' (and any non-empty 'iosUrl' or 'androidUrl') must start with http:// or https://; returns isError: true if 'key' does not exist or is not owned by the caller. Side effects: idempotent for identical arguments; overwrites the link document in Firestore and immediately purges the owning profile's multi-layer cache. Returns: JSON text with {status, cacheStatus, message, key} where cacheStatus is 'purged' or 'degraded'.

    Show parameters
    • activebooleanrequiredSet true to publish the link on the public profile, or false to hide it without deleting analytics.
    • androidUrlstringAndroid http:// or https:// override URL (pass existing value to keep it, or omit/pass '' to clear Android routing).
    • badgeTextstringHighlight pill badge text (pass existing value to keep it, or omit/pass '' to clear the badge).
    • iosUrlstringiOS http:// or https:// override URL (pass existing value to keep it, or omit/pass '' to clear iOS routing).
    • isSocialbooleanOptional boolean controlling whether the item renders as a header social icon; if omitted, preserves the existing stored value.
    • keystringrequiredUnique Firestore document key of the link to update, retrieved from list_profile_links.
    • profilestringrequiredOwned Linq.es profile handle associated with the link (e.g. 'alex').
    • showClickBadgebooleanOptional boolean toggling the public click-count badge; if omitted, preserves the existing stored value.
    • showCountdownbooleanOptional boolean toggling the countdown timer badge; if omitted, preserves the existing stored value.
    • titlestringrequiredUpdated visible button label or social icon title.
    • urlstringrequiredUpdated default destination URL starting with http:// or https://.
  • delete_profile_link1 param

    Permanently deletes a link card or header social icon from a Linq.es Link-in-Bio profile by its unique 'key'. When to use: use only when the user explicitly wants permanent removal; prefer update_profile_link with active: false to temporarily hide a link while preserving its click history. Prerequisites: requires Bearer lnq_live_<key> Pro authentication; call list_profile_links first to look up and confirm the exact 'key' belonging to the user. Validation: 'key' must be non-empty and belong to the authenticated user; if the key is missing, already deleted, or owned by another user, returns isError: true ('Link not found or access denied.'). Side effects: destructive and irreversible (deletes the link document from Firestore and immediately purges in-memory, HTML, and CDN caches for the owning profile). Returns: JSON text with {status, cacheStatus, message, key} where cacheStatus is 'purged' or 'degraded'.

    Show parameters
    • keystringrequiredUnique Firestore document key of the link to permanently delete, obtained from list_profile_links.
  • import_bio_links2 params

    Fetches a public external Link-in-Bio page (such as Linktree, Beacons, Bio.link, Carrd, or a personal links page) over HTTP/HTTPS, extracts outbound links from its HTML, and appends them as active link cards on a Linq.es profile. When to use: choose this for bulk migration from an external public bio URL; use add_profile_link instead when adding individual links with custom badges, smart routing, or schedules. Prerequisites: requires Bearer lnq_live_<key> Pro authentication and an owned 'profile' handle (call list_profiles first if unknown). Validation and safety limits: auto-prepends https:// if the scheme is omitted; blocks loopback, private, link-local, and cloud-metadata addresses (SSRF protection); enforces a 6-second fetch timeout, at most 3 redirects, and a 512 KiB HTML read cap; imports only up to remaining capacity under the 100-link Pro per-profile limit, returning isError: true if the profile is unowned or the remote page fails to load. Side effects: performs an open-world outbound HTTP GET request, inserts new Firestore link documents non-idempotently (re-running against the same source URL appends duplicates), and purges the target profile's public caches. Returns: JSON text with {status, cacheStatus, profile, importedCount, message} where cacheStatus is 'purged' or 'degraded'.

    Show parameters
    • profilestringrequiredOwned target Linq.es profile handle where extracted links will be appended (e.g. 'alex').
    • urlstringrequiredPublic HTTP/HTTPS URL of the external bio page to scrape outbound links from (e.g. 'https://linktr.ee/username').
  • list_shortlinks1 param

    Lists standalone ultra-short redirect links (https://linq.es/s/:code) owned by the authenticated user, optionally filtered by associated 'profile' handle, including click counts, iOS/Android routing overrides, and UTM campaign tags. When to use: call this to audit /s/:code shortlinks, check click totals, or verify existing vanity slugs before calling create_shortlink; use list_profile_links instead for buttons displayed on a https://linq.es/<profile> Link-in-Bio page. Prerequisites: requires Bearer lnq_live_<key> Pro authentication; if filtering by 'profile', call list_profiles first when handles are unknown. Validation: optional 'profile' trims whitespace; omitting 'profile' returns all shortlinks owned by the user across every profile. Side effects: read-only and idempotent; modifies no data. Returns: JSON text with {totalShortLinks, totalClicks, links: [{code, targetUrl, iosUrl, androidUrl, title, owner, profile, active, createdAt, updatedAt, expiresAt, isPasswordProtected, clickCount, utmSource, utmMedium, utmCampaign, utmTerm, utmContent}]}.

    Show parameters
    • profilestringOptional Linq.es profile handle to filter shortlinks associated with a specific profile; omit to list all account shortlinks.
  • create_shortlink11 params

    Creates an active standalone redirect shortlink at https://linq.es/s/:code with an optional custom vanity slug, smart iOS/Android device redirects, optional profile attribution, and automatic UTM query parameter injection. When to use: choose create_shortlink for standalone shareable redirect URLs used in social posts, newsletters, QR codes, or ad campaigns; use add_profile_link instead to add a visible button to a Link-in-Bio profile page. Prerequisites: requires Bearer lnq_live_<key> Pro authentication; optionally call list_shortlinks first to check existing slugs or list_profiles to confirm a 'profile' handle. Validation and limits: 'targetUrl' (and optional 'iosUrl', 'androidUrl' when provided) must start with http:// or https://; optional 'code' must be 3-50 characters matching ^[a-zA-Z0-9_-]{3,50}$, must not use reserved system routes (such as admin, api, login, mcp, pricing, explore, tools), and must be globally unique across Linq.es (if 'code' is omitted, a random 6-character alphanumeric slug is generated); enforces the Pro cap of 500 shortlinks per account, returning isError: true on invalid URLs, slug collision, or quota exhaustion. Side effects: non-idempotent (creates a new shortlink when 'code' is omitted, or fails on duplicate 'code') and immediately activates https://linq.es/s/<code> in Firestore. Returns: JSON text with {status, code, shortUrl, targetUrl, shortlink: {code, targetUrl, iosUrl, androidUrl, title, owner, profile, active, createdAt, updatedAt, clickCount, utmSource, utmMedium, utmCampaign, utmTerm, utmContent}}.

    Show parameters
    • androidUrlstringOptional http:// or https:// destination override redirected to when opened on Android devices.
    • codestringOptional custom vanity slug for https://linq.es/s/<code> (3-50 letters, digits, hyphens, or underscores; omit to auto-generate a unique 6-char code).
    • iosUrlstringOptional http:// or https:// destination override redirected to when opened on iOS/iPadOS devices.
    • profilestringOptional owned Linq.es profile handle to associate this shortlink with for filtering in list_shortlinks.
    • targetUrlstringrequiredDefault destination URL starting with http:// or https:// where visitors are redirected.
    • titlestringOptional internal label to identify the shortlink in dashboard listings and analytics.
    • utmCampaignstringOptional utm_campaign query parameter appended to the destination URL on redirect (e.g. 'spring_launch').
    • utmContentstringOptional utm_content variant parameter appended to the destination URL on redirect (e.g. 'header_cta').
    • utmMediumstringOptional utm_medium query parameter appended to the destination URL on redirect (e.g. 'social', 'cpc', 'qr').
    • utmSourcestringOptional utm_source query parameter appended to the destination URL on redirect (e.g. 'newsletter', 'instagram').
    • utmTermstringOptional utm_term paid keyword parameter appended to the destination URL on redirect.
  • list_leads2 params

    Retrieves contact submissions (name, email, phone, message, campaign tag, and timestamp) captured via a Linq.es profile's Lead Magnet form, up to 'limit' records. When to use: choose this to inspect audience signups, newsletter subscribers, and contact inquiries submitted on a profile; use get_profile_analytics instead for anonymous traffic, referrer, and click metrics. Prerequisites: requires Bearer lnq_live_<key> Pro authentication and an owned 'profile' handle (call list_profiles first if unknown; returns an empty list if Lead Capture has not yet received submissions). Validation: returns isError: true if 'profile' is empty or not owned by the caller; 'limit' defaults to 50, values <= 0 reset to 50, and values > 200 clamp to 200. Side effects: read-only and idempotent; modifies no stored records (returned objects contain contact PII owned by the user). Returns: JSON text with {profile, count, leads: [{id, profile, formTitle, campaign, name, email, phone, message, createdAt}]}.

    Show parameters
    • limitintegerMaximum number of captured leads to return between 1 and 200 (defaults to 50 when omitted or <= 0; values above 200 are clamped to 200).
    • profilestringrequiredOwned Linq.es profile handle whose Lead Magnet form submissions should be returned (e.g. 'alex').

Checked by Serverdex with a plain initialize + tools/list call to linq.es/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 16, 2026
Stars
0
Forks
0
Last push
Nov 16, 2026
License
MIT

claude-plugincursor-plugingemini-cli-extensionlink-in-biomcpmcp-servermodel-context-protocolurl-shortener

From the README

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 lnqlive...) 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 Desktop / .mcp.json Cursor (~/.cursor/mcp.json or .cursor/mcp.json) Gemini CLI (~/.gemini/settings.json) OpenAI Codex CLI (~/.codex/config.toml) Available MCP Tools (10 Tools) Full tool schemas and workflows are documented in skills/linqes-mcp/SKILL.md and at https://linq.es/integrations/mcp. Repository Manifests Publishing / Updating the Official MCP Registry Support & Contact • Website: https://linq.es • MCP Documentation: https://linq.es/integrations/mcp • Help Center: https://linq.es/help • Contact: hello@linq.es

Read the full README on GitHub →

Remotes

  • streamable-httphttps://linq.es/mcp

The most-starred Data & Analytics servers in the index, with their live-check result.

ServerStarsLast pushLive check
PostHog41,013Nov 2026Needs sign-in
PostHog MCP Server40,870Nov 2026Needs sign-in
Agent-Native Analytics7,735Nov 2026Needs sign-in
TradingMCP5,320Nov 2026Needs sign-in
Jitsu5,138Nov 2026Needs sign-in

Linq.es MCP Server: questions people ask

Is Linq.es MCP Server a remote or a local MCP server?
According to its entry in the official MCP registry, Linq.es MCP Server ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does Linq.es MCP Server need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is Linq.es MCP Server safe to use?
Looks healthy: Linq.es MCP Server is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Linq.es MCP Server still maintained?
Active: the repository's last commit 6 days ago. Last push Nov 16, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 16, 2026.
What tools does Linq.es MCP Server expose?
10 tools as listed by the server itself during the live check, including list_profiles, get_profile_analytics, list_profile_links, add_profile_link, update_profile_link. The full list with parameters is in the Live check section above.
How do I add Linq.es MCP Server to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Data & Analytics →

Add the badge to your site

Show visitors that Linq.es MCP Server is listed here — it’s also the link we check for a free listing.

Linq.es MCP Server — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-giulianobr-linqes-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Linq.es MCP Server — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Linq.es MCP Server — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-giulianobr-linqes-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-giulianobr-linqes-mcp) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-giulianobr-linqes-mcp) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-giulianobr-linqes-mcp)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-giulianobr-linqes-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-giulianobr-linqes-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-giulianobr-linqes-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).