Youfiliate Smart Links MCP server
online · 100% uptimeio.github.andrewmpierce/youfiliate-mcp·v0.1.1Create geo-targeted affiliate smart links, pull analytics, and rewrite YouTube descriptions.
0 stars12 downloads/wk
Reviews
Write oneNobody has reviewed Youfiliate Smart Links yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Youfiliate Smart Links tools (18, 4 write)
write = sends, deletes, buys or postsyoufiliate_check_link_healthFreeTrigger 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_youtubeFreeInitiate 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_linkwrite actionFreeCreate 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_linkwrite actionFreeDelete 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_youtubeFreeDisconnect 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_statsFreeGet 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_statusFreeGet 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_preferencesFreeGet 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_linkFreeGet 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_statsFreeGet 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_statusFreeCheck 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_migrationsFreeList your YouTube description migrations with pagination. Returns a paginated list of all migrations. Does NOT modify any data.
youfiliate_list_smart_linksFreeList 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_migrationFreePreview 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_migrationFreeRoll 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_migrationFreeStart 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_preferenceswrite actionFreeUpdate 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_linkwrite actionFreeUpdate 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.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan24 source files scanned25/25
- Live reliabilityremote reachable in 819ms20/20
- Tool poisoning18 tool descriptions checked15/15
- Auth qualityAPI key sent as a header8/15
- Maintenancelast push 153 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Youfiliate Smart Links compares
Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 84/100
- higher than 71% of 1,337 Media servers
- Tools
- 18
- the typical Media server has 7
- Tools that change things
- 22%
- typical: 4%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote Media server answers 100%
- Response time
- 117 ms
- faster than 85% of 862 Media servers
- Downloads a week
- 12
- more than 3% of 365 Media servers with a package
What its tools let an agent do: 14 read · 4 change
Install Youfiliate Smart Links in Claude Code, Cursor or VS Code
claude mcp add --transport http youfiliate-mcp https://youfiliate-mcp.onrender.com/mcp
What the publisher says
From the Youfiliate Smart Links repository's README, as published. We do not edit it. Read it on GitHub
Youfiliate MCP Server
<!-- mcp-name: io.github.andrewmpierce/youfiliate-mcp -->
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-mcpRequires 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 youfiliatesk) — shown only once
Claude Desktop Configuration
Add to ~/Library/Application Support/Claude/claudedesktopconfig.json:
Local (stdio)
{
"mcpServers": {
"youfiliate": {
"command": "youfiliate-mcp",
"env": {
"YOUFILIATE_API_KEY": "youfiliate_sk_your_key_here"
}
}
}
}Remote (Streamable HTTP)
{
"mcpServers": {
"youfiliate": {
"url": "https://mcp.youfiliate.com",
"headers": {
"Authorization": "Bearer youfiliate_sk_your_key_here"
}
}
}
}Restart Claude Desktop after editing the config.
Available Tools (18)
Smart Links CRUD (5)
Analytics (3)
Preferences (2)
YouTube (3)
Migrations (5)
Available Resources (4)
Example Conversations
Creating a Smart Link
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Youfiliate Smart Links: common questions
- Is Youfiliate Smart Links MCP server safe?
- Mostly: it is graded B (84/100). Read the Youfiliate Smart Links safety report
- How do I install Youfiliate Smart Links?
- It runs remotely at youfiliate-mcp.onrender.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Youfiliate Smart Links need an API key?
- Yes. The registry entry asks for
YOUFILIATE_API_KEY,Authorization. - Is Youfiliate Smart Links maintained?
- The last commit was 191 days ago (2026-04-27). The latest release is v0.1.1.
- Is Youfiliate Smart Links up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of Youfiliate Smart Links?
- Servers from other publishers that do the same job: Dynamoi MCP server, Openshorts MCP server and Perfboard Designer MCP server.
- How does Youfiliate Smart Links compare with other Media MCP servers?
- safety score 84/100 (higher than 71% of 1,337 Media servers); tools 18 (the typical Media server has 7); tools that change things 22% (typical: 4%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Youfiliate Smart Links
Same job from other publishers: the closest match first, then the best rated.
- DynamoiMusic promotion and distribution for AI agents: Spotify and YouTube ads, Smart Links, releases.not reviewedGrowingB
OpenshortsTurn long videos into viral vertical shorts and publish them to TikTok, Instagram and YouTube.not reviewedEstablishedA
Perfboard DesignerDesign perfboard and stripboard layouts, check the wiring and get a link to open them in the editor.not reviewedEstablishedA- Youtube TranscriptThis is an MCP server that allows you to directly download transcripts of YouTube videos.not reviewedEstablishedB
- YouTube DataYouTube MCP server for token-optimized, structured data using the YouTube Data API v3.not reviewedGrowingB