Youfiliate Smart Links

andrewmpierce/youfiliate-mcp

Connects Claude to Youfiliate's geo-targeted affiliate link platform. Exposes 18 tools for CRUD on smart links, analytics queries (aggregate stats, per-link clicks, health checks), preference management, and YouTube OAuth integration. The migration tools are the standout: preview how many videos and links would be affected, then batch-convert YouTube descriptions to smart links with rollback capability. Also provides four resources for dashboard summaries and plan limits. Useful if you're managing affiliate links at scale and want to automate link creation, monitor performance, or migrate existing YouTube content to geo-aware redirects without leaving your chat session.

tools: 18
auth: Secret needed
transport: STDIO, HTTP
env vars: 2
last updated: Apr 27, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://youfiliate-mcp.onrender.com/mcp --name youfiliate-mcp --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http youfiliate-mcp https://youfiliate-mcp.onrender.com/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 18 tools

Verified live against the running server on Nov 6, 2026.

youfiliate_create_smart_linkCreate 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 create...1 params

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 create...

Parameters* required

params*value

youfiliate_list_smart_linksList 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...1 params

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...

Parameters* required

params*value

youfiliate_get_smart_linkGet 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`.1 params

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`.

Parameters* required

params*value

youfiliate_update_smart_linkUpdate 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...1 params

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...

Parameters* required

params*value

youfiliate_delete_smart_linkDelete 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...1 params

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...

Parameters* required

params*value

youfiliate_get_smart_link_statsGet 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.1 params

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.

Parameters* required

params*value

youfiliate_get_aggregate_statsGet 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.1 params

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.

Parameters* required

params*value

youfiliate_check_link_healthTrigger 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...1 params

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...

Parameters* required

params*value

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

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

Parameters* required

params*value

youfiliate_update_preferencesUpdate 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'.1 params

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'.

Parameters* required

params*value

youfiliate_get_youtube_statusCheck 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.1 params

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.

Parameters* required

params*value

youfiliate_connect_youtubeInitiate 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 aut...1 params

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 aut...

Parameters* required

params*value

youfiliate_disconnect_youtubeDisconnect 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 a...1 params

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 a...

Parameters* required

params*value

youfiliate_preview_migrationPreview 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: conn...1 params

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: conn...

Parameters* required

params*value

youfiliate_start_migrationStart 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. T...1 params

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. T...

Parameters* required

params*value

youfiliate_get_migration_statusGet 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`.1 params

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`.

Parameters* required

params*value

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

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

Parameters* required

params*value

youfiliate_rollback_migrationRoll 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. Req...1 params

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. Req...

Parameters* required

params*value

Configuration

YOUFILIATE_API_KEY*secret

Your Youfiliate API key (starts with youfiliate_sk_). Generate one at https://youfiliate.com/settings.

YOUFILIATE_API_BASE_URLdefault: https://app.youfiliate.com

Youfiliate backend URL.

Readme

Youfiliate MCP Server

MCP (Model Context Protocol) server for managing Youfiliate Smart Links from AI assistants like Claude Desktop. Create geo-targeted affiliate links, view analytics, and run YouTube description migrations — all from a chat conversation.

18 tools, 4 resources, supports stdio + streamable HTTP transports.

Installation

pip install youfiliate-mcp

Requires Python 3.11+ and a Youfiliate account.

Generate an API key

Log in at youfiliate.com
Go to Settings → API Keys
Click Create API Key (e.g. "Claude Desktop")
Copy the key (starts with youfiliate_sk_) — shown only once

Claude Desktop Configuration

View the full README on GitHub

Details

Repository: github.com/andrewmpierce/youfiliate-mcp
Website: youfiliate.com
Categories: Monitoring & Observability, Media & Entertainment
Package: youfiliate-mcp
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Resources: 3
Tools verified: Nov 6, 2026

Related Monitoring & Observability MCP servers

View all

Blocklens Mcp Serverblocklens/blocklens-mcp-serverBitcoin on-chain analytics — 109 metrics: MVRV, SOPR, NUPL, HODL Waves, CDD, cycles & more0stars

Sregymgate Mcpclauxel/sregym-incident-replay-gate-mcpA paid remote MCP for SREGym, built to return verdicts, receipts, usage logs, and audit-ready JSON.0stars

mttrlycom.mttrly/mcpAI-powered incident management and server monitoring via MCP.0stars

PingZen Uptime Monitoringdev.pingzen/mcpUptime monitoring with 127 tools across 23 protocols. Tag filtering + Code Mode.0stars

Ga4mharnett/mcp-ga4Google Analytics 4 MCP: reports, realtime data, custom dimensions, data streams.0stars

Traced Llm Proxymikerawsonnz/gosce-agentsProxy Gemini (Vertex AI) completions wrapped in OpenTelemetry trace spans; returns the answer plus t0stars