Affilio Link Tools

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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