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

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

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.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)

Tool	Description
youfiliate_create_smart_link	Create a new geo-targeted smart link
youfiliate_list_smart_links	List smart links with filtering and pagination
youfiliate_get_smart_link	Get full details of a smart link by ID
youfiliate_update_smart_link	Update a smart link (partial update)
youfiliate_delete_smart_link	Delete a smart link (requires confirm=True)

Analytics (3)

Tool	Description
youfiliate_get_smart_link_stats	Get click analytics for a specific link
youfiliate_get_aggregate_stats	Get analytics across all links
youfiliate_check_link_health	Trigger a health check on a link

Preferences (2)

Tool	Description
youfiliate_get_preferences	Get default smart link preferences
youfiliate_update_preferences	Update preferences for new links

YouTube (3)

Tool	Description
youfiliate_get_youtube_status	Check YouTube connection status
youfiliate_connect_youtube	Start YouTube OAuth flow (returns auth URL)
youfiliate_disconnect_youtube	Disconnect YouTube (requires confirm=True)

Migrations (5)

Tool	Description
youfiliate_preview_migration	Preview migration scope (dry run)
youfiliate_start_migration	Start YouTube description migration (requires confirm=True)
youfiliate_get_migration_status	Check migration progress
youfiliate_list_migrations	List all migrations
youfiliate_rollback_migration	Rollback a migration (requires confirm=True)

Available Resources (4)

URI	Description
youfiliate://summary	Dashboard summary (link counts, clicks, health)
youfiliate://preferences	Current preferences (read-only)
youfiliate://smart-link/{id}	Single smart link details
youfiliate://plan-limits	Current plan usage and limits

Example Conversations

Creating a Smart Link

You: Create a smart link for https://amazon.com/dp/B09V3KXJPB with geo-targeting for UK and Germany.

Claude: (calls youfiliate_create_smart_link with geo rules for GB and DE)

... View full README on GitHub