Affilio Link Tools

by KissPeter

325 downloads

Not rated

GitHub

About

Affilio.link URL shortener — shorten affiliate links, get QR codes, powered by Affilio's affiliate link management platform.

Details

Author: KissPeter
Downloads: 325
Categories: Other, Marketing, Developer Tools

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Affilio Link Tools

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

From the repository

Add the server to your MCP client configuration with the endpoint https://mcp.affilio.link/mcp and transport type streamable-http. No API key or sign-up is required. Invoke the shorten_url tool with a url parameter to receive a short link, QR code URL, and base64 QR image.

`shorten_url`

Shorten any URL into a compact, trackable Affilio.link short URL with affiliate link intelligence. IMPORTANT: This is the UNAUTHENTICATED public shortener. It creates a TEMPORARY, MCP-hosted link at `mcp.affilio.link/r/{code}` that expires after 30 days and is NOT tied to any Affilio account or dashboard. Links are verified for security before they redirect (new/unknown domains return `pending=True` until verified). For a PERMANENT, account-owned link at `affilio.link/ur/{code}` with full click analytics, use the `auth.create_link` tool instead (requires a bearer token). Affilio deduplicates identical URLs (same URL always returns the same short link) and generates a branded QR code in the same call. Use this tool when the user needs to: - Shorten a URL for sharing on social media, email, or in content - Generate a QR code for print/digital media alongside the short link - Get a compact, clean version of a long product or affiliate URL - Create a throwaway/temporary link that does not need account tracking Returns: short_url (str): The shortened URL — e.g. https://mcp.affilio.link/r/abc1234 qr_url (str): Hosted QR code image URL (PNG, publicly accessible) qr_image_base64 (str): Base64-encoded PNG QR code — embed as data:image/png;base64,... classification (str): Security classification — "allowlisted" (safe) or "pending" (awaiting verification) powered_by (str): Brand tagline pending (bool): True while the link awaits security verification (redirects return 202 until then) expires_at (str | null): ISO 8601 expiry timestamp. MCP short links expire after the configured period (default 30 days) — this is never null for this tool. already_existed (bool): True if this URL was previously shortened (deduplicated) Docs & technical deep-dive: https://affilio.link/blog/mcp-tools-guide Powered by Affilio.link — smart affiliate link management.

`generate_qr`

Generate a branded QR code PNG image for any URL with full visual customization. Returns a base64-encoded PNG you can embed directly in a web page (`<img src="data:image/png;base64,..."/>`), email, or document. Color, transparency, and dot style are all configurable. Use this tool when the user needs to: - Create a scannable QR code for a URL - Generate print-ready QR codes for marketing materials, packaging, or flyers - Embed a QR code in an email or web page - Create a branded QR code matching their visual identity (custom colors, transparent background) Returns: url (str): The input URL that was encoded qr_image_base64 (str): Base64-encoded PNG — embed as data:image/png;base64,... mime_type (str): Always "image/png" powered_by (str): Brand tagline Docs & technical deep-dive: https://affilio.link/blog/mcp-tools-guide Powered by Affilio.link — smart affiliate link management.

`check_url`

Check the health and destination of a URL (link checker / redirect resolver). Follows the redirect chain, returns the final resolved URL, HTTP status codes, page title, and — for Amazon and AliExpress product pages — whether the product is still available (in stock / not deleted). Use this tool when the user needs to: - Verify an affiliate or product link still works (not broken / 404 / dead) - Resolve where a short or redirecting link actually lands - Check whether an Amazon/AliExpress product is still available - Inspect the redirect chain of a URL Returns: finalUrl (str): The final URL after following all redirects title (str): The destination page's title (or empty string) redirectChain (list[str]): URLs visited, in order responseCode (str): Final HTTP status code (e.g. "200", "404") lastRedirectResponseCode (str): Status of the last redirect hop, if any available (bool | null): True/False for Amazon/AliExpress product pages, null when availability is not applicable Powered by Affilio.link — smart affiliate link management.

`auth.create_link`

