Youfiliate Smart Links MCP Server

by andrewmpierce Your server? Claim it

answering

Youfiliate Smart Links is answering right now. Last checked 5 min ago. 47 installs a week from pypi. It exposes 18 tools. Last commit 28 Apr 2026.

Create geo-targeted affiliate smart links, pull analytics, and rewrite YouTube descriptions.

Installs per day peak 19 · avg 8 · -13% w/w

a month agotoday

Uptime history 47 days of history

47 days agonow

100.0%

Uptime 24h

92 of 92 checks

Tools

read from the server

423 ms

Response time

average over 24h

Installs / week

npm and PyPI

Nothing serious here today

Today is the operative word: we check Youfiliate Smart Links every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 5 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add youfiliate-mcp --transport http https://youfiliate-mcp.onrender.com/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "youfiliate-mcp": {
      "url": "https://youfiliate-mcp.onrender.com/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.youfiliate-mcp]
url = "https://youfiliate-mcp.onrender.com/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "youfiliate-mcp": {
      "url": "https://youfiliate-mcp.onrender.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "youfiliate-mcp": {
      "url": "https://youfiliate-mcp.onrender.com/mcp"
    }
  }
}

This one needs environment variables set before it will start: YOUFILIATE_API_KEY (Your Youfiliate API key (starts with youfiliate_sk_). Generate one at https://youfiliate.com/settings.), YOUFILIATE_API_BASE_URL (Youfiliate backend URL.). The author declared them in the registry entry; get the values from the project itself.

Available tools 18

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

youfiliate

youfiliate_check_link_health

Trigger a health check for a specific smart link. Checks the default URL and all geo-rule URLs for availability. Returns the health status (healthy/broken/unknown). Rate limited to once per 5 minutes per link. Does NOT modify the link configuration. Common errors: - Rate limit: wait 5 minutes between health checks for the same link. - Smart link not found: check the ID.

youfiliate_connect_youtube

Initiate YouTube OAuth connection. Returns a URL the user must open in their browser. The user must open the returned URL in their web browser to authorize Youfiliate to access their YouTube channel. The OAuth callback is handled in the browser — this tool only returns the authorization URL. Does NOT read or modify any YouTube data. The OAuth flow is completed in the user's browser. Common errors: - Already connected: disconnect first with `youfiliate_disconnect_youtube`.

youfiliate_create_smart_link

Create a new geo-targeted smart link with an optional custom slug. Creates a smart link that redirects visitors to the destination URL. Optionally configure country-specific geo rules and deep linking for iOS/Android apps. Does NOT modify any existing links. Returns the created smart link details including its short URL (youfil.to/<slug>). Common errors: - Slug already taken: choose a different slug or omit for auto-generation. - Plan limit reached: upgrade your plan to create more links. - Invalid URL: ensure the destination URL is a valid HTTP/HTTPS URL.

youfiliate_delete_smart_link

Delete a smart link permanently. The short URL will stop working. IMPORTANT: Always confirm with the user before executing this action. The `confirm` parameter must be set to true. This is a destructive action that cannot be undone — the slug becomes available for reuse after a cooldown period. Does NOT affect other links or YouTube descriptions. Common errors: - Smart link not found: check the ID. - confirm=False: you must set confirm=True after getting user confirmation.

youfiliate_disconnect_youtube

Disconnect your YouTube account from Youfiliate. IMPORTANT: Always confirm with the user before executing this action. The `confirm` parameter must be set to true. This removes stored OAuth tokens. You will need to reconnect to use the auto-migration feature. Does NOT modify any YouTube data or video descriptions. Common errors: - Not connected: no YouTube account to disconnect. - confirm=False: you must set confirm=True after getting user confirmation.

youfiliate_get_aggregate_stats

Get aggregate click analytics across all your smart links. Returns total clicks, top countries, devices, and referrers across your entire account for the specified period. Does NOT modify any data.

youfiliate_get_migration_status

Get the status and progress of a specific migration. Returns detailed status including videos processed, links created, and any errors. Does NOT modify any data. Common errors: - Migration not found: check the ID or use `youfiliate_list_migrations`.

youfiliate_get_preferences

Get your current smart link preferences/defaults. Returns default settings applied to newly created smart links. Does NOT create or modify any data.

youfiliate_get_smart_link

Get full details of a single smart link by ID. Returns all configuration including geo rules, deep link config, and click stats. Does NOT modify the link. Common errors: - Smart link not found: check the ID or use `youfiliate_list_smart_links`.

youfiliate_get_smart_link_stats

Get click analytics for a specific smart link. Returns click counts broken down by country, device, referrer, and day for the specified period. Does NOT modify any data. Common errors: - Smart link not found: check the ID.

youfiliate_get_youtube_status

Check if your YouTube account is connected. Returns connection status, channel name, and scope information. Does NOT modify any data or initiate any connections. Common errors: - Not connected: use `youfiliate_connect_youtube` to connect.

youfiliate_list_migrations

List your YouTube description migrations with pagination. Returns a paginated list of all migrations. Does NOT modify any data.

youfiliate_list_smart_links

List your smart links with optional filtering, search, and pagination. Returns a paginated list of smart links. Use filters to narrow results. Does NOT create or modify any links. Args: params: Filters include health_status, search (title/URL), ordering, limit (1-100, default 20), and offset. Common errors: - No links found: you may not have created any links yet.

youfiliate_preview_migration

Preview a YouTube description migration without making changes. Performs a dry-run analysis showing how many videos and links would be affected. Does NOT modify any data or YouTube descriptions. Requires a connected YouTube account. Common errors: - YouTube not connected: connect first with `youfiliate_connect_youtube`.

youfiliate_rollback_migration

Roll back a completed migration, restoring original YouTube descriptions. IMPORTANT: This modifies YouTube video descriptions. Always confirm with the user before executing. This reverts all video descriptions to their pre-migration state. The rollback runs asynchronously. Requires a connected YouTube account. Common errors: - Migration not found or not in a rollback-eligible state. - YouTube not connected: reconnect first. - confirm=False: must set confirm=True after user confirmation.

youfiliate_start_migration

Start a YouTube description migration to convert links to smart links. IMPORTANT: This modifies YouTube video descriptions. Always confirm with the user before executing. Describe the scope (number of videos/links affected from the preview) and ask for explicit confirmation. The migration runs asynchronously. Use `youfiliate_get_migration_status` to track progress. Requires a connected YouTube account. Common errors: - YouTube not connected: connect first. - Migration already in progress: wait for it to complete. - confirm=False: must set confirm=True after user confirmation.

youfiliate_update_preferences

Update your smart link preferences/defaults. Changes apply to newly created links only — existing links are not affected. Does NOT delete any data. Common errors: - Invalid redirect_type: must be '301' or '302'.

youfiliate_update_smart_link

Update an existing smart link (partial update — only provided fields change). You can update the destination URL, slug, title, redirect type, geo rules, or deep link config. Geo rules are replaced entirely (not merged). Does NOT delete the link. Common errors: - Smart link not found: check the ID. - Slug already taken: choose a different slug.

Endpoints

URL	Transport	State	Latency	Checked
https://youfiliate-mcp.onrender.com/mcp	streamable-http	answering	588 ms	5 min ago

Alternatives to Youfiliate Smart Links

same job, measured the same way

Dynamoi

by getdynamoi

Create music promotion campaigns, Smart Links, analytics, and music distribution applications.

97 installs/wk 17 tools answering

Linkly

by mcparmory

Create short links, manage domains, and track click analytics

218 installs/wk local only

Flit

by flitlink

Short links, QR codes and click analytics on Flit. Tools: create/list/stats/delete links.

answering

Filoo MCP

by jrlprost

Create short links, fetch click analytics, and generate QR codes via the filoo.app API.

36 installs/wk local only

Sitectrl

by sitectrl

Your AI builds real hosted websites: describe it, get a live site with SSL, forms, analytics. Free.

13 tools answering

Lago

by usefulapi

Read Lago customers, subscriptions, invoices, usage and revenue analytics; write events.

24 tools answering

CodeQR

by codeqr

Create and manage CodeQR short links, QR codes, and analytics from any MCP client.

answering

Zebra

by zeblink

Create, schedule, and organize Zebra short links and query real-time click analytics.

answering

Youfiliate Smart Links — questions

Answers built from our own checks of this server.

What can Youfiliate Smart Links do?

It exposes 18 tools, read directly from the server on our last check. Among them: youfiliate_check_link_health, youfiliate_connect_youtube, youfiliate_create_smart_link, youfiliate_delete_smart_link, youfiliate_disconnect_youtube, youfiliate_get_aggregate_stats and 12 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is Youfiliate Smart Links working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 92 of 92 checks got a reply (100.0%), average response time 423 ms. The bar chart above shows every period we have measured.

How do I connect Youfiliate Smart Links?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Youfiliate Smart Links need an API key?

No. Youfiliate Smart Links completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 18 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Youfiliate Smart Links?

It answers our handshake in 423 ms on average, which is faster than 35% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

How many people use Youfiliate Smart Links?

The pypi package youfiliate-mcp was installed 47 times in the last week. Week over week that is -13%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Youfiliate Smart Links open source?

Yes — it is published under the MIT licence, written in Python and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.