NestDaddy

Youfiliate Smart Links

io.github.andrewmpierce/youfiliate-mcp · v0.1.1

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

Connect Remote server

Terminal
claude mcp add --transport http youfiliate-mcp https://youfiliate-mcp.onrender.com/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
~/.cursor/mcp.json
{
  "mcpServers": {
    "youfiliate-mcp": {
      "url": "https://youfiliate-mcp.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "youfiliate-mcp": {
      "type": "http",
      "url": "https://youfiliate-mcp.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
Claude Desktop
Settings > Connectors > Add custom connector
URL: https://youfiliate-mcp.onrender.com/mcp

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools 18 found in our last check

  • 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…

  • 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…

  • 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_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 f…

  • 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…

  • 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_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_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:…

  • 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_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_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_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 autho…

  • 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…

  • 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: connec…

  • 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…

  • 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_list_migrations

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

  • 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. Requi…

Headers

NameDescription
Authorization
Required, secret
Bearer token using your Youfiliate API key. Format: 'Bearer youfiliate_sk_your_key_here'.

Details

Endpointhttps://youfiliate-mcp.onrender.com/mcp (Streamable HTTP)
Package[email protected] (PYPI, stdio)
First published27 Apr 2026
Last updated27 Apr 2026
Registry nameio.github.andrewmpierce/youfiliate-mcp

More data and analytics servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.