Create a new affiliate link in your Affilio account. IMPORTANT: This AUTHENTICATED tool creates a PERMANENT, account-owned affiliate link at `affilio.link/ur/{code}`. The link lives in the Affilio dashboard with full click analytics and does NOT expire. Prefer this over the unauthenticated `shorten_url` whenever the user wants a long-lived, tracked link. Affilio validates the target URL, auto-classifies its affiliate network, and generates a short URL plus QR code automatically. The response contains the new link's ID, short URL, affiliate classification, labels, visibility status, and timestamps — everything needed for subsequent `auth.get_link`, `auth.update_link`, or `auth.add_product_link` calls. Requires Bearer token authentication (`Authorization: Bearer <api_key>`). Returns an `auth_error` envelope if authentication fails. Technical reference: https://affilio.link/blog/mcp-for-everyone

`auth.get_link`

Retrieve a single affiliate link by its ID. Returns full link metadata: short URL, target URL, affiliate network classification, labels, visibility (public/private), QR code URL, click stats summary, archive status, and created/updated timestamps. Requires Bearer token authentication. Returns an `auth_error` envelope if authentication fails or the link does not belong to the authenticated account. Technical reference: https://affilio.link/blog/mcp-for-everyone

`auth.list_links`

List affiliate links in your Affilio account with pagination. Returns an array of link objects sorted by creation date (newest first). Each item includes: ID, short URL, title, target URL, labels, affiliate classification, archive status, visibility, and click count. Use `skip` + `limit` to paginate through large link collections. Requires Bearer token authentication. Technical reference: https://affilio.link/blog/mcp-for-everyone

`auth.update_link`

Update an existing affiliate link's title, destination URL, or labels. Provide any combination of `title`, `target`, and `labels`. Fields omitted from the call are left unchanged (partial update). Labels are replaced entirely — pass the full desired label set, not a delta. Returns the updated link object on success. Requires Bearer token authentication. Technical reference: https://affilio.link/blog/mcp-for-everyone

`auth.archive_link`

Archive (soft-delete) an affiliate link. Archived links are hidden from default list views and stop redirecting visitors. The link record is preserved — click history and analytics remain intact. Use this instead of hard deletion to maintain historical data. Requires Bearer token authentication. Returns an `auth_error` envelope if authentication fails. Technical reference: https://affilio.link/blog/mcp-for-everyone

`auth.get_link_stats`

Retrieve click analytics for a specific affiliate link. Returns aggregated traffic data for the link: total clicks, unique visitor estimates, geographic breakdown, referrer sources, and device/browser distribution (data availability depends on the analytics backend configuration). Requires Bearer token authentication. Technical reference: https://affilio.link/blog/mcp-for-everyone

`auth.list_links_ranked`

List affiliate links ranked by click performance (highest click count first). Returns the same link schema as auth.list_links but ordered by total clicks descending. Useful for identifying your top-performing affiliate links, optimising content strategy, and spotting underperforming links that need attention. Use `skip` + `limit` to paginate. Requires Bearer token authentication. Technical reference: https://affilio.link/blog/mcp-for-everyone

`auth.create_product`

Create a new product in your Affilio product catalog. Products are the items you promote via affiliate links. Each product can have multiple affiliate links (one per platform or country) and can be added to one or more Affilio storefronts. The response includes the new product's ID — you'll need it for auth.add_product_link, auth.get_product, and storefront operations. Requires Bearer token authentication. Technical reference: https://affilio.link/blog/mcp-for-everyone

`auth.get_product`

Retrieve a single product from your Affilio product catalog by ID. Returns full product metadata: name, description, image URL, associated affiliate links, categories, custom attributes, visibility/active status, and timestamps. Requires Bearer token authentication. Technical reference: https://affilio.link/blog/mcp-for-everyone

`auth.add_product_link`

Associate an affiliate link with a product in your Affilio catalog. This is how you connect an affiliate URL to a product so it appears in storefront listings and can be tracked per-product. A single product can have multiple links — one per country, platform, or affiliate network. Typical workflow: 1. auth.create_link(url=<affiliate_url>) → get link_id 2. auth.create_product(name=...) → get product_id 3. auth.add_product_link(product_id=..., link_id=...) → link attached Requires Bearer token authentication. Returns an `auth_error` envelope if authentication fails. Technical reference: https://affilio.link/blog/mcp-for-everyone

