1. Generate a Personal API Key (lnq_live_...)
In your Linq.es Pro dashboard, open Account Settings (/admin/account-settings) and generate a Personal API Key. Raw keys are shown once and stored as SHA-256 hashes.
Model Context Protocol • Streamable HTTP (2025-03-26)
Official Linq.es MCP Server for AI Agents & IDEs
Manage your Link-in-Bio profiles, custom linq.es/s/ shortlinks, GA4 UTM tags, 90-day click analytics, and captured leads straight from Claude Desktop, Cursor, Windsurf, and Gemini CLI — zero local setup required.
Remote Endpoint
https://linq.es/mcp
Transport
Streamable HTTP (JSON-RPC 2.0)
MCP Protocol
2025-03-26 • 10 Tools
Authentication
Bearer lnq_live_...
Included In
Linq.es Pro (€3.25/mo billed annually • €5.99/mo)
Connect Your AI Client in 60 Seconds
No npx wrappers or local daemons — hosted directly on EU Google Cloud behind Cloudflare Edge.
2. Paste the config snippet into your MCP client
Point Claude Desktop, Claude Code, Cursor, Windsurf, or Gemini CLI directly to https://linq.es/mcp — zero local npm packages, Python venvs, or Docker containers required.
3. Manage bio pages, /s/ shortlinks & leads in plain English
Ask your AI agent to spin up UTM-tagged vanity shortlinks, publish launch links with countdown badges, migrate a Linktree page, or summarize 90-day analytics and captured leads.
Ready-to-Paste Client Configurations
Replace lnq_live_YOUR_PERSONAL_API_KEY with the token generated in /admin/account-settings.
Claude Desktop & Claude Code
{
"mcpServers": {
"linqes": {
"type": "http",
"url": "https://linq.es/mcp",
"headers": {
"Authorization": "Bearer lnq_live_YOUR_PERSONAL_API_KEY"
}
}
}
}
# Or via Claude Code CLI:
claude mcp add --transport http linqes https://linq.es/mcp \
--header "Authorization: Bearer lnq_live_YOUR_PERSONAL_API_KEY"
Cursor IDE
{
"mcpServers": {
"linqes": {
"url": "https://linq.es/mcp",
"headers": {
"Authorization": "Bearer lnq_live_YOUR_PERSONAL_API_KEY"
}
}
}
}
Windsurf (Cascade)
{
"mcpServers": {
"linqes": {
"serverUrl": "https://linq.es/mcp",
"headers": {
"Authorization": "Bearer lnq_live_YOUR_PERSONAL_API_KEY"
}
}
}
}
Gemini CLI
{
"mcpServers": {
"linqes": {
"httpUrl": "https://linq.es/mcp",
"headers": {
"Authorization": "Bearer lnq_live_YOUR_PERSONAL_API_KEY"
}
}
}
}
All 10 Official MCP Tools Built In
Every write tool enforces account quotas and automatically purges L1, L2, and Cloudflare Edge caches.
| Tool Name | Parameters | Description |
|---|---|---|
| list_profiles | (none) | Lists all Link-in-Bio profiles owned by your account (up to 5 on Pro), including headline, theme, public URL, and total views. |
| get_profile_analytics | profile*, days (1–90) | Returns aggregated page views, link clicks, CTR, top referrers, countries, devices, and daily time-series metrics. |
| list_profile_links | profile* | Lists every link and header social icon on a profile with keys, active status, click counts, and iOS/Android URLs. |
| add_profile_link | profile*, title*, url*, badgeText, iosUrl, androidUrl, scheduleStart/End... | Adds a link button or social icon with optional highlight badge, live countdown timer, click proof badge, and mobile OS routing. |
| update_profile_link | key*, profile*, title*, url*, active*... | Updates title, destination URL, visibility, badges, or iOS/Android overrides on an existing profile link. |
| delete_profile_link | key* | Deletes a link by key and immediately purges profile caches across memory, GCS, and Cloudflare Edge. |
| import_bio_links | profile*, url* | Scrapes and imports public links from an external bio page (Linktree, Beacons, Bio.link) into your Linq.es profile. |
| list_shortlinks | profile (optional) | Lists all ultra-short redirect links (linq.es/s/:code) with click totals, device routing URLs, and UTM tags. |
| create_shortlink | targetUrl*, code, title, profile, iosUrl, androidUrl, utmSource/Medium/Campaign... | Creates a custom /s/ shortlink (up to 500 active on Pro) with GA4 UTM tags and optional iOS/Android deep-link overrides. |
| list_leads | profile*, limit (max 200) | Fetches contacts (Name, Email, WhatsApp/Phone, campaign, timestamp) captured via your profile's Lead Magnet form. |
Real-World Agent Prompts You Can Run Today
Ship release links, campaign UTMs, and lead reports without leaving your editor or chat:
Indie Founder / Product Launch
"Create a shortlink linq.es/s/v3-launch pointing to our changelog with utm_source=x and utm_campaign=v3, then add it to the top of my main profile with a NEW badge."
create_shortlink + add_profile_link
Growth & Conversion Audit
"Pull the last 30 days of analytics for my profile, compare CTR across all active links, and tell me our top 5 countries and referrers."
list_profiles + get_profile_analytics + list_profile_links
Sales & WhatsApp Lead Triage
"Fetch the 25 most recent leads captured on our agency profile and group them by campaign."
list_leads
Frequently Asked Questions
Do I need to install a local npm package or Docker container to use the Linq.es MCP Server?
No. Linq.es hosts a native remote Streamable HTTP MCP server (JSON-RPC 2.0, protocolVersion 2025-03-26) directly at https://linq.es/mcp. Any modern MCP client connects over HTTPS using your Authorization: Bearer lnq_live_... header.
Which plan includes Personal API Keys and MCP Server access?
MCP Server access and Personal API Keys (lnq_live_...) are included in Linq.es Pro at €39/year (€3.25/month) or €5.99/month (R$ 179/year via PIX in Brazil), alongside up to 5 profiles, 100 links per profile, and 500 custom /s/ shortlinks.
How are Personal API Keys secured?
Your raw lnq_live_ key is displayed once upon creation and never stored in plaintext—only its SHA-256 hash and display prefix are persisted. You can rotate or revoke your key instantly from /admin/account-settings.
Which AI clients work with https://linq.es/mcp?
Every MCP client supporting Streamable HTTP works out of the box, including Claude Desktop, Claude Code CLI, Cursor, Windsurf (Cascade), Gemini CLI, VS Code GitHub Copilot, and custom MCP SDK agents.