Skip to content
Agentmart
Submit a tool

Youfiliate Smart Links

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

Connector by andrewmpierce · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)Remote (HTTP)
Write a review

Install

Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/andrewmpierce-youfiliate-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Remote endpoint

  • https://youfiliate-mcp.onrender.com/mcp Remote (HTTP)

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
10 read · 4 write · 4 delete
Secrets
2 (API keys, tokens or passwords)
Install scripts
Not scanned yet
Runs as
Python package

Tools by what they do 18

Read from the source code; the running server may list different tools.

Read 10 · Look things up without changing anything.

  • youfiliate_check_link_health
  • youfiliate_get_aggregate_stats
  • youfiliate_get_migration_status
  • youfiliate_get_preferences
  • youfiliate_get_smart_link
  • youfiliate_get_smart_link_stats
  • youfiliate_get_youtube_status
  • youfiliate_list_migrations
  • youfiliate_list_smart_links
  • youfiliate_preview_migration

Write 4 · Create, change, send or run things.

  • youfiliate_connect_youtube
  • youfiliate_create_smart_link
  • youfiliate_update_preferences
  • youfiliate_update_smart_link

Delete 4 · Delete, drop, revoke or wipe things.

  • youfiliate_delete_smart_link
  • youfiliate_disconnect_youtube
  • youfiliate_rollback_migration
  • youfiliate_start_migration

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • Authorization
  • YOUFILIATE_API_KEY

Other settings (environment variables or headers).

  • YOUFILIATE_API_BASE_URL

Network hosts it talks to 1

  • youfiliate-mcp.onrender.com · found in remote endpoint, install command

Tools (18)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • youfiliate_check_link_healthCheck Link Healthread-only

    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.

  • youfiliate_connect_youtubeConnect YouTube Account

    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`.

  • youfiliate_create_smart_linkCreate 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.

  • youfiliate_delete_smart_linkDelete Smart Linkcan change or delete data

    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.

  • youfiliate_disconnect_youtubeDisconnect YouTube Accountcan change or delete data

    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.

  • youfiliate_get_aggregate_statsGet Aggregate Statsread-only

    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_get_migration_statusGet Migration Statusread-only

    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_get_preferencesGet Preferencesread-only

    Get 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_linkGet Smart Link Detailsread-only

    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_get_smart_link_statsGet Smart Link Statsread-only

    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_youtube_statusGet YouTube Connection Statusread-only

    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_list_migrationsList Migrationsread-only

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

  • youfiliate_list_smart_linksList Smart Linksread-only

    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.

  • youfiliate_preview_migrationPreview Migrationread-only

    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`.

  • youfiliate_rollback_migrationRollback Migrationcan change or delete data

    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.

Show 3 more tools
  • youfiliate_start_migrationStart YouTube Migrationcan change or delete data

    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.

  • youfiliate_update_preferencesUpdate 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_update_smart_linkUpdate 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.

Signals

Stars
0
Forks
0
Open issues
0
Weekly downloads
15
Last commit
Apr 27, 2026 (6 months ago)
Last release
Apr 27, 2026 (6 months ago)
Last package publish
Apr 27, 2026 (6 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.andrewmpierce/youfiliate-mcp
Version
0.1.1
Auth
Bearer token, API key
Packages
pypi youfiliate-mcp
License
MIT
Repository
github.com/andrewmpierce/youfiliate-mcp
Website
youfiliate.com
First seen
Oct 24, 2026
Last checked
Oct 25, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

Youfiliate Smart Links MCP server. Agent Mart. https://agentmart.dev/connectors/andrewmpierce-youfiliate-mcp (last updated 2026-10-25)