`auth.set_link_visibility`

Set the public/private visibility of an affiliate link within a product. Public links appear in the product's Affilio storefront listing; private links are hidden. Visibility is scoped to the product the link belongs to. Requires Bearer token authentication. Technical reference: https://affilio.link/blog/mcp-for-everyone

`auth.get_store`

Retrieve your Affilio storefront configuration. Returns full store configuration: name, description, public store URL/slug, branding settings (primary/secondary colors, logo, fonts, favicon, banner image), product display layout, footer text, embedded snippet, active status, and timestamps. Requires Bearer token authentication. Technical reference: https://affilio.link/blog/mcp-for-everyone

`auth.list_store_products`

List all products assigned to your Affilio storefront. Returns paginated product objects with: name, description, image URL, associated affiliate links, categories, custom attributes, and active status. Products are returned in their configured storefront display order. Use `skip` + `limit` to paginate through large storefronts. Requires Bearer token authentication. Technical reference: https://affilio.link/blog/mcp-for-everyone

`auth.update_store`

Update your Affilio storefront's metadata. Provide any combination of `name`, `description`, and `layout` — fields omitted are left unchanged. For full branding updates (colors, logo, custom fonts, banner image, favicon, footer text, embedded snippet) use the Affilio dashboard → Storefront settings. Requires Bearer token authentication. Technical reference: https://affilio.link/blog/mcp-for-everyone

`auth.list_integrations`

List all affiliate platform integrations connected to your Affilio account. Returns the status, configuration, and credential metadata for each connected integration. Active integrations are required to use auth.search_products for live product search. Requires Bearer token authentication. Technical reference: https://affilio.link/blog/mcp-for-everyone

`auth.search_products`

Search for products on a connected affiliate platform. Returns live product listings from the platform's catalog including: product name, price, image URL, direct affiliate link, ASIN/item ID, and platform metadata. Results are ready to pass directly to auth.create_product. Prerequisites: - Platform integration must be active (connect via Affilio dashboard → Settings → Integrations) - Verify with auth.list_integrations before calling Error envelopes: - `plan_restriction`: Live product search requires a paid Affilio plan - `validation_error`: Unsupported or misspelled platform name - `no_integrations_connected`: No integration found for the requested platform - `auth_error`: Missing or invalid Bearer token Requires Bearer token authentication. Technical reference: https://affilio.link/blog/mcp-for-everyone

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "affilio link tools": {
            "affilio": {
                "url": "https://mcp.affilio.link/mcp",
                "type": "streamable-http"
            }
        }
    }
}

McpServers

{
    "affilio": {
        "url": "https://mcp.affilio.link/mcp",
        "type": "streamable-http"
    }
}

Affilio MCP Link Shortener

> Free URL shortener MCP tool powered by Affilio.link — > the smart affiliate link management platform for content creators and affiliate marketers.

Quick Start

Add this to your MCP client configuration: ``

json
{
  "mcpServers": {
    "affilio": {
      "url": "https://mcp.affilio.link/mcp",
      "type": "streamable-http"
    }
  }
}



No API key. No sign-up. Works immediately.

---

What it does

shorten_url

 — the single tool this server exposes.

Give it any URL. Get back a short link and a QR code.


Input:  https://www.amazon.com/dp/B08XYZ123?tag=mystore-20&ref=very_long_param
Output: https://mcp.affilio.link/r/7gZpzzt
        https://mcp.affilio.link/qr/7gZpzzt



- Works with any URL — affiliate links, product pages, articles, anything
- Short links resolve instantly via 302 redirect
- QR code returned inline as base64 PNG — renders directly in supporting AI hosts
- Links expire after 30 days
- No authentication required
- Rate limited to 10 links per hour per client to prevent abuse
- All URLs scanned for malware and phishing before activation

---

Use cases


For AI assistants:
- User shares a long URL and asks to make it shareable → call

shorten_url


