Affilio - Smart Affiliate Link Optimization Platform

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

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 matchi

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 produc

Check International Redirect

Test an Amazon affiliate link from US, EU, and Asia vantage points to check whether Amazon's OneLink geo-redirect is active for it. Returns per-region resolved marketplace domains, a summary of whether a redirect was detected, and caveats about the test's limitations. Use this tool when the user needs to: - Check if their Amazon affiliate link redirects international visitors - Verify OneLink is configured for a specific product link - Diagnose why international clicks may not be earning commi

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

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

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 s