@buygolinks/mcp 0.1.1 → 0.8.0

package/README.md

@@ -63,9 +63,23 @@ 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`). |
 | `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. |
+| `list_domains` | List your branded custom short-link domains with provisioning + SSL status. |
+| `create_domain` | Register a new branded domain (e.g. `go.acme.com`). Returns the CNAME target. |
+| `verify_domain` | Force a fresh Cloudflare status check after DNS is added. |
+| `delete_domain` | Remove a branded domain. |
+| `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. |
+| `set_campaign_offers` / `set_campaign_landers` | Replace the campaign's offer/lander split. Items are `{ offer_id, weight }` / `{ lander_id, weight }`. |
+| `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` returns the 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. |
 
 ## Example prompts
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buygolinks/mcp",
-  "version": "0.1.1",
+  "version": "0.8.0",
   "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. Returns the short URL and link metadata.',
+      '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).',
     inputSchema: {
       type: 'object',
       properties: {
@@ -64,10 +64,32 @@ const TOOLS = [
           type: 'string',
           description: 'Optional source label (campaign tag) — appears in ascsubtag on Amazon redirects for attribution.',
         },
+        domain_id: {
+          type: 'number',
+          description: 'Optional id of one of the user\'s active custom domains (from list_domains). If omitted, defaults to the user\'s first active custom domain, or buygolinks.com if they have none.',
+        },
       },
       required: ['destination_url'],
     },
   },
+  {
+    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).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        link_id:      { type: 'number', description: 'The numeric id of the link (from list_links / create_link).' },
+        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.' },
+        password:     { type: 'string', description: 'Password to protect the link with. Empty string clears any existing password. Max 200 chars.' },
+        domain_id:    { type: ['number', 'null'], description: 'Id of one of the user\'s active custom domains, or null to move the link back to buygolinks.com.' },
+        alias:        { type: ['string', 'null'], description: 'Custom path alias on the link\'s custom domain. 1–32 chars; letters, numbers, hyphens, underscores; must start with letter/number. Empty string or null removes the alias. Replacing an alias retires the old one immediately. Requires the link to be on a custom domain.' },
+      },
+      required: ['link_id'],
+    },
+  },
   {
     name: 'list_links',
     description:
@@ -115,10 +137,378 @@ const TOOLS = [
       },
     },
   },
+  {
+    name: 'list_domains',
+    description:
+      'List the user\'s branded custom short-link domains (e.g. go.acme.com). Returns each domain with its provisioning status (pending DNS / active / failed), SSL status, and the CNAME target the user needs to point their hostname at. Also returns the plan tier and the number of domains the plan allows.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'create_domain',
+    description:
+      'Register a new branded custom domain so short links can resolve at the user\'s own hostname instead of buygolinks.com. After creation, the user must add a CNAME record at their DNS provider pointing the hostname at the returned cname_target. SSL is auto-issued by Cloudflare once DNS resolves. Free plan does not allow custom domains.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        hostname: {
+          type: 'string',
+          description: 'The hostname to register, e.g. "go.acme.com". Must be a valid public hostname; the buygolinks.com apex and its subdomains are reserved.',
+        },
+      },
+      required: ['hostname'],
+    },
+  },
+  {
+    name: 'verify_domain',
+    description:
+      'Force a re-check of a custom domain\'s status against Cloudflare. Use after the user has added the CNAME record to advance the domain from "pending" to "active". Returns the refreshed domain row.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        domain_id: { type: 'number', description: 'The numeric id of the domain (from list_domains / create_domain).' },
+      },
+      required: ['domain_id'],
+    },
+  },
+  {
+    name: 'delete_domain',
+    description:
+      'Remove a custom domain. Deletes the Cloudflare hostname binding and the local record. Short links served via this domain stop resolving immediately.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        domain_id: { type: 'number', description: 'The numeric id of the domain to remove.' },
+      },
+      required: ['domain_id'],
+    },
+  },
+
+  // ─── Tracker: affiliate networks ────────────────────────────────────────
+  {
+    name: 'list_affiliate_networks',
+    description:
+      'List the user\'s affiliate networks (ClickBank, Digistore24, MaxWeb, etc). Each network includes a postback_url the user pastes into the network\'s S2S settings so conversions flow back automatically. Networks also configure how the network names the click id and payout in postbacks (conversion_param, payout_param).',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    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.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'Display name, e.g. "ClickBank".' },
+        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").' },
+      },
+      required: ['name'],
+    },
+  },
+  {
+    name: 'update_affiliate_network',
+    description: 'Update an affiliate network (rename or change postback param names). Pass archived=true to soft-archive.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        network_id: { type: 'number' },
+        name: { type: 'string' },
+        conversion_param: { type: 'string' },
+        payout_param: { type: 'string' },
+        currency_param: { type: 'string' },
+        archived: { type: 'boolean' },
+      },
+      required: ['network_id'],
+    },
+  },
+  {
+    name: 'delete_affiliate_network',
+    description: 'Delete an affiliate network. Offers that referenced this network keep their URL but have affiliate_network_id set to NULL.',
+    inputSchema: {
+      type: 'object',
+      properties: { network_id: { type: 'number' } },
+      required: ['network_id'],
+    },
+  },
+
+  // ─── Tracker: offers ────────────────────────────────────────────────────
+  {
+    name: 'list_offers',
+    description: 'List all offers (destination URLs) owned by the user. Use these as the end-point of a campaign.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    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=…).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string' },
+        url:  { type: 'string', description: 'Destination URL (http/https).' },
+        affiliate_network_id: { type: ['number', 'null'] },
+        payout: { type: 'number' },
+        payout_currency: { type: 'string', description: 'ISO 4217 currency, default USD.' },
+        country: { type: 'string', description: 'ISO2 country code (optional).' },
+      },
+      required: ['name', 'url'],
+    },
+  },
+  {
+    name: 'update_offer',
+    description: 'Update an offer\'s name, URL, payout, currency, country, or affiliate network. Pass archived=true to soft-archive.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        offer_id: { type: 'number' },
+        name: { type: 'string' },
+        url: { type: 'string' },
+        affiliate_network_id: { type: ['number', 'null'] },
+        payout: { type: 'number' },
+        payout_currency: { type: 'string' },
+        country: { type: 'string' },
+        archived: { type: 'boolean' },
+      },
+      required: ['offer_id'],
+    },
+  },
+  {
+    name: 'delete_offer',
+    description: 'Delete an offer. Removes it from any campaigns it was attached to.',
+    inputSchema: { type: 'object', properties: { offer_id: { type: 'number' } }, required: ['offer_id'] },
+  },
+
+  // ─── Tracker: landers ───────────────────────────────────────────────────
+  {
+    name: 'list_landers',
+    description: 'List the user\'s landing pages. Landers are optional intermediate pages between the short link and the offer.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'create_lander',
+    description:
+      'Create a lander (the user\'s own landing page that visitors hit between the short link and the offer). The URL may contain {clickid} tokens which the resolver expands. Install the campaign\'s pixel snippet on the lander to get impressions, time-on-page, scroll depth, and outbound click tracking.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string' },
+        url:  { type: 'string', description: 'Lander URL. May contain {clickid} which the resolver will replace.' },
+        country: { type: 'string' },
+      },
+      required: ['name', 'url'],
+    },
+  },
+  {
+    name: 'update_lander',
+    description: 'Update a lander\'s name, URL, or country. Pass archived=true to soft-archive.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        lander_id: { type: 'number' },
+        name: { type: 'string' },
+        url: { type: 'string' },
+        country: { type: 'string' },
+        archived: { type: 'boolean' },
+      },
+      required: ['lander_id'],
+    },
+  },
+  {
+    name: 'delete_lander',
+    description: 'Delete a lander. Removes it from any campaigns it was attached to.',
+    inputSchema: { type: 'object', properties: { lander_id: { type: 'number' } }, required: ['lander_id'] },
+  },
+
+  // ─── Tracker: campaigns ─────────────────────────────────────────────────
+  {
+    name: 'list_campaigns',
+    description:
+      'List the user\'s campaigns with quick-look stats (visits / offer_clicks / conversions / revenue). Each campaign has a short_url to paste into traffic sources, a postback_url for the affiliate network, and a pixel_snippet to install on landers.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    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.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string' },
+        traffic_source_label: { type: 'string', description: 'Free text, e.g. "Facebook", "TikTok".' },
+        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.' },
+        offer_ids: { type: 'array', items: { type: 'number' } },
+        offer_weights: { type: 'array', items: { type: 'number' } },
+        lander_ids: { type: 'array', items: { type: 'number' } },
+        lander_weights: { type: 'array', items: { type: 'number' } },
+      },
+      required: ['name'],
+    },
+  },
+  {
+    name: 'get_campaign',
+    description: 'Get a single campaign with its attached offers, landers, postback URL, short URL, and pixel snippet.',
+    inputSchema: { type: 'object', properties: { campaign_id: { type: 'number' } }, required: ['campaign_id'] },
+  },
+  {
+    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.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        campaign_id: { type: 'number' },
+        name: { type: 'string' },
+        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.' },
+        archived: { type: 'boolean' },
+      },
+      required: ['campaign_id'],
+    },
+  },
+  {
+    name: 'delete_campaign',
+    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: '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.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        campaign_id: { type: 'number' },
+        items: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: { offer_id: { type: 'number' }, weight: { type: 'number' } },
+            required: ['offer_id', 'weight'],
+          },
+        },
+      },
+      required: ['campaign_id', 'items'],
+    },
+  },
+  {
+    name: 'set_campaign_landers',
+    description: 'Replace the campaign\'s lander split. Pass empty items to remove all landers (clicks then go direct to offer). Each item is { lander_id, weight }.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        campaign_id: { type: 'number' },
+        items: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: { lander_id: { type: 'number' }, weight: { type: 'number' } },
+            required: ['lander_id', 'weight'],
+          },
+        },
+      },
+      required: ['campaign_id', 'items'],
+    },
+  },
+  {
+    name: 'get_campaign_stats',
+    description:
+      'Get a campaign\'s full report: totals (visits / unique / lander_views / offer_clicks / conversions / revenue / cost / profit / CTR / CR / EPC / ROI), by_day / by_country / by_device / by_browser / by_referrer / by_hour, per-offer and per-lander performance, and the 50 most recent events.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        campaign_id: { type: 'number' },
+        days: { type: 'number', description: 'Window size in days (1–90). Defaults to 14.' },
+      },
+      required: ['campaign_id'],
+    },
+  },
+
+  // ─── Tracker: properties (GTM/GA-style site containers) ─────────────────
+  {
+    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.',
+    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 and an install `snippet` — a single <script> tag the user pastes into the <head> of every page of their site. To record conversions, the site sets window.bglConversion = true (optionally window.bglRevenue) on a thank-you page, or calls window.bglFireConversion(revenue).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string' },
+        site_url: { type: 'string', description: 'Optional primary site URL, informational.' },
+      },
+      required: ['name'],
+    },
+  },
+  {
+    name: 'get_property',
+    description: 'Get a single property with its install snippet and the campaigns linked to it.',
+    inputSchema: { type: 'object', properties: { property_id: { type: 'number' } }, required: ['property_id'] },
+  },
+  {
+    name: 'update_property',
+    description: 'Update a property\'s name, site_url, or archive state.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        property_id: { type: 'number' },
+        name: { type: 'string' },
+        site_url: { type: ['string', 'null'] },
+        archived: { type: 'boolean' },
+      },
+      required: ['property_id'],
+    },
+  },
+  {
+    name: 'delete_property',
+    description: 'Delete a property. Its page events are also deleted (cascade). The install snippet stops reporting.',
+    inputSchema: { type: 'object', properties: { property_id: { type: 'number' } }, required: ['property_id'] },
+  },
+  {
+    name: 'set_property_campaigns',
+    description: 'Replace the set of campaigns linked to a property (many-to-many, for organisation and the source split in reports). Each item is { campaign_id }. Pass empty items to unlink all. Stitching still happens automatically by click regardless of explicit links.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        property_id: { type: 'number' },
+        items: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: { campaign_id: { type: 'number' } },
+            required: ['campaign_id'],
+          },
+        },
+      },
+      required: ['property_id', 'items'],
+    },
+  },
+  {
+    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.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        property_id: { type: 'number' },
+        days: { type: 'number', description: 'Window size in days (1–90). Defaults to 14.' },
+      },
+      required: ['property_id'],
+    },
+  },
 ];
 
 const server = new Server(
-  { name: 'buygolinks', version: '0.1.0' },
+  { name: 'buygolinks', version: '0.8.0' },
   { capabilities: { tools: {} } },
 );
 
@@ -130,13 +520,33 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
     let result;
     switch (name) {
       case 'create_link': {
+        const body = {
+          destination_url: args.destination_url,
+          title: args.title,
+          source_label: args.source_label,
+        };
+        if (typeof args.domain_id === 'number') body.domain_id = args.domain_id;
         result = await api('/api/links', {
           method: 'POST',
-          body: JSON.stringify({
-            destination_url: args.destination_url,
-            title: args.title,
-            source_label: args.source_label,
-          }),
+          body: JSON.stringify(body),
+        });
+        break;
+      }
+      case 'update_link': {
+        const body = {};
+        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;
+        if (typeof args.password === 'string')     body.password = args.password;
+        if (args.domain_id === null || typeof args.domain_id === 'number') {
+          body.domain_id = args.domain_id;
+        }
+        if (args.alias === null || typeof args.alias === 'string') {
+          body.alias = args.alias;
+        }
+        result = await api(`/api/links/${Number(args.link_id)}`, {
+          method: 'PATCH',
+          body: JSON.stringify(body),
         });
         break;
       }
@@ -155,6 +565,204 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         result = await api(`/api/stats/overview${days}`);
         break;
       }
+      case 'list_domains': {
+        result = await api('/api/domains');
+        break;
+      }
+      case 'create_domain': {
+        result = await api('/api/domains', {
+          method: 'POST',
+          body: JSON.stringify({ hostname: args.hostname }),
+        });
+        break;
+      }
+      case 'verify_domain': {
+        result = await api(`/api/domains/${Number(args.domain_id)}/verify`, { method: 'POST' });
+        break;
+      }
+      case 'delete_domain': {
+        result = await api(`/api/domains/${Number(args.domain_id)}`, { method: 'DELETE' });
+        break;
+      }
+
+      // ── Tracker: networks ──
+      case 'list_affiliate_networks': {
+        result = await api('/api/affiliate-networks');
+        break;
+      }
+      case 'create_affiliate_network': {
+        const body = { name: args.name };
+        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;
+        result = await api('/api/affiliate-networks', { method: 'POST', body: JSON.stringify(body) });
+        break;
+      }
+      case 'update_affiliate_network': {
+        const body = {};
+        if (typeof args.name === 'string')             body.name = args.name;
+        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.archived === 'boolean')        body.archived = args.archived;
+        result = await api(`/api/affiliate-networks/${Number(args.network_id)}`, { method: 'PATCH', body: JSON.stringify(body) });
+        break;
+      }
+      case 'delete_affiliate_network': {
+        result = await api(`/api/affiliate-networks/${Number(args.network_id)}`, { method: 'DELETE' });
+        break;
+      }
+
+      // ── Tracker: offers ──
+      case 'list_offers': {
+        result = await api('/api/offers');
+        break;
+      }
+      case 'create_offer': {
+        const body = { name: args.name, url: args.url };
+        if ('affiliate_network_id' in args)        body.affiliate_network_id = args.affiliate_network_id;
+        if (typeof args.payout === 'number')       body.payout = args.payout;
+        if (typeof args.payout_currency === 'string') body.payout_currency = args.payout_currency;
+        if (typeof args.country === 'string')      body.country = args.country;
+        result = await api('/api/offers', { method: 'POST', body: JSON.stringify(body) });
+        break;
+      }
+      case 'update_offer': {
+        const body = {};
+        if (typeof args.name === 'string')   body.name = args.name;
+        if (typeof args.url === 'string')    body.url = args.url;
+        if ('affiliate_network_id' in args)  body.affiliate_network_id = args.affiliate_network_id;
+        if (typeof args.payout === 'number') body.payout = args.payout;
+        if (typeof args.payout_currency === 'string') body.payout_currency = args.payout_currency;
+        if (typeof args.country === 'string') body.country = args.country;
+        if (typeof args.archived === 'boolean') body.archived = args.archived;
+        result = await api(`/api/offers/${Number(args.offer_id)}`, { method: 'PATCH', body: JSON.stringify(body) });
+        break;
+      }
+      case 'delete_offer': {
+        result = await api(`/api/offers/${Number(args.offer_id)}`, { method: 'DELETE' });
+        break;
+      }
+
+      // ── Tracker: landers ──
+      case 'list_landers': {
+        result = await api('/api/landers');
+        break;
+      }
+      case 'create_lander': {
+        const body = { name: args.name, url: args.url };
+        if (typeof args.country === 'string') body.country = args.country;
+        result = await api('/api/landers', { method: 'POST', body: JSON.stringify(body) });
+        break;
+      }
+      case 'update_lander': {
+        const body = {};
+        if (typeof args.name === 'string')    body.name = args.name;
+        if (typeof args.url === 'string')     body.url = args.url;
+        if (typeof args.country === 'string') body.country = args.country;
+        if (typeof args.archived === 'boolean') body.archived = args.archived;
+        result = await api(`/api/landers/${Number(args.lander_id)}`, { method: 'PATCH', body: JSON.stringify(body) });
+        break;
+      }
+      case 'delete_lander': {
+        result = await api(`/api/landers/${Number(args.lander_id)}`, { method: 'DELETE' });
+        break;
+      }
+
+      // ── Tracker: campaigns ──
+      case 'list_campaigns': {
+        result = await api('/api/campaigns');
+        break;
+      }
+      case 'create_campaign': {
+        const body = { name: args.name };
+        for (const k of ['traffic_source_label', 'country', 'cost_model', 'transition_mode']) {
+          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 (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;
+        if (Array.isArray(args.lander_weights)) body.lander_weights = args.lander_weights;
+        result = await api('/api/campaigns', { method: 'POST', body: JSON.stringify(body) });
+        break;
+      }
+      case 'get_campaign': {
+        result = await api(`/api/campaigns/${Number(args.campaign_id)}`);
+        break;
+      }
+      case 'update_campaign': {
+        const body = {};
+        for (const k of ['name', 'traffic_source_label', 'country', 'cost_model', 'transition_mode']) {
+          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 (typeof args.archived === 'boolean') body.archived = args.archived;
+        result = await api(`/api/campaigns/${Number(args.campaign_id)}`, { method: 'PATCH', body: JSON.stringify(body) });
+        break;
+      }
+      case 'delete_campaign': {
+        result = await api(`/api/campaigns/${Number(args.campaign_id)}`, { method: 'DELETE' });
+        break;
+      }
+      case 'set_campaign_offers': {
+        result = await api(`/api/campaigns/${Number(args.campaign_id)}/offers`, {
+          method: 'PUT', body: JSON.stringify({ items: args.items }),
+        });
+        break;
+      }
+      case 'set_campaign_landers': {
+        result = await api(`/api/campaigns/${Number(args.campaign_id)}/landers`, {
+          method: 'PUT', body: JSON.stringify({ items: args.items }),
+        });
+        break;
+      }
+      case 'get_campaign_stats': {
+        const days = args?.days ? `?days=${Number(args.days)}` : '';
+        result = await api(`/api/campaigns/${Number(args.campaign_id)}/stats${days}`);
+        break;
+      }
+
+      case 'list_properties': {
+        result = await api('/api/properties');
+        break;
+      }
+      case 'create_property': {
+        const body = { name: args.name };
+        if (typeof args.site_url === 'string') body.site_url = args.site_url;
+        result = await api('/api/properties', { method: 'POST', body: JSON.stringify(body) });
+        break;
+      }
+      case 'get_property': {
+        result = await api(`/api/properties/${Number(args.property_id)}`);
+        break;
+      }
+      case 'update_property': {
+        const body = {};
+        if (typeof args.name === 'string') body.name = args.name;
+        if ('site_url' in args)            body.site_url = args.site_url;
+        if (typeof args.archived === 'boolean') body.archived = args.archived;
+        result = await api(`/api/properties/${Number(args.property_id)}`, { method: 'PATCH', body: JSON.stringify(body) });
+        break;
+      }
+      case 'delete_property': {
+        result = await api(`/api/properties/${Number(args.property_id)}`, { method: 'DELETE' });
+        break;
+      }
+      case 'set_property_campaigns': {
+        result = await api(`/api/properties/${Number(args.property_id)}/campaigns`, {
+          method: 'PUT', body: JSON.stringify({ items: args.items }),
+        });
+        break;
+      }
+      case 'get_property_stats': {
+        const days = args?.days ? `?days=${Number(args.days)}` : '';
+        result = await api(`/api/properties/${Number(args.property_id)}/stats${days}`);
+        break;
+      }
+
       default:
         throw new Error(`unknown tool: ${name}`);
     }