@buygolinks/mcp 0.9.0 → 0.17.1

package/README.md

@@ -1,6 +1,6 @@
 # @buygolinks/mcp
 
-Model Context Protocol (MCP) server for [buygolinks.com](https://buygolinks.com) — create and manage branded short links (with Amazon affiliate geo-routing) from any MCP-compatible AI agent: Claude Desktop, Cursor, Cline, Continue, Hermes, and others.
+Model Context Protocol (MCP) server for [buygolinks.com](https://buygolinks.com) — create and manage branded short links, campaigns, offers, and analytics from any MCP-compatible AI agent: Claude Desktop, Cursor, Cline, Continue, Hermes, and others.
 
 ## Install
 
@@ -62,8 +62,8 @@ Most MCP clients use the same shape. Point them at the `npx -y @buygolinks/mcp`
 
 | Tool | Description |
 |---|---|
-| `create_link` | Create a short link. Amazon URLs auto-detect ASIN and trigger geo-routing. |
-| `update_link` | Edit a link's title, source label, custom domain, password, archive state, or custom alias (e.g. `summer-sale` → `https://click.example.com/summer-sale`). |
+| `create_link` | Create a short link. The destination URL is passed through untouched (include your own affiliate tag). |
+| `update_link` | Edit a link's destination URL, title, source label, custom domain, password, archive state, or custom alias (e.g. `summer-sale` → `https://click.example.com/summer-sale`). Repointing the destination preserves the short code, alias, and click history. |
 | `list_links` | List your links with click counts. |
 | `get_link_stats` | Per-link analytics (by day, country, device, browser, hour, weekday). |
 | `get_overview_stats` | Account-wide analytics. |
@@ -74,16 +74,22 @@ Most MCP clients use the same shape. Point them at the `npx -y @buygolinks/mcp`
 | `list_affiliate_networks` / `create_affiliate_network` / `update_affiliate_network` / `delete_affiliate_network` | Manage affiliate networks. Each network exposes a per-network postback URL (`/postback/n/{token}`) the user pastes into the network's S2S settings. |
 | `list_offers` / `create_offer` / `update_offer` / `delete_offer` | Manage destination URLs ("offers"). Optionally tied to an affiliate network so the right conversion-param name is propagated on outbound clicks. |
 | `list_landers` / `create_lander` / `update_lander` / `delete_lander` | Manage landing pages. Lander URLs may contain `{clickid}` tokens which the resolver expands. |
-| `list_campaigns` / `create_campaign` / `get_campaign` / `update_campaign` / `delete_campaign` | Manage campaigns. One campaign = one tracked short link + N offers (weighted) + N optional landers + a per-campaign postback URL + a pixel snippet. |
+| `list_traffic_sources` / `create_traffic_source` / `update_traffic_source` / `delete_traffic_source` | Manage **traffic sources** — the platforms you buy traffic from (Facebook, TikTok, Google, …). Each has a `name`, optional `platform`, and `token_params` mapping the source's click macros onto sub1..sub5 (e.g. Facebook sub1 = Ad ID `{{ad.id}}`). `list_traffic_sources` returns a `presets` catalog. Campaigns reference one via `traffic_source_id`. |
+| `list_tracking_pixels` / `create_tracking_pixel` / `update_tracking_pixel` / `delete_tracking_pixel` | Manage ad-platform pixels (Facebook, Google, TikTok, …). Each pixel has a `default_event` (e.g. `Purchase`, `Lead`, `CompletePayment`) and, for Facebook/TikTok, an optional server-side Conversions API `capi_token`. `list_tracking_pixels` also returns a `platforms` catalog with each platform's valid `events`, `defaultEvent`, and `capi` support. Pixels fire on short-link clicks and can be chosen as a campaign's conversion pixel. |
+| `list_campaigns` / `create_campaign` / `get_campaign` / `update_campaign` / `delete_campaign` / `duplicate_campaign` | Manage campaigns. `duplicate_campaign` deep-copies a campaign (settings + full routing flow + offer/lander pools) into a fresh short link named `COPY - {name}` (`COPY (1) - …` when copying a copy); stats and the unique direct-link slug are not carried over. One campaign = one tracked short link + N offers (weighted) + N optional landers + a per-campaign postback URL + a pixel snippet. A campaign references one saved traffic source via `traffic_source_id` and an optional `conversion_pixel_id` + `conversion_event` that fires (server-side via CAPI when configured) when the campaign converts. Each campaign also returns a `click_url` (`…/click`) — the single, campaign-agnostic lander CTA link (same on every campaign, so one lander serves many) that always resolves to an offer (never a dead page); the campaign is read from the visitor's cookie or the ad's `?utm_campaign={direct_slug}` forwarded onto the CTA. Set `direct_slug` to run traffic straight to a lander with no tracker hop (`?utm_campaign={direct_slug}` resolves the campaign at `/click` and stitches via the property tag); `fallback_url` is the never-dead-end guarantee. |
 | `set_campaign_offers` / `set_campaign_landers` | Replace the campaign's offer/lander split. Items are `{ offer_id, weight }` / `{ lander_id, weight }`. |
+| `get_campaign_flow` / `set_campaign_flow` | Read/replace the campaign's **routing flow graph** (n8n-style). Nodes are `source` (one entry) / `lander` / `offer`; weighted edges go source→lander, source→offer, or lander→offer. The resolver walks this graph per click so a specific lander routes to its own specific offers — use it to split-test offers, divert a lander to a different offer, or insert a landing page before an offer. Saving also re-derives the flat offer/lander pools. |
 | `get_campaign_stats` | Full campaign report: visits, lander views, offer clicks, conversions, revenue, cost, profit, CTR/CR/EPC/ROI, breakdowns, recent events. |
 | `list_properties` / `create_property` / `get_property` / `update_property` / `delete_property` | Manage **properties** — GTM/GA-style site containers. One property = one universal tag (`/t.js?p={key}`) the user installs on every page of their site. Every page auto-reports pageviews, time-on-page, scroll, outbound clicks, and conversions; campaign traffic auto-attributes by click. `create_property` requires an active custom domain (the tag is served first-party from the user's own domain so it tracks on iOS/Safari) and returns the bound `tracking_domain` + install `snippet`. |
 | `set_property_campaigns` | Link/unlink campaigns to a property (many-to-many, for the source split in reports). Items are `{ campaign_id }`. |
 | `get_property_stats` | Full property report: page views, unique visitors, outbound, conversions, revenue, avg time/scroll, top pages, source split (organic vs campaign), country/device/browser/referrer breakdowns, recent events. |
+| `list_property_pages` | Distinct pages seen across all the user's properties (most-viewed first): `{ url, path, title, property_name, views }`. Any page here can be used as a campaign **lander** — pass its `url` to `create_lander`, then wire that lander into a campaign flow with `set_campaign_flow`. |
+| `get_tracker_overview` | Unified Tracker dashboard across **both** streams (sites + campaigns) in one call: totals (page views / visitors / visits / offer clicks / conversions / revenue), daily activity, country/device/browser breakdowns, per-property + per-campaign rollups, a **per-UTM-campaign** rollup (auto-detected Google `utm_*` tags), and the 50 most recent events. The "is everything running and getting traffic?" view. |
+| `get_tracker_events` | Unified event log across both streams with full **search / filter / sort** over auto-detected UTM tags. `q` free-text, `stream`, `event`, exact `utm_*` filters, `sort`/`dir` (ts\|revenue\|utm_campaign\|utm_source\|country), pagination. Returns events + `facets` (distinct UTM values) + `total`. |
 
 ## Example prompts
 
-> "Create a short link for `https://www.amazon.com/dp/B0CFG6RB6T` with the title 'Anker GaN charger'."
+> "Create a short link for `https://www.amazon.com/dp/B0CFG6RB6T?tag=mytag-20` with the title 'Anker GaN charger'."
 
 > "How many clicks did I get last week? Which country drove the most?"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buygolinks/mcp",
-  "version": "0.9.0",
+  "version": "0.17.1",
   "description": "MCP server for buygolinks.com — create and manage branded short links with Amazon affiliate geo-routing from any MCP-compatible AI agent (Claude Desktop, Cursor, Cline, Continue, Hermes).",
   "type": "module",
   "bin": {

package/src/index.js

@@ -48,7 +48,7 @@ const TOOLS = [
   {
     name: 'create_link',
     description:
-      'Create a new branded short link on buygolinks.com. If the destination is an Amazon product URL (contains /dp/ASIN), the ASIN is auto-extracted and the link will geo-route to the visitor\'s local Amazon storefront with the owner\'s affiliate tag applied. By default, the link is created under the user\'s first active custom domain (if any); pass `domain_id` to pin it to a specific one. Returns the short URL and link metadata (including `short_domain`, the hostname the link will resolve at).',
+      'Create a new branded short link on buygolinks.com. The link redirects to exactly the destination URL you provide — for Amazon links, include your own Associates tag in the URL (e.g. ?tag=yourtag-20); buygolinks passes it through untouched and does not rewrite or geo-route Amazon URLs. By default, the link is created under the user\'s first active custom domain (if any); pass `domain_id` to pin it to a specific one. Returns the short URL and link metadata (including `short_domain`, the hostname the link will resolve at).',
     inputSchema: {
       type: 'object',
       properties: {
@@ -58,11 +58,11 @@ const TOOLS = [
         },
         title: {
           type: 'string',
-          description: 'Optional human-readable title for the link. If omitted on an Amazon URL, the product title is scraped.',
+          description: 'Optional human-readable title for the link.',
         },
         source_label: {
           type: 'string',
-          description: 'Optional source label (campaign tag) — appears in ascsubtag on Amazon redirects for attribution.',
+          description: 'Optional source label (campaign tag) for your own attribution.',
         },
         domain_id: {
           type: 'number',
@@ -75,11 +75,12 @@ const TOOLS = [
   {
     name: 'update_link',
     description:
-      'Update an existing short link. Supports renaming (title), changing the campaign source label, swapping the branded domain it resolves under (domain_id), setting a memorable custom alias (alias), archiving/unarchiving, and password-protecting the link. Pass `alias` to give the link a memorable URL slug on its custom domain (e.g. alias="summer-sale" → https://click.example.com/summer-sale). Aliases require the link to be on a custom domain. Setting `alias` REPLACES any previous alias — the old alias stops resolving immediately and is freed for any other link to claim. The link\'s original random short code (link.code) keeps working forever regardless of alias changes. Pass alias="" or alias=null to remove the alias. Changing the link\'s `domain_id` clears the alias automatically. To set or change the password, pass `password` as a non-empty string. To remove password protection, pass an empty string for `password`. To move the link back to the platform default (buygolinks.com), pass `domain_id: null`. Returns the updated link row including `short_domain`, `alias`, and `password_protected` (boolean — the plaintext is never returned).',
+      'Update an existing short link. Supports changing where it redirects (destination_url), renaming (title), changing the campaign source label, swapping the branded domain it resolves under (domain_id), setting a memorable custom alias (alias), archiving/unarchiving, and password-protecting the link. Pass `destination_url` to repoint the link at a new target — the short code, alias, and click history are preserved; only the redirect destination moves (the ASIN is re-extracted automatically for Amazon /dp/ URLs). Pass `alias` to give the link a memorable URL slug on its custom domain (e.g. alias="summer-sale" → https://click.example.com/summer-sale). Aliases require the link to be on a custom domain. Setting `alias` REPLACES any previous alias — the old alias stops resolving immediately and is freed for any other link to claim. The link\'s original random short code (link.code) keeps working forever regardless of alias changes. Pass alias="" or alias=null to remove the alias. Changing the link\'s `domain_id` clears the alias automatically. To set or change the password, pass `password` as a non-empty string. To remove password protection, pass an empty string for `password`. To move the link back to the platform default (buygolinks.com), pass `domain_id: null`. Returns the updated link row including `short_domain`, `alias`, and `password_protected` (boolean — the plaintext is never returned).',
     inputSchema: {
       type: 'object',
       properties: {
         link_id:      { type: 'number', description: 'The numeric id of the link (from list_links / create_link).' },
+        destination_url: { type: 'string', description: 'New destination URL the short link redirects to (must be http(s)). The short code, alias, and click history are preserved.' },
         title:        { type: 'string', description: 'New display title.' },
         source_label: { type: 'string', description: 'New source label (campaign tag).' },
         archived:     { type: 'boolean', description: 'Set true to archive the link, false to unarchive.' },
@@ -126,7 +127,7 @@ const TOOLS = [
   {
     name: 'get_overview_stats',
     description:
-      'Get account-wide click analytics across all of the user\'s links: total clicks, clicks by day, top countries, devices, browsers, referrers, peak hour and weekday. Use this for "how is my account doing" type questions.',
+      'Get account-wide analytics for the user\'s branded short LINKS only: total link CLICKS, clicks by day, top countries, devices, browsers, referrers, peak hour and weekday. This covers the Links section ONLY — it does NOT include Tracker page views, site-property traffic, or campaign visits/conversions. For PAGE VIEWS (site properties) or campaign traffic use the Tracker tools instead: get_tracker_overview (clicks-vs-pageviews unified rollup), list_properties, or get_property_stats. If the user asks for "clicks AND page views" together, call BOTH this tool and get_tracker_overview and combine them — they read from separate event streams. Use this for "how are my links doing" type questions.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -193,7 +194,7 @@ const TOOLS = [
   {
     name: 'create_affiliate_network',
     description:
-      'Add a new affiliate network. The server mints a per-network postback URL (https://buygolinks.com/postback/n/{token}) the user pastes into the network. Returns the network row including postback_url.',
+      'Add a new affiliate network. The server mints a per-network postback URL (https://buygolinks.com/postback/n/{token}) the user pastes into the network. The postback accepts ?{conversion_param}={clickid}&{payout_param}={payout}&{currency_param}={currency}&{txid_param}={txid} — payout, currency, and txid are optional. Returns the network row including postback_url.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -201,6 +202,7 @@ const TOOLS = [
         conversion_param: { type: 'string', description: 'What the network calls the click id in its postback (default "clickid").' },
         payout_param:     { type: 'string', description: 'What the network calls the payout amount (default "payout").' },
         currency_param:   { type: 'string', description: 'What the network calls the currency code (default "currency").' },
+        txid_param:       { type: 'string', description: 'What the network calls the transaction/order id in its postback (default "txid"). Stored on the conversion for reconciliation/dedupe.' },
       },
       required: ['name'],
     },
@@ -216,6 +218,7 @@ const TOOLS = [
         conversion_param: { type: 'string' },
         payout_param: { type: 'string' },
         currency_param: { type: 'string' },
+        txid_param: { type: 'string' },
         archived: { type: 'boolean' },
       },
       required: ['network_id'],
@@ -240,7 +243,7 @@ const TOOLS = [
   {
     name: 'create_offer',
     description:
-      'Create an offer (a destination URL: affiliate landing page, product page, etc). If the URL is an Amazon /dp/ link the ASIN is auto-extracted. Link the offer to an affiliate_network_id so the resolver knows which postback param name to use when redirecting (e.g. some networks expect ?aff_sub=… instead of ?clickid=…).',
+      'Create an offer (a destination URL: affiliate landing page, product page, etc). The URL is used exactly as given when redirecting — include any affiliate tag yourself. Link the offer to an affiliate_network_id so the resolver knows which postback param name to use when redirecting (e.g. some networks expect ?aff_sub=… instead of ?clickid=…).',
     inputSchema: {
       type: 'object',
       properties: {
@@ -319,6 +322,105 @@ const TOOLS = [
     inputSchema: { type: 'object', properties: { lander_id: { type: 'number' } }, required: ['lander_id'] },
   },
 
+  // ─── Traffic sources ────────────────────────────────────────────────────
+  {
+    name: 'list_traffic_sources',
+    description:
+      'List the user\'s traffic sources (the platforms they buy traffic from — Facebook, TikTok, Google, …). Each source has a `name`, an optional `platform` (pixel-platform key), and `token_params`: how the source\'s click macros map onto the Google UTM params the resolver captures (utm_source/medium/campaign/term/content), e.g. Facebook utm_campaign = `{{campaign.id}}`, utm_content = Ad ID `{{ad.id}}`. The response also includes a `presets` catalog of ready-made sources with standard macros. Campaigns reference a source via `traffic_source_id` (see create_campaign / update_campaign).',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'create_traffic_source',
+    description:
+      'Create a traffic source. `token_params` is an array of `{ slot, label, token }` where slot is one of utm_source/utm_medium/utm_campaign/utm_term/utm_content, label is a human name (e.g. "Campaign ID"), and token is the platform macro (e.g. "{{campaign.id}}"). Use `list_traffic_sources` first to copy a preset\'s token_params for the big platforms.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'e.g. "Facebook".' },
+        platform: { type: ['string', 'null'], description: 'Optional pixel-platform key (facebook, google_ads, tiktok, bing, …) for the icon + conversion-pixel suggestion.' },
+        token_params: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              slot: { type: 'string', enum: ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content'] },
+              label: { type: 'string' },
+              token: { type: 'string' },
+            },
+            required: ['slot'],
+          },
+        },
+      },
+      required: ['name'],
+    },
+  },
+  {
+    name: 'update_traffic_source',
+    description: 'Update a traffic source\'s name, platform, token_params, or archive state. token_params replaces the whole set.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        traffic_source_id: { type: 'number' },
+        name: { type: 'string' },
+        platform: { type: ['string', 'null'] },
+        token_params: { type: 'array', items: { type: 'object', properties: { slot: { type: 'string' }, label: { type: 'string' }, token: { type: 'string' } }, required: ['slot'] } },
+        archived: { type: 'boolean' },
+      },
+      required: ['traffic_source_id'],
+    },
+  },
+  {
+    name: 'delete_traffic_source',
+    description: 'Delete a traffic source. Campaigns using it keep their data but their `traffic_source_id` is cleared.',
+    inputSchema: { type: 'object', properties: { traffic_source_id: { type: 'number' } }, required: ['traffic_source_id'] },
+  },
+
+  // ─── Tracking pixels ────────────────────────────────────────────────────
+  {
+    name: 'list_tracking_pixels',
+    description:
+      'List the user\'s tracking pixels (Facebook, Google Ads, TikTok, etc). Each pixel has a platform, pixel_id, a default_event it fires, an active flag, and has_capi_token (whether a server-side Conversions API token is set — the token itself is never returned). The response also includes a `platforms` catalog with each platform\'s valid `events`, its `defaultEvent`, and `capi` (whether server-side conversions are supported). Pixels fire on short-link clicks (account-wide by default, or per-link selection) and can be chosen as a campaign\'s conversion pixel.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'create_tracking_pixel',
+    description:
+      'Create a tracking pixel. `platform` is one of: facebook, google_ads, google_analytics, google_tag_manager, linkedin, twitter, tiktok, pinterest, snapchat, reddit, quora, bing, adroll. `default_event` must be a valid event for that platform (see the `platforms` catalog from list_tracking_pixels) — defaults to the platform default (e.g. Facebook "PageView"). For Facebook and TikTok you can pass a `capi_token` (server-side Conversions API access token) so campaign conversions fire server-to-server.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        platform: { type: 'string', description: 'Pixel platform key (facebook, google_ads, tiktok, …).' },
+        pixel_id: { type: 'string', description: 'The platform\'s pixel/dataset id.' },
+        label: { type: 'string', description: 'Optional friendly name.' },
+        default_event: { type: 'string', description: 'Event this pixel fires by default (must be valid for the platform).' },
+        capi_token: { type: 'string', description: 'Optional server-side Conversions API access token (Facebook/TikTok only).' },
+        active: { type: 'boolean', description: 'Whether the pixel is active. Defaults to true.' },
+      },
+      required: ['platform', 'pixel_id'],
+    },
+  },
+  {
+    name: 'update_tracking_pixel',
+    description: 'Update a tracking pixel\'s pixel_id, label, default_event, active flag, or CAPI token. Pass capi_token as an empty string or null to clear the stored token.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        pixel_id_row: { type: 'number', description: 'The id of the tracking_pixels row to update (from list_tracking_pixels).' },
+        pixel_id: { type: 'string', description: 'New platform pixel id.' },
+        label: { type: 'string' },
+        default_event: { type: 'string', description: 'New default event (must be valid for the pixel\'s platform).' },
+        capi_token: { type: ['string', 'null'], description: 'New Conversions API token, or empty/null to clear.' },
+        active: { type: 'boolean' },
+      },
+      required: ['pixel_id_row'],
+    },
+  },
+  {
+    name: 'delete_tracking_pixel',
+    description: 'Delete a tracking pixel. It is removed from any per-link selections and any campaign that used it as its conversion pixel (the campaign\'s conversion_pixel_id is cleared).',
+    inputSchema: { type: 'object', properties: { pixel_id_row: { type: 'number' } }, required: ['pixel_id_row'] },
+  },
+
   // ─── Tracker: campaigns ─────────────────────────────────────────────────
   {
     name: 'list_campaigns',
@@ -329,17 +431,23 @@ const TOOLS = [
   {
     name: 'create_campaign',
     description:
-      'Create a campaign. A campaign mints one short link (campaign.code) that the user pastes into Facebook / TikTok / etc. The resolver mints a click_id per visit, optionally routes through a lander (weighted), then redirects to an offer (weighted). Conversions come back via the campaign\'s postback URL or the affiliate network\'s postback URL. You can optionally attach offer_ids / lander_ids inline with matching offer_weights / lander_weights arrays for a one-call setup.',
+      'Create a campaign. A campaign mints one short link (campaign.code) that the user pastes into Facebook / TikTok / etc. The resolver mints a click_id per visit, optionally routes through a lander (weighted), then redirects to an offer (weighted). The response also includes a `click_url` (`…/click`) — the single, campaign-agnostic DEFINED lander click URL the user pastes into their lander\'s CTA button. It\'s the same on every campaign, so one lander can be reused across many; the campaign is resolved at click time from the visitor\'s `bgl_clk_{code}` cookie (short-link traffic) or the ad\'s `?utm_campaign={direct_slug}` that the lander forwards onto the CTA (direct-link). It always resolves to an offer (chosen by the flow graph), never a lander, never a dead page. For DIRECT-LINK campaigns (ad points straight at the lander, no tracker hop), set `direct_slug`, put `?utm_campaign={direct_slug}` on the ad URL, and have the lander forward that utm_campaign onto the CTA — `/click` resolves the campaign from it and the property tag stitches the page view too. `fallback_url` guarantees the click never dead-ends. Conversions come back via the campaign\'s postback URL or the affiliate network\'s postback URL. You can optionally attach offer_ids / lander_ids inline with matching offer_weights / lander_weights arrays for a one-call setup.',
     inputSchema: {
       type: 'object',
       properties: {
         name: { type: 'string' },
-        traffic_source_label: { type: 'string', description: 'Free text, e.g. "Facebook", "TikTok".' },
+        traffic_source_id: { type: ['number', 'null'], description: 'Id of one of the user\'s saved traffic sources (from list_traffic_sources) to attribute this campaign to. Preferred over the legacy `traffic_source` string. Mirrors the source name into the display label.' },
+        traffic_source: { type: 'string', description: 'Legacy structured traffic source key — one of: facebook, instagram, google, youtube, tiktok, microsoft, linkedin, twitter, pinterest, snapchat, reddit, native, email, organic, other. Prefer `traffic_source_id`.' },
+        traffic_source_label: { type: 'string', description: 'Free text display label.' },
         country: { type: 'string', description: 'ISO2 default geo.' },
         cost_model: { type: 'string', enum: ['not_tracked', 'cpc', 'cpm'] },
         cost_value: { type: 'number' },
         transition_mode: { type: 'string', enum: ['302', 'meta_refresh'] },
         domain_id: { type: ['number', 'null'], description: 'Optional id of one of the user\'s active custom domains (from list_domains). The campaign\'s short link will resolve at that hostname. If omitted, defaults to the user\'s first active custom domain, or buygolinks.com if they have none. Pass null to force the platform default.' },
+        conversion_pixel_id: { type: ['number', 'null'], description: 'Optional id of one of the user\'s tracking pixels (from list_tracking_pixels) to fire when this campaign converts (server-side via the pixel\'s CAPI token when set). Pass null for no conversion pixel.' },
+        conversion_event: { type: 'string', description: 'Event name to fire on conversion (e.g. "Purchase", "Lead", "CompletePayment"). Must be a valid event for the conversion pixel\'s platform; defaults to that pixel\'s default_event.' },
+        direct_slug: { type: ['string', 'null'], description: 'Optional direct-link tag, unique per user (lowercased alnum + dashes, e.g. "bsu-fb-cold"). For running traffic STRAIGHT to a lander with no tracker hop: put `?utm_campaign={direct_slug}` on the ad URL and the property tag stitches the page view to this campaign. Returns 409 (direct_slug_taken) if another campaign already uses it. Pass null to clear.' },
+        fallback_url: { type: ['string', 'null'], description: 'Optional URL the click falls back to when the flow yields no live offer — the never-dead-end guarantee. Pass null to use the platform default.' },
         offer_ids: { type: 'array', items: { type: 'number' } },
         offer_weights: { type: 'array', items: { type: 'number' } },
         lander_ids: { type: 'array', items: { type: 'number' } },
@@ -355,18 +463,24 @@ const TOOLS = [
   },
   {
     name: 'update_campaign',
-    description: 'Update a campaign\'s name, country, cost model/value, transition mode, traffic source label, branded domain, or archive state. Use set_campaign_offers / set_campaign_landers to change the destination wiring. Pass domain_id to move the campaign\'s short link to a different custom domain, or null to send it back to buygolinks.com.',
+    description: 'Update a campaign\'s name, structured traffic source, country, cost model/value, transition mode, traffic source label, branded domain, conversion pixel/event, direct-link slug, fallback URL, or archive state. Use set_campaign_offers / set_campaign_landers (or set_campaign_flow) to change the destination wiring. Pass domain_id to move the campaign\'s short link to a different custom domain, or null to send it back to buygolinks.com.',
     inputSchema: {
       type: 'object',
       properties: {
         campaign_id: { type: 'number' },
         name: { type: 'string' },
+        traffic_source_id: { type: ['number', 'null'], description: 'Id of a saved traffic source (from list_traffic_sources), or null to clear. Preferred over `traffic_source`.' },
+        traffic_source: { type: ['string', 'null'], description: 'Legacy structured traffic source key or null to clear.' },
         traffic_source_label: { type: 'string' },
         country: { type: 'string' },
         cost_model: { type: 'string', enum: ['not_tracked', 'cpc', 'cpm'] },
         cost_value: { type: 'number' },
         transition_mode: { type: 'string', enum: ['302', 'meta_refresh'] },
         domain_id: { type: ['number', 'null'], description: 'Id of one of the user\'s active custom domains, or null to move the campaign back to buygolinks.com.' },
+        conversion_pixel_id: { type: ['number', 'null'], description: 'Id of a tracking pixel to fire on conversion, or null to clear.' },
+        conversion_event: { type: 'string', description: 'Event the conversion pixel fires (must be valid for that pixel\'s platform).' },
+        direct_slug: { type: ['string', 'null'], description: 'Direct-link tag for utm_campaign-based stitching (unique per user), or null to clear. Returns 409 (direct_slug_taken) on collision.' },
+        fallback_url: { type: ['string', 'null'], description: 'Never-dead-end fallback URL when no live offer exists, or null to use the platform default.' },
         archived: { type: 'boolean' },
       },
       required: ['campaign_id'],
@@ -377,6 +491,11 @@ const TOOLS = [
     description: 'Delete a campaign. The short link stops resolving immediately. Tracker events for this campaign are also deleted (cascade).',
     inputSchema: { type: 'object', properties: { campaign_id: { type: 'number' } }, required: ['campaign_id'] },
   },
+  {
+    name: 'duplicate_campaign',
+    description: 'Deep-copy a campaign: clones the campaign settings plus its full routing flow (source → landers → offers graph and split-test weights) and its offer/lander pools. The copy gets a fresh short link + postback token and a name like "COPY - {original}" (or "COPY (1) - {original}", "COPY (2) - …" when copying a copy). Stats are NOT copied; the direct-link slug is left blank (it must be unique). Returns the new campaign, including its short_url/click_url. Useful for spinning up a new geo/angle variant of a working campaign without rebuilding the flow.',
+    inputSchema: { type: 'object', properties: { campaign_id: { type: 'number' } }, required: ['campaign_id'] },
+  },
   {
     name: 'set_campaign_offers',
     description: 'Replace the campaign\'s offer split with the supplied items. Each item is { offer_id, weight }. Weight is an integer; higher = more traffic. To direct all traffic to one offer use weight=100 for that offer and don\'t include the others.',
@@ -415,6 +534,54 @@ const TOOLS = [
       required: ['campaign_id', 'items'],
     },
   },
+  {
+    name: 'get_campaign_flow',
+    description:
+      'Get the campaign\'s routing flow graph (n8n-style). Returns { flow: { nodes, edges }, offers, landers }. Nodes are { id, kind: "source"|"lander"|"offer", ref_id, pos_x, pos_y, offer?, lander? } — exactly one "source" node (the traffic entry). Edges are { id, from_node_id, to_node_id, weight } and only go source→lander, source→offer (direct), or lander→offer; weight is the split-test weight. This graph is what the resolver walks per click, letting a specific lander route to its own specific offers.',
+    inputSchema: {
+      type: 'object',
+      properties: { campaign_id: { type: 'number' } },
+      required: ['campaign_id'],
+    },
+  },
+  {
+    name: 'set_campaign_flow',
+    description:
+      'Replace the campaign\'s routing flow graph. Body: { nodes: [{ tmp_id, kind, ref_id, pos_x, pos_y }], edges: [{ from, to, weight }] }. tmp_id is any client-stable string key; edges reference nodes by tmp_id. Provide exactly one node with kind="source" (ref_id null) as the traffic entry; "lander" / "offer" nodes set ref_id to a lander/offer id you own. Edges must go source→lander, source→offer, or lander→offer. weight is an integer split-test weight (higher = more traffic). Saving also re-derives the flat offer/lander pools, so legacy reports stay consistent. Use this to add a second offer for a split test, divert a lander to a different offer, or insert a landing page before an offer.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        campaign_id: { type: 'number' },
+        nodes: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              tmp_id: { type: 'string' },
+              kind: { type: 'string', enum: ['source', 'lander', 'offer'] },
+              ref_id: { type: ['number', 'null'] },
+              pos_x: { type: 'number' },
+              pos_y: { type: 'number' },
+            },
+            required: ['tmp_id', 'kind'],
+          },
+        },
+        edges: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              from: { type: 'string' },
+              to: { type: 'string' },
+              weight: { type: 'number' },
+            },
+            required: ['from', 'to'],
+          },
+        },
+      },
+      required: ['campaign_id', 'nodes', 'edges'],
+    },
+  },
   {
     name: 'get_campaign_stats',
     description:
@@ -433,13 +600,13 @@ const TOOLS = [
   {
     name: 'list_properties',
     description:
-      'List the user\'s properties with quick-look stats (page_views / unique_visitors / conversions / revenue). A property is a whole-site container: the user installs ONE universal tag (returned as `snippet`) on every page of their site and every page auto-reports pageviews, time-on-page, scroll depth, outbound clicks, and conversions. Page events auto-attribute to a campaign when a visitor arrives carrying that campaign\'s click.',
+      'List the user\'s properties with quick-look stats (page_views / unique_visitors / conversions / revenue). Best one-call tool for "page views per property" / "page views for each site". A property is a whole-site container: the user installs ONE universal tag (returned as `snippet`) on every page of their site and every page auto-reports pageviews, time-on-page, scroll depth, outbound clicks, and conversions. Page events auto-attribute to a campaign when a visitor arrives carrying that campaign\'s click.',
     inputSchema: { type: 'object', properties: {} },
   },
   {
     name: 'create_property',
     description:
-      'Create a property (a GTM/GA-style site container). Returns the property with its public property_key, the `tracking_domain` it\'s bound to, and an install `snippet` — a single <script> tag the user pastes into the <head> of every page of their site. REQUIRES an active custom domain: the tag is served from the user\'s own domain so it stays first-party to their site, which is required for tracking to work on iOS/Safari (a tag loaded cross-site from buygolinks.com gets its visitor cookie partitioned/blocked). Defaults to the user\'s first active custom domain; pass `domain_id` (from list_domains) to pin a specific one. If the user has no active custom domain, returns error `domain_required` — have them add one via create_domain first. To record conversions, the site sets window.bglConversion = true (optionally window.bglRevenue) on a thank-you page, or calls window.bglFireConversion(revenue).',
+      'Create a property (a GTM/GA-style site container). Returns the property with its public property_key, the `tracking_domain` it\'s bound to, and an install `snippet` — a single GA/Facebook-style inline <script> block (a self-invoking function that sets up a conversion-queue stub and injects the async tag) the user pastes into the <head> of every page of their site. REQUIRES an active custom domain: the tag is served from the user\'s own domain so it stays first-party to their site, which is required for tracking to work on iOS/Safari (a tag loaded cross-site from buygolinks.com gets its visitor cookie partitioned/blocked). Defaults to the user\'s first active custom domain; pass `domain_id` (from list_domains) to pin a specific one. If the user has no active custom domain, returns error `domain_required` — have them add one via create_domain first. To record conversions, the site sets window.bglConversion = true (optionally window.bglRevenue) on a thank-you page, or calls window.bglFireConversion(revenue) — the queue stub makes that call safe even before the async tag finishes loading.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -497,7 +664,7 @@ const TOOLS = [
   {
     name: 'get_property_stats',
     description:
-      'Get a property\'s GA-style report: totals (page_views / unique_visitors / outbound / conversions / revenue / avg_time_on_page_ms / avg_scroll_pct / CR), by_day, by_page (top paths with views+conversions+revenue), by_source (organic vs each stitched campaign), by_country / by_device / by_browser / by_referrer, and the 50 most recent events.',
+      'Get a single property\'s GA-style PAGE VIEW report: totals (page_views / unique_visitors / outbound / conversions / revenue / avg_time_on_page_ms / avg_scroll_pct / CR), by_day, by_page (top paths with views+conversions+revenue), by_source (organic vs each stitched campaign), by_country / by_device / by_browser / by_referrer, and the 50 most recent events.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -507,10 +674,50 @@ const TOOLS = [
       required: ['property_id'],
     },
   },
+  {
+    name: 'list_property_pages',
+    description:
+      'List the distinct pages observed across ALL the user\'s properties (the pageview stream), most-viewed first. Each entry is `{ url, path, title, property_id, property_name, views }`. Any of these pages can be used as a campaign LANDER — pass its `url` to `create_lander` (the page title makes a good lander name) and then wire the resulting lander into a campaign flow via `set_campaign_flow`. Use this to turn a real page on the user\'s site into a lander without retyping its URL.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'get_tracker_overview',
+    description:
+      'PAGE VIEWS live here. Get the unified Tracker dashboard rollup across BOTH event streams (site properties + campaigns) in one call. Returns totals (page_views / unique_visitors / visits / offer_clicks / conversions / revenue), a merged daily activity series (by_day), dimension breakdowns (by_country / by_device / by_browser), per-property and per-campaign rollups (the per-property rollup gives page_views for each site/property), a per-UTM-campaign rollup (utm_campaigns — auto-detected Google utm_source/medium/campaign/content tags with events/conversions/revenue), and the 50 most recent events across both streams. This is the go-to tool for "page views", "page views per property", "campaign traffic", and "is everything running and getting traffic?". NOTE: page_views here is Tracker site traffic and is SEPARATE from branded short-link clicks (get_overview_stats). If the user asks for "clicks AND page views" together, call BOTH this tool and get_overview_stats and combine them.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        days: { type: 'number', description: 'Window size in days (1–90). Defaults to 14.' },
+      },
+    },
+  },
+  {
+    name: 'get_tracker_events',
+    description:
+      'Query the unified Tracker event log across BOTH streams (site properties + campaigns), with full search / filter / sort over auto-detected Google UTM tags. Every event carries utm_source / utm_medium / utm_campaign / utm_term / utm_content. Use `q` for free-text search (matches any utm value, country, device, browser, referrer, source name, event type); `stream` to scope to all|property|campaign; `event` to filter by event_type; the utm_* params for exact-match filtering; and `sort`+`dir` to order by ts|revenue|utm_campaign|utm_source|country. Returns the matching page of events plus `facets` (distinct utm values present in the window) to drive filter pickers, and `total` for the full match count.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        days: { type: 'number', description: 'Window size in days (1–90). Defaults to 14.' },
+        q: { type: 'string', description: 'Free-text search across utm_*, country, device, browser, referrer, source name, event type.' },
+        stream: { type: 'string', enum: ['all', 'property', 'campaign'], description: 'Scope to one stream. Defaults to all.' },
+        event: { type: 'string', description: 'Exact event_type filter, e.g. page_view, outbound, conversion, visit, lander_view, offer_click.' },
+        utm_source: { type: 'string', description: 'Exact utm_source filter.' },
+        utm_medium: { type: 'string', description: 'Exact utm_medium filter.' },
+        utm_campaign: { type: 'string', description: 'Exact utm_campaign filter.' },
+        utm_term: { type: 'string', description: 'Exact utm_term filter.' },
+        utm_content: { type: 'string', description: 'Exact utm_content filter.' },
+        sort: { type: 'string', enum: ['ts', 'revenue', 'utm_campaign', 'utm_source', 'country'], description: 'Sort field. Defaults to ts.' },
+        dir: { type: 'string', enum: ['asc', 'desc'], description: 'Sort direction. Defaults to desc.' },
+        limit: { type: 'number', description: 'Page size (1–500). Defaults to 200.' },
+        offset: { type: 'number', description: 'Pagination offset. Defaults to 0.' },
+      },
+    },
+  },
 ];
 
 const server = new Server(
-  { name: 'buygolinks', version: '0.8.0' },
+  { name: 'buygolinks', version: '0.11.0' },
   { capabilities: { tools: {} } },
 );
 
@@ -536,6 +743,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
       }
       case 'update_link': {
         const body = {};
+        if (typeof args.destination_url === 'string') body.destination_url = args.destination_url;
         if (typeof args.title === 'string')        body.title = args.title;
         if (typeof args.source_label === 'string') body.source_label = args.source_label;
         if (typeof args.archived === 'boolean')    body.archived = args.archived;
@@ -597,6 +805,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         if (typeof args.conversion_param === 'string') body.conversion_param = args.conversion_param;
         if (typeof args.payout_param === 'string')     body.payout_param     = args.payout_param;
         if (typeof args.currency_param === 'string')   body.currency_param   = args.currency_param;
+        if (typeof args.txid_param === 'string')       body.txid_param       = args.txid_param;
         result = await api('/api/affiliate-networks', { method: 'POST', body: JSON.stringify(body) });
         break;
       }
@@ -606,6 +815,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         if (typeof args.conversion_param === 'string') body.conversion_param = args.conversion_param;
         if (typeof args.payout_param === 'string')     body.payout_param = args.payout_param;
         if (typeof args.currency_param === 'string')   body.currency_param = args.currency_param;
+        if (typeof args.txid_param === 'string')       body.txid_param = args.txid_param;
         if (typeof args.archived === 'boolean')        body.archived = args.archived;
         result = await api(`/api/affiliate-networks/${Number(args.network_id)}`, { method: 'PATCH', body: JSON.stringify(body) });
         break;
@@ -671,6 +881,61 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         break;
       }
 
+      // ── Traffic sources ──
+      case 'list_traffic_sources': {
+        result = await api('/api/traffic-sources');
+        break;
+      }
+      case 'create_traffic_source': {
+        const body = { name: args.name };
+        if ('platform' in args)               body.platform = args.platform;
+        if (Array.isArray(args.token_params))  body.token_params = args.token_params;
+        result = await api('/api/traffic-sources', { method: 'POST', body: JSON.stringify(body) });
+        break;
+      }
+      case 'update_traffic_source': {
+        const body = {};
+        if (typeof args.name === 'string')     body.name = args.name;
+        if ('platform' in args)                body.platform = args.platform;
+        if (Array.isArray(args.token_params))  body.token_params = args.token_params;
+        if (typeof args.archived === 'boolean') body.archived = args.archived;
+        result = await api(`/api/traffic-sources/${Number(args.traffic_source_id)}`, { method: 'PATCH', body: JSON.stringify(body) });
+        break;
+      }
+      case 'delete_traffic_source': {
+        result = await api(`/api/traffic-sources/${Number(args.traffic_source_id)}`, { method: 'DELETE' });
+        break;
+      }
+
+      // ── Tracking pixels ──
+      case 'list_tracking_pixels': {
+        result = await api('/api/tracking-pixels');
+        break;
+      }
+      case 'create_tracking_pixel': {
+        const body = { platform: args.platform, pixel_id: args.pixel_id };
+        if (typeof args.label === 'string')         body.label = args.label;
+        if (typeof args.default_event === 'string') body.default_event = args.default_event;
+        if (typeof args.capi_token === 'string')    body.capi_token = args.capi_token;
+        if (typeof args.active === 'boolean')       body.active = args.active;
+        result = await api('/api/tracking-pixels', { method: 'POST', body: JSON.stringify(body) });
+        break;
+      }
+      case 'update_tracking_pixel': {
+        const body = {};
+        if (typeof args.pixel_id === 'string')      body.pixel_id = args.pixel_id;
+        if (typeof args.label === 'string')         body.label = args.label;
+        if (typeof args.default_event === 'string') body.default_event = args.default_event;
+        if ('capi_token' in args)                   body.capi_token = args.capi_token;
+        if (typeof args.active === 'boolean')       body.active = args.active;
+        result = await api(`/api/tracking-pixels/${Number(args.pixel_id_row)}`, { method: 'PATCH', body: JSON.stringify(body) });
+        break;
+      }
+      case 'delete_tracking_pixel': {
+        result = await api(`/api/tracking-pixels/${Number(args.pixel_id_row)}`, { method: 'DELETE' });
+        break;
+      }
+
       // ── Tracker: campaigns ──
       case 'list_campaigns': {
         result = await api('/api/campaigns');
@@ -678,11 +943,15 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
       }
       case 'create_campaign': {
         const body = { name: args.name };
-        for (const k of ['traffic_source_label', 'country', 'cost_model', 'transition_mode']) {
+        for (const k of ['traffic_source', 'traffic_source_label', 'country', 'cost_model', 'transition_mode', 'conversion_event']) {
           if (typeof args[k] === 'string') body[k] = args[k];
         }
         if (typeof args.cost_value === 'number') body.cost_value = args.cost_value;
         if ('domain_id' in args)                body.domain_id = args.domain_id;
+        if ('traffic_source_id' in args)        body.traffic_source_id = args.traffic_source_id;
+        if ('conversion_pixel_id' in args)      body.conversion_pixel_id = args.conversion_pixel_id;
+        if ('direct_slug' in args)              body.direct_slug = args.direct_slug;
+        if ('fallback_url' in args)             body.fallback_url = args.fallback_url;
         if (Array.isArray(args.offer_ids))      body.offer_ids = args.offer_ids;
         if (Array.isArray(args.offer_weights))  body.offer_weights = args.offer_weights;
         if (Array.isArray(args.lander_ids))     body.lander_ids = args.lander_ids;
@@ -696,11 +965,16 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
       }
       case 'update_campaign': {
         const body = {};
-        for (const k of ['name', 'traffic_source_label', 'country', 'cost_model', 'transition_mode']) {
+        for (const k of ['name', 'traffic_source_label', 'country', 'cost_model', 'transition_mode', 'conversion_event']) {
           if (typeof args[k] === 'string') body[k] = args[k];
         }
+        if ('traffic_source' in args)           body.traffic_source = args.traffic_source;
+        if ('traffic_source_id' in args)        body.traffic_source_id = args.traffic_source_id;
         if (typeof args.cost_value === 'number') body.cost_value = args.cost_value;
         if ('domain_id' in args)                body.domain_id = args.domain_id;
+        if ('conversion_pixel_id' in args)      body.conversion_pixel_id = args.conversion_pixel_id;
+        if ('direct_slug' in args)              body.direct_slug = args.direct_slug;
+        if ('fallback_url' in args)             body.fallback_url = args.fallback_url;
         if (typeof args.archived === 'boolean') body.archived = args.archived;
         result = await api(`/api/campaigns/${Number(args.campaign_id)}`, { method: 'PATCH', body: JSON.stringify(body) });
         break;
@@ -709,6 +983,10 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         result = await api(`/api/campaigns/${Number(args.campaign_id)}`, { method: 'DELETE' });
         break;
       }
+      case 'duplicate_campaign': {
+        result = await api(`/api/campaigns/${Number(args.campaign_id)}/duplicate`, { method: 'POST' });
+        break;
+      }
       case 'set_campaign_offers': {
         result = await api(`/api/campaigns/${Number(args.campaign_id)}/offers`, {
           method: 'PUT', body: JSON.stringify({ items: args.items }),
@@ -721,6 +999,16 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         });
         break;
       }
+      case 'get_campaign_flow': {
+        result = await api(`/api/campaigns/${Number(args.campaign_id)}/flow`);
+        break;
+      }
+      case 'set_campaign_flow': {
+        result = await api(`/api/campaigns/${Number(args.campaign_id)}/flow`, {
+          method: 'PUT', body: JSON.stringify({ nodes: args.nodes, edges: args.edges }),
+        });
+        break;
+      }
       case 'get_campaign_stats': {
         const days = args?.days ? `?days=${Number(args.days)}` : '';
         result = await api(`/api/campaigns/${Number(args.campaign_id)}/stats${days}`);
@@ -766,6 +1054,25 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         result = await api(`/api/properties/${Number(args.property_id)}/stats${days}`);
         break;
       }
+      case 'list_property_pages': {
+        result = await api('/api/property-pages');
+        break;
+      }
+
+      case 'get_tracker_overview': {
+        const days = args?.days ? `?days=${Number(args.days)}` : '';
+        result = await api(`/api/tracker/overview${days}`);
+        break;
+      }
+      case 'get_tracker_events': {
+        const qs = new URLSearchParams();
+        for (const k of ['days', 'q', 'stream', 'event', 'utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'sort', 'dir', 'limit', 'offset']) {
+          if (args?.[k] !== undefined && args[k] !== null && args[k] !== '') qs.set(k, String(args[k]));
+        }
+        const q = qs.toString();
+        result = await api(`/api/tracker/events${q ? `?${q}` : ''}`);
+        break;
+      }
 
       default:
         throw new Error(`unknown tool: ${name}`);