protogrid

Search / io.github.andrewmpierce/youfiliate-mcp

Youfiliate Smart Links

R1· needs a key

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

v0.1.1 · active · repository · website · descriptor JSON · versions

An agent can connect on its own if it already holds YOUFILIATE_MCP_TOKEN.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality93strong
Trust90of 100
Uptime, 30 days100%
Latency p50348 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "youfiliate-mcp": {
      "type": "http",
      "url": "https://youfiliate-mcp.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer ${YOUFILIATE_MCP_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http youfiliate-mcp https://youfiliate-mcp.onrender.com/mcp --header "Authorization: Bearer ${YOUFILIATE_MCP_TOKEN}"
[mcp_servers.youfiliate-mcp]
url = "https://youfiliate-mcp.onrender.com/mcp"
bearer_token_env_var = "YOUFILIATE_MCP_TOKEN"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "youfiliate-mcp": {
      "type": "remote",
      "url": "https://youfiliate-mcp.onrender.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:YOUFILIATE_MCP_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "youfiliate-mcp": {
      "type": "http",
      "url": "https://youfiliate-mcp.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer ${YOUFILIATE_MCP_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=youfiliate-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8veW91ZmlsaWF0ZS1tY3Aub25yZW5kZXIuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke1lPVUZJTElBVEVfTUNQX1RPS0VOfSJ9fQ%3D%3D"
}
{
  "servers": {
    "youfiliate-mcp": {
      "type": "http",
      "url": "https://youfiliate-mcp.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer ${YOUFILIATE_MCP_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "youfiliate-mcp": {
      "httpUrl": "https://youfiliate-mcp.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer ${YOUFILIATE_MCP_TOKEN}"
      }
    }
  }
}
extensions:
  "youfiliate-mcp":
    enabled: true
    name: "youfiliate-mcp"
    type: streamable_http
    uri: "https://youfiliate-mcp.onrender.com/mcp"
    headers:
      "Authorization": "Bearer ${YOUFILIATE_MCP_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${YOUFILIATE_MCP_TOKEN}. The registry never accepts secret values.

Quality 93 / 100strong

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene100 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations18 of 18 tools declare readOnlyHint or destructiveHint
  • pass
    tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
  • pass
    tools.token_costabout 7,347 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependencies100 · weight 15
  • pass
    deps.known_vulnsno known advisory in 41 resolved packages
  • pass
    deps.mcp_sdk_versionmcp 2.2.0, no known advisory
  • pass
    deps.resolvable[email protected] resolved: 41 packages

18 tools, about 7,347 tokens to load them all · tool set dc1b6cb11d07 · checked 2026-10-20 17:34 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 90 / 100

provenance90
liveness100
freshness65
hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-100% ~updated-176d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] PyPI40 dependencies, resolved · MCP SDK mcp 2.2.0 · advisories checked 2026-10-19

No known advisory affects this dependency graph.

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://youfiliate-mcp.onrender.com/mcp streamable-httpapi_key ${YOUFILIATE_MCP_TOKEN}yes100%348 ms2025-11-252026-10-20
packageregistryversionruntimesecrets
youfiliate-mcppypi0.1.1–YOUFILIATE_API_KEY

Tools (18)

youfiliate_check_link_healthread-onlyTrigger 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_youtubeInitiate 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 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_linkdestructiveDelete 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_youtubedestructiveDisconnect 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_statsread-onlyGet 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_statusread-onlyGet 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_preferencesread-onlyGet 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_linkread-onlyGet 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_statsread-onlyGet 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_statusread-onlyCheck 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_migrationsread-onlyList your YouTube description migrations with pagination. Returns a paginated list of all migrations. Does NOT modify any data.
youfiliate_list_smart_linksread-onlyList 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_migrationread-onlyPreview 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_migrationdestructiveRoll 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.
youfiliate_start_migrationdestructiveStart 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 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 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.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.andrewmpierce/youfiliate-mcp",
  "title": "Youfiliate Smart Links",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://youfiliate-mcp.onrender.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "isRequired": true,
          "description": "Bearer token using your Youfiliate API key. Format: 'Bearer youfiliate_sk_your_key_here'."
        }
      ]
    }
  ],
  "version": "0.1.1",
  "packages": [
    {
      "version": "0.1.1",
      "transport": {
        "type": "stdio"
      },
      "identifier": "youfiliate-mcp",
      "registryType": "pypi",
      "environmentVariables": [
        {
          "name": "YOUFILIATE_API_KEY",
          "isSecret": true,
          "isRequired": true,
          "description": "Your Youfiliate API key (starts with youfiliate_sk_). Generate one at https://youfiliate.com/settings."
        },
        {
          "name": "YOUFILIATE_API_BASE_URL",
          "default": "https://app.youfiliate.com",
          "description": "Youfiliate backend URL."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/andrewmpierce/youfiliate-mcp",
    "source": "github"
  },
  "websiteUrl": "https://youfiliate.com",
  "description": "Create geo-targeted affiliate smart links, pull analytics, and rewrite YouTube descriptions."
}