youfiliate_create_smart_link
ActiveTool of youfiliate-mcp
declared in 1.27.0
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.
Parameters 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": null,
"description": "iOS app deep link URL (e.g., 'amazon://...')"
},
"android_app_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Android App Url",
"default": null,
"description": "Android app deep link URL"
},
"ios_fallback_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Ios Fallback Url",
"default": null,
"description": "Fallback URL if iOS app is not installed"
},
"android_fallback_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Android Fallback Url",
"default": null,
"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": null,
"description": "Custom short URL slug (auto-generated if omitted). Lowercase alphanumeric + hyphens only."
},
"title": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
],
"title": "Title",
"default": null,
"description": "Human-readable label for this link"
},
"geo_rules": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/GeoRuleInput"
}
},
{
"type": "null"
}
],
"title": "Geo Rules",
"default": null,
"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": null,
"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"
}
}
}Parent server
youfiliate-mcp
https://github.com/andrewmpierce/youfiliate-mcp
2/7 registries