Youfiliate

What is Youfiliate?

Youfiliate is an MCP server for managing Youfiliate Smart Links from AI assistants like Claude Desktop. It creates geo-targeted affiliate links, views analytics, and runs YouTube description migrations—all from a chat conversation.

How to use Youfiliate?

Install via pip install youfiliate-mcp (requires Python 3.11+ and a Youfiliate account). Generate an API key at youfiliate.com (Settings → API Keys), then configure Claude Desktop with the key as the YOUFILIATE_API_KEY environment variable using either stdio or remote streamable HTTP transport. After editing claude_desktop_config.json, restart Claude Desktop to use the 18 tools and 4 resources.

Key features of Youfiliate

• Full CRUD for geo-targeted Smart Links
• Click analytics per link and aggregated across all links
• YouTube account connection and description migration
• Dry-run preview before starting migrations
• Dashboard summary resource (youfiliate://summary)
• Supports stdio and streamable HTTP transports
• Destructive operations require explicit confirmation

Use cases of Youfiliate

• Create localized affiliate links for different countries from a chat
• Monitor click performance across all your Smart Links
• Automatically convert Amazon links in YouTube descriptions to geo-targeted Smart Links
• Roll back a YouTube description migration if needed
• Check current plan usage and limits via a resource

FAQ from Youfiliate

What dependencies and runtime does Youfiliate require?

Python 3.11+ and a Youfiliate account with an API key. The server can run locally (stdio) or remotely (streamable HTTP).

How is authentication handled?

Youfiliate uses API key authentication. The server exchanges your youfiliate_sk_... key for short-lived JWTs cached in memory and auto-refreshed. Destructive actions (delete, disconnect, start/rollback migration) require an explicit confirm=True parameter.

What are the rate limits?

MCP layer: 60 requests per minute per API key. Health checks are limited to 1 per link per 5 minutes. API key exchange is rate-limited by the Youfiliate backend.

Where does data live and is it scoped?

The server only accesses data belonging to the API key’s owner. Data is fetched from the Youfiliate API (default URL https://app.youfiliate.com) and processed in memory; JWTs are cached in memory.

What transports are supported?

Both stdio (local) and streamable HTTP (remote) transports are supported. Configure via the TRANSPORT environment variable (stdio or streamable-http).