MCP Server
Youfiliate Smart Links
io.github.andrewmpierce/youfiliate-mcp
What this MCP does
Creates geo-targeted affiliate smart links, manages redirects and deep links, provides click analytics, and migrates YouTube descriptions.
Capabilities
Tools
18
tools
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: wait 5 minutes between health checks for the same link.
- Smart link not found: check the ID.
Read only
Idempotent
Input schema
{'type': 'object', '$defs': {'ResponseFormat': {'enum': ['markdown', 'json'], 'type': 'string', 'title': 'ResponseFormat', 'description': 'Output format for tool responses.'}, 'CheckLinkHealthInput': {'type': 'object', 'title': 'CheckLinkHealthInput', 'required': ['id'], 'properties': {'id': {'type': 'string', 'title': 'Id', 'pattern': '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$', 'description': 'Smart link UUID to check'}, 'response_format': {'$ref': '#/$defs/ResponseFormat', 'default': 'markdown', 'description': "Output format: 'markdown' or 'json'"}}, 'description': 'Input for triggering a health check on a smart link.', 'additionalProperties': False}}, 'title': 'youfiliate_check_link_healthArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/CheckLinkHealthInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_check_link_healthOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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 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`.
Open world
Input schema
{'type': 'object', '$defs': {'ResponseFormat': {'enum': ['markdown', 'json'], 'type': 'string', 'title': 'ResponseFormat', 'description': 'Output format for tool responses.'}, 'ConnectYouTubeInput': {'type': 'object', 'title': 'ConnectYouTubeInput', 'properties': {'response_format': {'$ref': '#/$defs/ResponseFormat', 'default': 'markdown', 'description': "Output format: 'markdown' or 'json'"}}, 'description': 'Input for initiating YouTube OAuth connection.', 'additionalProperties': False}}, 'title': 'youfiliate_connect_youtubeArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/ConnectYouTubeInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_connect_youtubeOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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 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.
Input schema
{'type': 'object', '$defs': {'GeoRuleInput': {'type': 'object', 'title': 'GeoRuleInput', 'required': ['country_code', 'destination_url'], 'properties': {'country_code': {'type': 'string', 'title': 'Country Code', 'pattern': '^[A-Z]{2}$', 'description': "ISO 3166-1 alpha-2 country code (e.g., 'GB', 'DE', 'JP')"}, 'destination_url': {'type': 'string', 'title': 'Destination Url', 'pattern': '^https?://.+', 'description': 'URL to redirect visitors from this country to'}}, 'description': 'Country-specific destination URL.', 'additionalProperties': False}, 'ResponseFormat': {'enum': ['markdown', 'json'], 'type': 'string', 'title': 'ResponseFormat', 'description': 'Output format for tool responses.'}, 'DeepLinkConfigInput': {'type': 'object', 'title': 'DeepLinkConfigInput', 'properties': {'ios_app_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Ios App Url', 'default': None, 'description': "iOS app deep link URL (e.g., 'amazon://...')"}, 'android_app_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Android App Url', 'default': None, 'description': 'Android app deep link URL'}, 'ios_fallback_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Ios Fallback Url', 'default': None, 'description': 'Fallback URL if iOS app is not installed'}, 'android_fallback_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Android Fallback Url', 'default': None, 'description': 'Fallback URL if Android app is not installed'}}, 'description': 'iOS/Android app-opening configuration.', 'additionalProperties': False}, 'CreateSmartLinkInput': {'type': 'object', 'title': 'CreateSmartLinkInput', 'required': ['default_url'], 'properties': {'slug': {'anyOf': [{'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 50}, {'type': 'null'}], 'title': 'Slug', 'default': None, 'description': 'Custom short URL slug (auto-generated if omitted). Lowercase alphanumeric + hyphens only.'}, 'title': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}], 'title': 'Title', 'default': None, 'description': 'Human-readable label for this link'}, 'geo_rules': {'anyOf': [{'type': 'array', 'items': {'$ref': '#/$defs/GeoRuleInput'}}, {'type': 'null'}], 'title': 'Geo Rules', 'default': None, 'description': 'Country-specific destination URLs for geo-targeting'}, 'default_url': {'type': 'string', 'title': 'Default Url', 'pattern': '^https?://.+', 'description': 'The destination URL for this smart link'}, 'redirect_type': {'enum': ['301', '302'], 'type': 'string', 'title': 'Redirect Type', 'default': '302', 'description': 'HTTP redirect type. Use 302 (default) for links that may change, 301 for permanent.'}, 'response_format': {'$ref': '#/$defs/ResponseFormat', 'default': 'markdown', 'description': "Output format: 'markdown' or 'json'"}, 'deep_link_config': {'anyOf': [{'$ref': '#/$defs/DeepLinkConfigInput'}, {'type': 'null'}], 'default': None, 'description': 'iOS/Android app-opening configuration'}}, 'description': 'Input for creating a new smart link.', 'additionalProperties': False}}, 'title': 'youfiliate_create_smart_linkArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/CreateSmartLinkInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_create_smart_linkOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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 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.
Destructive
Idempotent
Input schema
{'type': 'object', '$defs': {'DeleteSmartLinkInput': {'type': 'object', 'title': 'DeleteSmartLinkInput', 'required': ['id'], 'properties': {'id': {'type': 'string', 'title': 'Id', 'pattern': '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$', 'description': 'Smart link UUID to delete'}, 'confirm': {'type': 'boolean', 'title': 'Confirm', 'default': False, 'description': 'Must be set to true to confirm deletion. IMPORTANT: Always confirm with the user before setting this to true.'}}, 'description': 'Input for deleting a smart link.', 'additionalProperties': False}}, 'title': 'youfiliate_delete_smart_linkArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/DeleteSmartLinkInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_delete_smart_linkOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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 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.
Destructive
Idempotent
Input schema
{'type': 'object', '$defs': {'DisconnectYouTubeInput': {'type': 'object', 'title': 'DisconnectYouTubeInput', 'properties': {'confirm': {'type': 'boolean', 'title': 'Confirm', 'default': False, 'description': 'Must be set to true to confirm disconnection. IMPORTANT: Always confirm with the user before setting this to true.'}}, 'description': 'Input for disconnecting YouTube account.', 'additionalProperties': False}}, 'title': 'youfiliate_disconnect_youtubeArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/DisconnectYouTubeInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_disconnect_youtubeOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Read only
Idempotent
Input schema
{'type': 'object', '$defs': {'ResponseFormat': {'enum': ['markdown', 'json'], 'type': 'string', 'title': 'ResponseFormat', 'description': 'Output format for tool responses.'}, 'GetAggregateStatsInput': {'type': 'object', 'title': 'GetAggregateStatsInput', 'properties': {'period': {'enum': ['7d', '30d', '90d', 'all'], 'type': 'string', 'title': 'Period', 'default': '30d', 'description': "Time period for stats: '7d', '30d', '90d', or 'all'"}, 'response_format': {'$ref': '#/$defs/ResponseFormat', 'default': 'markdown', 'description': "Output format: 'markdown' or 'json'"}}, 'description': 'Input for getting aggregate analytics across all smart links.', 'additionalProperties': False}}, 'title': 'youfiliate_get_aggregate_statsArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/GetAggregateStatsInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_get_aggregate_statsOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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`.
Read only
Idempotent
Input schema
{'type': 'object', '$defs': {'ResponseFormat': {'enum': ['markdown', 'json'], 'type': 'string', 'title': 'ResponseFormat', 'description': 'Output format for tool responses.'}, 'GetMigrationStatusInput': {'type': 'object', 'title': 'GetMigrationStatusInput', 'required': ['id'], 'properties': {'id': {'type': 'string', 'title': 'Id', 'pattern': '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$', 'description': 'Migration UUID'}, 'response_format': {'$ref': '#/$defs/ResponseFormat', 'default': 'markdown', 'description': "Output format: 'markdown' or 'json'"}}, 'description': "Input for getting a specific migration's status.", 'additionalProperties': False}}, 'title': 'youfiliate_get_migration_statusArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/GetMigrationStatusInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_get_migration_statusOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Read only
Idempotent
Input schema
{'type': 'object', '$defs': {'ResponseFormat': {'enum': ['markdown', 'json'], 'type': 'string', 'title': 'ResponseFormat', 'description': 'Output format for tool responses.'}, 'GetPreferencesInput': {'type': 'object', 'title': 'GetPreferencesInput', 'properties': {'response_format': {'$ref': '#/$defs/ResponseFormat', 'default': 'markdown', 'description': "Output format: 'markdown' or 'json'"}}, 'description': 'Input for getting user preferences.', 'additionalProperties': False}}, 'title': 'youfiliate_get_preferencesArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/GetPreferencesInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_get_preferencesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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`.
Read only
Idempotent
Input schema
{'type': 'object', '$defs': {'ResponseFormat': {'enum': ['markdown', 'json'], 'type': 'string', 'title': 'ResponseFormat', 'description': 'Output format for tool responses.'}, 'GetSmartLinkInput': {'type': 'object', 'title': 'GetSmartLinkInput', 'required': ['id'], 'properties': {'id': {'type': 'string', 'title': 'Id', 'pattern': '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$', 'description': 'Smart link UUID'}, 'response_format': {'$ref': '#/$defs/ResponseFormat', 'default': 'markdown', 'description': "Output format: 'markdown' or 'json'"}}, 'description': 'Input for getting a single smart link.', 'additionalProperties': False}}, 'title': 'youfiliate_get_smart_linkArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/GetSmartLinkInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_get_smart_linkOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Read only
Idempotent
Input schema
{'type': 'object', '$defs': {'ResponseFormat': {'enum': ['markdown', 'json'], 'type': 'string', 'title': 'ResponseFormat', 'description': 'Output format for tool responses.'}, 'GetSmartLinkStatsInput': {'type': 'object', 'title': 'GetSmartLinkStatsInput', 'required': ['id'], 'properties': {'id': {'type': 'string', 'title': 'Id', 'pattern': '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$', 'description': 'Smart link UUID'}, 'period': {'enum': ['7d', '30d', '90d', 'all'], 'type': 'string', 'title': 'Period', 'default': '30d', 'description': "Time period for stats: '7d', '30d', '90d', or 'all'"}, 'response_format': {'$ref': '#/$defs/ResponseFormat', 'default': 'markdown', 'description': "Output format: 'markdown' or 'json'"}}, 'description': 'Input for getting click analytics for a single smart link.', 'additionalProperties': False}}, 'title': 'youfiliate_get_smart_link_statsArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/GetSmartLinkStatsInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_get_smart_link_statsOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Read only
Idempotent
Input schema
{'type': 'object', '$defs': {'ResponseFormat': {'enum': ['markdown', 'json'], 'type': 'string', 'title': 'ResponseFormat', 'description': 'Output format for tool responses.'}, 'GetYouTubeStatusInput': {'type': 'object', 'title': 'GetYouTubeStatusInput', 'properties': {'response_format': {'$ref': '#/$defs/ResponseFormat', 'default': 'markdown', 'description': "Output format: 'markdown' or 'json'"}}, 'description': 'Input for checking YouTube connection status.', 'additionalProperties': False}}, 'title': 'youfiliate_get_youtube_statusArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/GetYouTubeStatusInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_get_youtube_statusOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
youfiliate_list_migrations
List your YouTube description migrations with pagination.
Returns a paginated list of all migrations. Does NOT modify any data.
Read only
Idempotent
Input schema
{'type': 'object', '$defs': {'ResponseFormat': {'enum': ['markdown', 'json'], 'type': 'string', 'title': 'ResponseFormat', 'description': 'Output format for tool responses.'}, 'ListMigrationsInput': {'type': 'object', 'title': 'ListMigrationsInput', 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Maximum results to return (1-100, default 20)'}, 'offset': {'type': 'integer', 'title': 'Offset', 'default': 0, 'minimum': 0, 'description': 'Number of results to skip for pagination (default 0)'}, 'response_format': {'$ref': '#/$defs/ResponseFormat', 'default': 'markdown', 'description': "Output format: 'markdown' (default) or 'json'"}}, 'description': 'Input for listing migrations.', 'additionalProperties': False}}, 'title': 'youfiliate_list_migrationsArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/ListMigrationsInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_list_migrationsOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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), and offset.
Common errors:
- No links found: you may not have created any links yet.
Read only
Idempotent
Input schema
{'type': 'object', '$defs': {'ResponseFormat': {'enum': ['markdown', 'json'], 'type': 'string', 'title': 'ResponseFormat', 'description': 'Output format for tool responses.'}, 'ListSmartLinksInput': {'type': 'object', 'title': 'ListSmartLinksInput', 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Maximum results to return (1-100, default 20)'}, 'offset': {'type': 'integer', 'title': 'Offset', 'default': 0, 'minimum': 0, 'description': 'Number of results to skip for pagination (default 0)'}, 'search': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Search', 'default': None, 'description': 'Search by title or URL'}, 'ordering': {'anyOf': [{'enum': ['created_at', '-created_at', 'total_clicks', '-total_clicks', 'daily_clicks', '-daily_clicks', 'weekly_clicks', '-weekly_clicks', 'title', '-title'], 'type': 'string'}, {'type': 'null'}], 'title': 'Ordering', 'default': None, 'description': "Sort field (e.g., '-created_at', 'total_clicks', '-total_clicks')"}, 'health_status': {'anyOf': [{'enum': ['healthy', 'broken', 'unknown'], 'type': 'string'}, {'type': 'null'}], 'title': 'Health Status', 'default': None, 'description': 'Filter by health status'}, 'response_format': {'$ref': '#/$defs/ResponseFormat', 'default': 'markdown', 'description': "Output format: 'markdown' (default) or 'json'"}}, 'description': 'Input for listing smart links with optional filters.', 'additionalProperties': False}}, 'title': 'youfiliate_list_smart_linksArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/ListSmartLinksInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_list_smart_linksOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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: connect first with `youfiliate_connect_youtube`.
Read only
Idempotent
Input schema
{'type': 'object', '$defs': {'ResponseFormat': {'enum': ['markdown', 'json'], 'type': 'string', 'title': 'ResponseFormat', 'description': 'Output format for tool responses.'}, 'PreviewMigrationInput': {'type': 'object', 'title': 'PreviewMigrationInput', 'properties': {'auto_geo_rules': {'type': 'boolean', 'title': 'Auto Geo Rules', 'default': True, 'description': 'Whether to auto-generate geo rules (e.g., Amazon international storefronts)'}, 'conversion_mode': {'enum': ['all', 'affiliate_only'], 'type': 'string', 'title': 'Conversion Mode', 'default': 'affiliate_only', 'description': "Which links to convert: 'all' converts every link, 'affiliate_only' only converts detected affiliate links"}, 'response_format': {'$ref': '#/$defs/ResponseFormat', 'default': 'markdown', 'description': "Output format: 'markdown' or 'json'"}}, 'description': 'Input for previewing a YouTube description migration.', 'additionalProperties': False}}, 'title': 'youfiliate_preview_migrationArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/PreviewMigrationInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_preview_migrationOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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. 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.
Destructive
Open world
Input schema
{'type': 'object', '$defs': {'RollbackMigrationInput': {'type': 'object', 'title': 'RollbackMigrationInput', 'required': ['id'], 'properties': {'id': {'type': 'string', 'title': 'Id', 'pattern': '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$', 'description': 'Migration UUID to roll back'}, 'confirm': {'type': 'boolean', 'title': 'Confirm', 'default': False, 'description': 'Must be set to true to confirm rollback. IMPORTANT: This reverts YouTube video descriptions to their pre-migration state. Always confirm with the user before setting this to true.'}}, 'description': 'Input for rolling back a migration.', 'additionalProperties': False}}, 'title': 'youfiliate_rollback_migrationArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/RollbackMigrationInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_rollback_migrationOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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 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.
Destructive
Open world
Input schema
{'type': 'object', '$defs': {'ResponseFormat': {'enum': ['markdown', 'json'], 'type': 'string', 'title': 'ResponseFormat', 'description': 'Output format for tool responses.'}, 'StartMigrationInput': {'type': 'object', 'title': 'StartMigrationInput', 'properties': {'confirm': {'type': 'boolean', 'title': 'Confirm', 'default': False, 'description': 'Must be set to true to confirm migration. IMPORTANT: This modifies YouTube video descriptions. Always describe the scope (number of videos/links) and ask for explicit user confirmation before setting this to true.'}, 'auto_geo_rules': {'type': 'boolean', 'title': 'Auto Geo Rules', 'default': True, 'description': 'Whether to auto-generate geo rules'}, 'conversion_mode': {'enum': ['all', 'affiliate_only'], 'type': 'string', 'title': 'Conversion Mode', 'default': 'affiliate_only', 'description': 'Which links to convert'}, 'response_format': {'$ref': '#/$defs/ResponseFormat', 'default': 'markdown', 'description': "Output format: 'markdown' or 'json'"}}, 'description': 'Input for starting a YouTube description migration.', 'additionalProperties': False}}, 'title': 'youfiliate_start_migrationArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/StartMigrationInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_start_migrationOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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'.
Idempotent
Input schema
{'type': 'object', '$defs': {'ResponseFormat': {'enum': ['markdown', 'json'], 'type': 'string', 'title': 'ResponseFormat', 'description': 'Output format for tool responses.'}, 'UpdatePreferencesInput': {'type': 'object', 'title': 'UpdatePreferencesInput', 'properties': {'response_format': {'$ref': '#/$defs/ResponseFormat', 'default': 'markdown', 'description': "Output format: 'markdown' or 'json'"}, 'default_redirect_type': {'anyOf': [{'enum': ['301', '302'], 'type': 'string'}, {'type': 'null'}], 'title': 'Default Redirect Type', 'default': None, 'description': 'Default redirect type for new smart links'}, 'default_geo_rules_enabled': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'title': 'Default Geo Rules Enabled', 'default': None, 'description': 'Whether geo-targeting is enabled by default for new links'}, 'default_deep_linking_enabled': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'title': 'Default Deep Linking Enabled', 'default': None, 'description': 'Whether deep linking is enabled by default for new links'}}, 'description': 'Input for updating user preferences.', 'additionalProperties': False}}, 'title': 'youfiliate_update_preferencesArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/UpdatePreferencesInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_update_preferencesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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 found: check the ID.
- Slug already taken: choose a different slug.
Idempotent
Input schema
{'type': 'object', '$defs': {'GeoRuleInput': {'type': 'object', 'title': 'GeoRuleInput', 'required': ['country_code', 'destination_url'], 'properties': {'country_code': {'type': 'string', 'title': 'Country Code', 'pattern': '^[A-Z]{2}$', 'description': "ISO 3166-1 alpha-2 country code (e.g., 'GB', 'DE', 'JP')"}, 'destination_url': {'type': 'string', 'title': 'Destination Url', 'pattern': '^https?://.+', 'description': 'URL to redirect visitors from this country to'}}, 'description': 'Country-specific destination URL.', 'additionalProperties': False}, 'ResponseFormat': {'enum': ['markdown', 'json'], 'type': 'string', 'title': 'ResponseFormat', 'description': 'Output format for tool responses.'}, 'DeepLinkConfigInput': {'type': 'object', 'title': 'DeepLinkConfigInput', 'properties': {'ios_app_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Ios App Url', 'default': None, 'description': "iOS app deep link URL (e.g., 'amazon://...')"}, 'android_app_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Android App Url', 'default': None, 'description': 'Android app deep link URL'}, 'ios_fallback_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Ios Fallback Url', 'default': None, 'description': 'Fallback URL if iOS app is not installed'}, 'android_fallback_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Android Fallback Url', 'default': None, 'description': 'Fallback URL if Android app is not installed'}}, 'description': 'iOS/Android app-opening configuration.', 'additionalProperties': False}, 'UpdateSmartLinkInput': {'type': 'object', 'title': 'UpdateSmartLinkInput', 'required': ['id'], 'properties': {'id': {'type': 'string', 'title': 'Id', 'pattern': '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$', 'description': 'Smart link UUID to update'}, 'slug': {'anyOf': [{'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 50}, {'type': 'null'}], 'title': 'Slug', 'default': None, 'description': 'New custom slug'}, 'title': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}], 'title': 'Title', 'default': None, 'description': 'New title/label'}, 'geo_rules': {'anyOf': [{'type': 'array', 'items': {'$ref': '#/$defs/GeoRuleInput'}}, {'type': 'null'}], 'title': 'Geo Rules', 'default': None, 'description': 'Replace geo rules (full replacement, not merge)'}, 'default_url': {'anyOf': [{'type': 'string', 'pattern': '^https?://.+'}, {'type': 'null'}], 'title': 'Default Url', 'default': None, 'description': 'New destination URL'}, 'redirect_type': {'anyOf': [{'enum': ['301', '302'], 'type': 'string'}, {'type': 'null'}], 'title': 'Redirect Type', 'default': None, 'description': 'New redirect type'}, 'response_format': {'$ref': '#/$defs/ResponseFormat', 'default': 'markdown', 'description': "Output format: 'markdown' or 'json'"}, 'deep_link_config': {'anyOf': [{'$ref': '#/$defs/DeepLinkConfigInput'}, {'type': 'null'}], 'default': None, 'description': 'Replace deep link config'}}, 'description': 'Input for updating a smart link (partial update).', 'additionalProperties': False}}, 'title': 'youfiliate_update_smart_linkArguments', 'required': ['params'], 'properties': {'params': {'$ref': '#/$defs/UpdateSmartLinkInput'}}}
Output schema
{'type': 'object', 'title': 'youfiliate_update_smart_linkOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
History
Recent tool changes
Added
youfiliate_rollback_migration
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_list_migrations
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_get_migration_status
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_start_migration
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_preview_migration
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_disconnect_youtube
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_connect_youtube
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_get_youtube_status
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_update_preferences
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_get_preferences
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_check_link_health
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_get_aggregate_stats
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_get_smart_link_stats
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_delete_smart_link
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_update_smart_link
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_get_smart_link
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_list_smart_links
Sept. 17, 2026, 12:40 p.m.
Added
youfiliate_create_smart_link
Sept. 17, 2026, 12:40 p.m.
Discover
Similar MCP servers
captapi
io.github.CDCStream/captapi
Retrieves social media profiles, posts, engagement metrics, comments, marketplace listings, events, and Meta advertising data acr…
Social Signal
io.github.pipeworx-io/social-signal
Provides time-series analysis of post volumes across open social networks for monitoring social activity and signals.
Viral Outliers
com.viraloutliers/viral-outliers
Finds viral outlier posts across TikTok, Instagram, and YouTube, tracks creator profiles, analyzes media, monitors watchlists, an…
Reel25 — Video Analytics for TikTok, Instagram & YouTube
io.github.usnmax88/reel25-mcp
Tracks and analyzes TikTok, Instagram, and YouTube creator accounts and videos, including performance metrics, trends, discovery,…
telemost-mcp-server
io.telemost/telemost-mcp-server
Searches public Telegram content and channels, extracts entities, tracks posts and mentions, analyzes sentiment, and reports chan…
affogata
com.affogata.app/affogata
Analyzes social conversations using topic queries, filters, trending keywords, and conversation clusters.
Soclo
app.soclo/soclo-mcp
Connects AI to content, social media, advertising, and revenue data across app stores and the web.
SharksAPI.AI
ai.sharksapi/marketing
Provides marketing analytics and actions across GA4, Search Console, Google Ads, social channels, SEO, WordPress, and marketing p…