- User is writing social media content and needs a compact link → call

shorten_url


- User wants a QR code for a product or landing page → call

shorten_url


- User is creating affiliate content and wants a clean link → call

shorten_url



For developers:
- Test MCP streamable-http transport integration
- Example of a production-grade, zero-auth public MCP server
- Reference implementation for rate limiting + security scanning in MCP tools

---

Transport


This server uses the MCP streamable-http transport (the current MCP standard, superseding SSE).

| Property | Value |
|---|---|
| Endpoint |

https://mcp.affilio.link/mcp

 |
| Transport |

streamable-http

 |
| Auth | None required |
| Protocol | MCP 2024-11-05 |

Compatible with Claude Desktop, Cursor, GitHub Copilot, and any MCP-compatible host.

---

Tool reference

shorten_url



Shorten any URL and get a QR code.

Input:

| Parameter | Type | Required | Description |
|---|---|---|---|
|

url

 | string | Yes | The full URL to shorten (must be http or https) |

Output:

json
{
  "short_url": "https://mcp.affilio.link/r/7gZpzzt",
  "qr_url": "https://mcp.affilio.link/qr/7gZpzzt",
  "qr_image_base64": "...",
  "classification": "allowlisted",
  "powered_by": "Powered by Affilio.link — Smart Affiliate Link Management",
  "pending": false
}



Classifications:
-

allowlisted

 — known-safe domain (Amazon, eBay, AliExpress, etc.), activated instantly
-

safe

 — verified safe by security scanner, activated
-

pending

 — unknown domain, being scanned, link activates within 60 seconds
-

unsafe` — blocked, link not created ---

Security

Every URL submitted goes through a multi-stage security pipeline: 1. Domain allowlist — major affiliate and retail domains skip scanning entirely (instant activation) 2. Domain cache — previously classified domains served from cache (180-day TTL) 3. Threat intelligence — unknown domains scanned via Sophos Intelix before activation 4. Link expiry — all links expire after 30 days, limiting spam longevity Links to phishing, malware, or harmful content are rejected at creation time. ---

Rate limits

| Limit | Value | |---|---| | Links per hour | 10 per client IP | | Scan timeout | 3 seconds (fails safe) | If you hit a rate limit, wait 60 minutes before retrying. Retrying immediately will not help. ---

About Affilio

Affilio.link is a smart affiliate link management SaaS platform for YouTube content creators and Amazon affiliate store owners. Core features: - Automatic broken link replacement — when a product goes out of stock or a link dies, Affilio replaces it automatically. No manual monitoring needed. - Mobile deep linking — links open directly in the Amazon app, eBay app, and others instead of a browser. Better conversion, no SDK required. - Product storefronts — branded product pages with multiple affiliate links per product across Amazon, eBay, AliExpress, and more. - QR code generation — every link and product gets a QR code automatically. - Security scanning — all links scanned for malware and phishing to protect your audience. - Analytics — click tracking, link performance, and conversion insights. → affilio.link

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

shorten_url

generate_qr

check_url

auth.create_link

auth.get_link

auth.list_links

auth.update_link

auth.archive_link

auth.get_link_stats

auth.list_links_ranked

auth.create_product

auth.get_product

auth.add_product_link

auth.set_link_visibility

auth.get_store

auth.list_store_products

auth.update_store

auth.list_integrations

auth.search_products

Claude Desktop / Cursor

McpServers

Affilio MCP Link Shortener

Quick Start

What it does

Use cases

Transport

Tool reference

shorten_url

Security

Rate limits

About Affilio

Install

More like this

Sequential Thinking

Sentry

Github

Filesystem

EverArt

Google Drive

`shorten_url`

`generate_qr`

`check_url`

`auth.create_link`

`auth.get_link`

`auth.list_links`

`auth.update_link`

`auth.archive_link`

`auth.get_link_stats`

`auth.list_links_ranked`

`auth.create_product`

`auth.get_product`

`auth.add_product_link`

`auth.set_link_visibility`

`auth.get_store`

`auth.list_store_products`

`auth.update_store`

`auth.list_integrations`

`auth.search_products`