@affset/mcp 0.1.1 → 0.3.0

package/dist/tools/getTrackingLink.js

@@ -1,15 +1,16 @@
 import { z } from "zod";
 import { AffsetApiError } from "../client.js";
 import { mdCell } from "../lib/format.js";
-import { buildTrackingLink, fetchTenantIntegration, subLegend } from "../lib/integrationUrls.js";
-import { collectSubs, linkInputSchema } from "../lib/linkArgs.js";
+import { buildTrackingLink, fetchTenantIntegration, resolveLinkedSource, subLegend, templateHasParam, } from "../lib/integrationUrls.js";
+import { collectSubs, hasExplicitLinkParams, linkInputSchema, } from "../lib/linkArgs.js";
 import { errorResult, textError, textResult } from "../lib/toolResult.js";
 import { resolveZone, zonePostbackNote } from "../lib/zones.js";
 export const GET_TRACKING_LINK_DESCRIPTION = "Get the tracking link for an existing campaign + zone — the /track/click link that goes " +
     "straight to that one campaign with no rotation or targeting checks. Both the campaign " +
     "and zone must be active for the public link to work. Same link create_campaign echoes on " +
     "create; this re-derives it later, for any " +
-    "campaign, with whatever sub values you want. Uses the tenant's custom API domain when " +
+    "campaign, with whatever sub values you want. A zone linked to a traffic source renders " +
+    "that source's tracking template instead. Uses the tenant's custom API domain when " +
     "one is set. Read-only: builds the URL, changes nothing.";
 export const getTrackingLinkInputSchema = {
     campaign_id: z
@@ -45,12 +46,15 @@ export async function getTrackingLink(client, config, args) {
         const { campaign } = campaignResult;
         const { zone, inactiveWarning } = zoneResult;
         const subs = collectSubs(args);
+        const linked = await resolveLinkedSource(client, zone, hasExplicitLinkParams(args));
         const url = buildTrackingLink(integration.baseUrl, campaign.id, zone.id, {
             sourceClickId: args.source_click_id,
             subs,
             cost: args.cost,
             subLabels: integration.subLabels,
+            template: linked.template,
         });
+        const templated = linked.template !== undefined;
         const legend = subLegend(integration.subLabels, subs);
         const statusNote = campaign.status === "active"
             ? "active — serving still depends on dates and budget state; also a /serve candidate"
@@ -67,6 +71,7 @@ export async function getTrackingLink(client, config, args) {
             "",
             "| Field | Value |",
             "|---|---|",
+            ...(linked.sourceLabel ? [`| Traffic source | ${linked.sourceLabel} |`] : []),
             `| Campaign status | ${statusNote} |`,
             `| Offer URL | ${mdCell(campaign.redirect_url ?? "—")} |`,
             `| Zone status | ${zone.status} |`,
@@ -74,13 +79,16 @@ export async function getTrackingLink(client, config, args) {
             ...(legend ? [`| Sub slots | ${legend} |`] : []),
             ...(availabilityWarnings.length ? ["", ...availabilityWarnings] : []),
             ...(inactiveWarning ? ["", inactiveWarning] : []),
+            ...linked.notes.flatMap((note) => ["", note]),
             "",
-            "Replace each `{…}` placeholder with the source's own macro and drop the sub slots " +
-                "you don't need. Values are inserted verbatim — the network expands its macros " +
-                "before the request reaches affset.",
-            args.cost
-                ? "`cost` is recorded on the click row here. Use it on this link **or** on a zone URL for the same traffic, never both."
-                : "Add `cost=<network cost macro>` to import media cost and get ROI in `get_stats`.",
+            templated
+                ? "Query parameters come from the linked source's tracking template — the network " +
+                    "expands its macros before the request reaches affset. Edit them with " +
+                    "`update_traffic_source`; explicit link parameters on this tool override the template."
+                : "Replace each `{…}` placeholder with the source's own macro and drop the sub slots " +
+                    "you don't need. Values are inserted verbatim — the network expands its macros " +
+                    "before the request reaches affset.",
+            costNote(templated, linked.template, args.cost),
             "",
             "_Geo and other targeting rules are enforced in /serve rotation only — this link is " +
                 "not geo-gated. Use `get_zone_url` when you want affset to pick the campaign._",
@@ -90,6 +98,15 @@ export async function getTrackingLink(client, config, args) {
         return errorResult(err);
     }
 }
+function costNote(templated, template, costArg) {
+    const hasCost = templated ? templateHasParam(template, "cost") : Boolean(costArg);
+    if (hasCost) {
+        return "`cost` is recorded on the click row here. Use it on this link **or** on a zone URL for the same traffic, never both.";
+    }
+    return templated
+        ? "Add a `cost=<network cost macro>` parameter to the source's tracking template to import media cost and get ROI in `get_stats`."
+        : "Add `cost=<network cost macro>` to import media cost and get ROI in `get_stats`.";
+}
 function campaignAvailabilityWarnings(campaign) {
     const warnings = [];
     const now = Date.now();

package/dist/tools/getZoneUrl.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { AffsetClient } from "../client.js";
+import type { Config } from "../runtimeConfig.js";
+import { type LinkArgs } from "../lib/linkArgs.js";
+export declare const GET_ZONE_URL_DESCRIPTION: string;
+export declare const getZoneUrlInputSchema: {
+    source_click_id: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    cost: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    sub1: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    sub2: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    sub3: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    sub4: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    sub5: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    zone_id: z.ZodOptional<z.ZodString>;
+};
+type GetZoneUrlArgs = LinkArgs & {
+    zone_id?: string;
+};
+export declare function getZoneUrl(client: AffsetClient, config: Config, args: GetZoneUrlArgs): Promise<CallToolResult>;
+export {};

package/dist/tools/getZoneUrl.js

@@ -1,15 +1,16 @@
 import { z } from "zod";
 import { mdCell } from "../lib/format.js";
-import { buildZoneUrl, fetchTenantIntegration, subLegend } from "../lib/integrationUrls.js";
-import { collectSubs, linkInputSchema } from "../lib/linkArgs.js";
+import { buildZoneUrl, fetchTenantIntegration, resolveLinkedSource, subLegend, templateHasParam, } from "../lib/integrationUrls.js";
+import { collectSubs, hasExplicitLinkParams, linkInputSchema, } from "../lib/linkArgs.js";
 import { errorResult, textError, textResult } from "../lib/toolResult.js";
 import { resolveZone, zonePostbackNote } from "../lib/zones.js";
 export const GET_ZONE_URL_DESCRIPTION = "Get the zone URL to paste into a traffic source's campaign settings — the /serve link " +
-    "that rotates across the zone's active campaigns. Prefilled with the sub convention " +
-    "(source_click_id + sub1..sub5) and optionally the network's cost macro. Uses the " +
-    "tenant's custom API domain when one is set. Read-only: builds the URL, changes nothing. " +
-    "For a link straight to one active campaign without targeting checks, use " +
-    "get_tracking_link instead.";
+    "that rotates across the zone's active campaigns. A zone linked to a traffic source " +
+    "renders that source's tracking template; otherwise the URL is prefilled with the sub " +
+    "convention (source_click_id + sub1..sub5) and optionally the network's cost macro. " +
+    "Uses the tenant's custom API domain when one is set. Read-only: builds the URL, " +
+    "changes nothing. For a link straight to one active campaign without targeting checks, " +
+    "use get_tracking_link instead.";
 export const getZoneUrlInputSchema = {
     zone_id: z
         .string()
@@ -30,16 +31,19 @@ export async function getZoneUrl(client, config, args) {
             return textError(zoneResult.error);
         const { zone, inactiveWarning } = zoneResult;
         const subs = collectSubs(args);
+        const linked = await resolveLinkedSource(client, zone, hasExplicitLinkParams(args));
         const url = buildZoneUrl(integration.baseUrl, zone.id, {
             sourceClickId: args.source_click_id,
             subs,
             cost: args.cost,
             subLabels: integration.subLabels,
+            template: linked.template,
         });
         // A zone URL with nothing to rotate serves the traffic-back / unsold path — the
         // single most common "my link doesn't work" report, so check it up front.
         const rotationNote = await describeRotation(client);
         const legend = subLegend(integration.subLabels, subs);
+        const templated = linked.template !== undefined;
         return textResult([
             `**Zone URL** for **${mdCell(zone.name)}** (\`${zone.id}\`) — give this to the traffic source:`,
             "",
@@ -49,19 +53,23 @@ export async function getZoneUrl(client, config, args) {
             "",
             "| Field | Value |",
             "|---|---|",
+            ...(linked.sourceLabel ? [`| Traffic source | ${linked.sourceLabel} |`] : []),
             `| Zone status | ${zone.status} |`,
             `| Rotation | ${rotationNote} |`,
             `| Postback | ${zonePostbackNote(zone)} |`,
             `| Traffic back | ${mdCell(zone.traffic_back_url ?? "—")} |`,
             ...(legend ? [`| Sub slots | ${legend} |`] : []),
             ...(inactiveWarning ? ["", inactiveWarning] : []),
+            ...linked.notes.flatMap((note) => ["", note]),
             "",
-            "Replace each `{…}` placeholder with the source's own macro and drop the sub slots " +
-                "you don't need. Values are inserted verbatim — the network expands its macros " +
-                "before the request reaches affset.",
-            args.cost
-                ? "`cost` is recorded once per /serve, on the impression row — don't also add it to a tracking link for the same traffic."
-                : "Add `cost=<network cost macro>` to import media cost and get ROI in `get_stats`.",
+            templated
+                ? "Query parameters come from the linked source's tracking template — the network " +
+                    "expands its macros before the request reaches affset. Edit them with " +
+                    "`update_traffic_source`; explicit link parameters on this tool override the template."
+                : "Replace each `{…}` placeholder with the source's own macro and drop the sub slots " +
+                    "you don't need. Values are inserted verbatim — the network expands its macros " +
+                    "before the request reaches affset.",
+            costNote(templated, linked.template, args.cost),
             "",
             "_This URL rotates across the zone's **active** campaigns. For a link that goes " +
                 "straight to one active campaign without applying targeting rules, use `get_tracking_link`._",
@@ -71,6 +79,15 @@ export async function getZoneUrl(client, config, args) {
         return errorResult(err);
     }
 }
+function costNote(templated, template, costArg) {
+    const hasCost = templated ? templateHasParam(template, "cost") : Boolean(costArg);
+    if (hasCost) {
+        return "`cost` is recorded once per /serve, on the impression row — don't also add it to a tracking link for the same traffic.";
+    }
+    return templated
+        ? "Add a `cost=<network cost macro>` parameter to the source's tracking template to import media cost and get ROI in `get_stats`."
+        : "Add `cost=<network cost macro>` to import media cost and get ROI in `get_stats`.";
+}
 /** Cheap active-campaign count; degrades to a neutral note rather than failing. */
 async function describeRotation(client) {
     try {

package/dist/tools/listCampaigns.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { AffsetClient } from "../client.js";
+import { CAMPAIGN_STATUSES } from "../types.js";
+export declare const LIST_CAMPAIGNS_DESCRIPTION: string;
+export declare const listCampaignsInputSchema: {
+    status: z.ZodOptional<z.ZodEnum<["active", "paused", "archived"]>>;
+    name_contains: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    sort: z.ZodDefault<z.ZodEnum<["name", "created_at", "start_date"]>>;
+    order: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+};
+type ListCampaignsArgs = {
+    status?: (typeof CAMPAIGN_STATUSES)[number];
+    name_contains?: string;
+    limit: number;
+    offset: number;
+    sort: "name" | "created_at" | "start_date";
+    order: "asc" | "desc";
+};
+export declare function listCampaigns(client: AffsetClient, args: ListCampaignsArgs): Promise<CallToolResult>;
+export {};

package/dist/tools/listConversions.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { AffsetClient } from "../client.js";
+declare const SORT_FIELDS: readonly ["created_at", "ad_event_id", "click_id"];
+export declare const LIST_CONVERSIONS_DESCRIPTION: string;
+export declare const listConversionsInputSchema: {
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    sort: z.ZodDefault<z.ZodEnum<["created_at", "ad_event_id", "click_id"]>>;
+    order: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+    paid_only: z.ZodOptional<z.ZodBoolean>;
+    click_id: z.ZodOptional<z.ZodString>;
+    source_click_id: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    payload_contains: z.ZodOptional<z.ZodString>;
+    zero_payout: z.ZodOptional<z.ZodBoolean>;
+};
+type ListConversionsArgs = {
+    limit: number;
+    offset: number;
+    sort: (typeof SORT_FIELDS)[number];
+    order: "asc" | "desc";
+    paid_only?: boolean;
+    click_id?: string;
+    source_click_id?: string;
+    type?: string;
+    payload_contains?: string;
+    zero_payout?: boolean;
+};
+export declare function listConversions(client: AffsetClient, args: ListConversionsArgs): Promise<CallToolResult>;
+export {};

package/dist/tools/listConversions.js

@@ -6,14 +6,26 @@ import { SUB_KEYS, } from "../types.js";
 const SORT_FIELDS = ["created_at", "ad_event_id", "click_id"];
 export const LIST_CONVERSIONS_DESCRIPTION = "List recent conversion records (audit trail) for debugging payouts and pixel params. " +
     "Shows payout, spend, pixel `type`, source_click_id, click_id, subs, postback outcome, " +
-    "and the raw payload. API supports pagination/sort only — optional click_id / " +
-    "source_click_id / type / payload_contains / zero_payout filters run client-side on " +
-    "the current page. Does not include campaign_id/zone_id (not returned by the API).";
+    "and the raw payload. `paid_only: true` drops informative conversions server-side — " +
+    "rows recorded with postback_skipped=non_goal_type because the pixel type missed the " +
+    "campaign's payout_goal_type. Silent conversions and other skip reasons still come back " +
+    "(not a payout>0 filter). Default false, all rows. Beyond pagination/sort/paid_only, " +
+    "the optional click_id / source_click_id / type / payload_contains / zero_payout filters " +
+    "run client-side on the current page. Does not include campaign_id/zone_id (not returned " +
+    "by the API).";
 export const listConversionsInputSchema = {
     limit: z.number().int().min(1).max(100).default(20).describe("Page size (1–100). Default 20."),
     offset: z.number().int().min(0).default(0).describe("Pagination offset. Default 0."),
     sort: z.enum(SORT_FIELDS).default("created_at").describe("Sort field. Default created_at."),
     order: z.enum(["asc", "desc"]).default("desc").describe("Sort order. Default desc."),
+    paid_only: z
+        .boolean()
+        .optional()
+        .describe("true drops informative conversions — rows recorded with " +
+        "postback_skipped=non_goal_type because the pixel type missed the campaign's " +
+        "payout_goal_type. Silent conversions and other skip reasons still come back " +
+        "(not a payout>0 filter). Server-side (filters the whole dataset, not just this page). " +
+        "Works without payout visibility. Default false (all rows)."),
     click_id: z
         .string()
         .min(1)
@@ -42,13 +54,17 @@ export const listConversionsInputSchema = {
 };
 export async function listConversions(client, args) {
     try {
+        const query = {
+            limit: args.limit,
+            offset: args.offset,
+            sort: args.sort,
+            order: args.order,
+        };
+        // The API accepts only the literal strings "true"/"false"; omitted = false.
+        if (args.paid_only !== undefined)
+            query.paid_only = String(args.paid_only);
         const [data, settings] = await Promise.all([
-            client.get("/api/conversions", {
-                limit: args.limit,
-                offset: args.offset,
-                sort: args.sort,
-                order: args.order,
-            }),
+            client.get("/api/conversions", query),
             // One read covers both the sub labels and the zone timestamps are shown in.
             client.get("/api/tenant").catch(() => ({})),
         ]);
@@ -67,6 +83,8 @@ export async function listConversions(client, args) {
         const total = pagination?.total ?? all.length;
         const clientFiltered = filtered.length !== all.length;
         const filterBits = [];
+        if (args.paid_only)
+            filterBits.push("paid_only");
         if (args.click_id)
             filterBits.push(`click_id=${args.click_id}`);
         if (args.source_click_id)
@@ -98,7 +116,8 @@ export async function listConversions(client, args) {
                 ]
                 : []),
             "",
-            "_API has no campaign/zone/date filters — page with limit/offset, or filter this page._",
+            "_API has no campaign/zone/date filters. `paid_only` is server-side; other optional " +
+                "filters apply to this page. Page with limit/offset._",
             payoutHidden
                 ? "_`payout` is hidden for this role — the column shows `—` for every row._"
                 : "_`$0` payout with a non-empty type often means payout_goal_type mismatch or no payout rule._",

package/dist/tools/listPayoutRules.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { type AffsetClient } from "../client.js";
+export declare const LIST_PAYOUT_RULES_DESCRIPTION: string;
+export declare const listPayoutRulesInputSchema: {
+    campaign_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+};
+type ListPayoutRulesArgs = {
+    campaign_id: string | number;
+};
+export declare function listPayoutRules(client: AffsetClient, args: ListPayoutRulesArgs): Promise<CallToolResult>;
+export {};

package/dist/tools/listSubLabels.d.ts

@@ -0,0 +1,5 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { AffsetClient } from "../client.js";
+export declare const LIST_SUB_LABELS_DESCRIPTION: string;
+export declare const listSubLabelsInputSchema: {};
+export declare function listSubLabels(client: AffsetClient): Promise<CallToolResult>;

package/dist/tools/listTargetingRules.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { type AffsetClient } from "../client.js";
+export declare const LIST_TARGETING_RULES_DESCRIPTION: string;
+export declare const listTargetingRulesInputSchema: {
+    campaign_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+};
+type ListTargetingRulesArgs = {
+    campaign_id: string | number;
+};
+export declare function listTargetingRules(client: AffsetClient, args: ListTargetingRulesArgs): Promise<CallToolResult>;
+export {};

package/dist/tools/listTargetingTypes.d.ts

@@ -0,0 +1,5 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { AffsetClient } from "../client.js";
+export declare const LIST_TARGETING_TYPES_DESCRIPTION: string;
+export declare const listTargetingTypesInputSchema: {};
+export declare function listTargetingTypes(client: AffsetClient): Promise<CallToolResult>;

package/dist/tools/listTeam.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { AffsetClient } from "../client.js";
+export declare const LIST_TEAM_DESCRIPTION: string;
+export declare const listTeamInputSchema: {
+    role: z.ZodOptional<z.ZodString>;
+    include_expired: z.ZodDefault<z.ZodBoolean>;
+};
+type ListTeamArgs = {
+    role?: string;
+    include_expired: boolean;
+};
+export declare function listTeam(client: AffsetClient, args: ListTeamArgs): Promise<CallToolResult>;
+export {};

package/dist/tools/listTrafficSources.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { AffsetClient } from "../client.js";
+import { TRAFFIC_SOURCE_STATUSES } from "../types.js";
+export declare const LIST_TRAFFIC_SOURCES_DESCRIPTION: string;
+export declare const listTrafficSourcesInputSchema: {
+    status: z.ZodOptional<z.ZodEnum<["active", "archived"]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+};
+type ListTrafficSourcesArgs = {
+    status?: (typeof TRAFFIC_SOURCE_STATUSES)[number];
+    limit: number;
+    offset: number;
+};
+export declare function listTrafficSources(client: AffsetClient, args: ListTrafficSourcesArgs): Promise<CallToolResult>;
+export {};

package/dist/tools/listTrafficSources.js

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { capUntrusted, mdCell } from "../lib/format.js";
+import { errorResult, textResult } from "../lib/toolResult.js";
+import { TRAFFIC_SOURCE_STATUSES } from "../types.js";
+/** Templates run to 2000 chars server-side; the table shows enough to identify one. */
+const TEMPLATE_PREVIEW_MAX = 150;
+export const LIST_TRAFFIC_SOURCES_DESCRIPTION = "List the tenant's traffic sources — the ad networks bought from, each with the " +
+    "tracking template its linked zones render in get_zone_url/get_tracking_link and an " +
+    "optional postback template. The stored network API token is write-only and shown " +
+    "only as set/none. Read-only.";
+export const listTrafficSourcesInputSchema = {
+    status: z
+        .enum(TRAFFIC_SOURCE_STATUSES)
+        .optional()
+        .describe("Filter by status. Omit for all sources."),
+    limit: z.number().int().min(1).max(100).default(50).describe("Sources per page (1–100)."),
+    offset: z.number().int().min(0).default(0).describe("Pagination offset."),
+};
+export async function listTrafficSources(client, args) {
+    try {
+        const query = {
+            limit: args.limit,
+            offset: args.offset,
+            sort: "created_at",
+            order: "desc",
+        };
+        if (args.status)
+            query.status = args.status;
+        const res = await client.get("/api/traffic-sources", query);
+        const sources = res.traffic_sources ?? [];
+        const total = res.pagination?.total ?? sources.length;
+        if (sources.length === 0) {
+            return textResult(args.status
+                ? `No ${args.status} traffic sources.`
+                : "No traffic sources yet. Create one with `create_traffic_source` — start from " +
+                    "a preset to get the network's tracking template ready-made, then link zones " +
+                    "to it via `create_zone`/`update_zone` `traffic_source_id`.");
+        }
+        const rows = sources.map((s) => [
+            `| ${mdCell(s.name)} `,
+            `| \`${mdCell(s.id)}\` `,
+            `| ${s.preset ? mdCell(s.preset) : "—"} `,
+            `| ${mdCell(s.status)} `,
+            `| ${s.has_api_token ? "set" : "—"} `,
+            `| ${s.tracking_template ? mdCell(capUntrusted(s.tracking_template, TEMPLATE_PREVIEW_MAX)) : "—"} `,
+            `| ${s.postback_template ? mdCell(capUntrusted(s.postback_template, TEMPLATE_PREVIEW_MAX)) : "—"} |`,
+        ].join(""));
+        return textResult([
+            `**Traffic sources** (${sources.length} of ${total}):`,
+            "",
+            "| Name | Id | Preset | Status | API token | Tracking template | Postback template |",
+            "|---|---|---|---|---|---|---|",
+            ...rows,
+            "",
+            "_Zones linked to a source render its tracking template in `get_zone_url` / " +
+                "`get_tracking_link`. Edit a source with `update_traffic_source`._",
+        ].join("\n"));
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+}
+//# sourceMappingURL=listTrafficSources.js.map

package/dist/tools/listZones.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { AffsetClient } from "../client.js";
+import { ZONE_STATUSES } from "../types.js";
+export declare const LIST_ZONES_DESCRIPTION: string;
+export declare const listZonesInputSchema: {
+    status: z.ZodOptional<z.ZodEnum<["active", "inactive"]>>;
+    name_contains: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    sort: z.ZodDefault<z.ZodEnum<["name", "created_at", "site_url"]>>;
+    order: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+};
+type ListZonesArgs = {
+    status?: (typeof ZONE_STATUSES)[number];
+    name_contains?: string;
+    limit: number;
+    offset: number;
+    sort: "name" | "created_at" | "site_url";
+    order: "asc" | "desc";
+};
+export declare function listZones(client: AffsetClient, args: ListZonesArgs): Promise<CallToolResult>;
+export {};

package/dist/tools/listZones.js

@@ -3,8 +3,8 @@ import { mdCell } from "../lib/format.js";
 import { errorResult } from "../lib/toolResult.js";
 import { ZONE_STATUSES } from "../types.js";
 export const LIST_ZONES_DESCRIPTION = "List traffic-source zones in the current namespace. Filter by status and optionally " +
-    "by name (client-side contains match). Returns id, name, status, postback_url, " +
-    "site_url, publisher. Paginated (default 20, max 100).";
+    "by name (client-side contains match). Returns id, name, linked traffic source, " +
+    "status, postback_url, site_url, publisher. Paginated (default 20, max 100).";
 export const listZonesInputSchema = {
     status: z.enum(ZONE_STATUSES).optional().describe("Filter by zone status."),
     name_contains: z
@@ -54,11 +54,16 @@ function renderTable(zones) {
     if (zones.length === 0)
         return "_No zones matched._";
     const lines = [
-        "| ID | Name | Status | Postback | Site | Publisher |",
-        "|---|---|---|---|---|---|",
+        "| ID | Name | Source | Status | Postback | Site | Publisher |",
+        "|---|---|---|---|---|---|---|",
     ];
     for (const z of zones) {
-        lines.push(`| \`${z.id}\` | ${mdCell(z.name)} | ${z.status} | ${z.postback_url ? mdCell(shortUrl(z.postback_url)) : "⚠️ none"} | ${mdCell(shortUrl(z.site_url))} | ${mdCell(z.user_email ?? "—")} |`);
+        const source = z.traffic_source_name
+            ? mdCell(z.traffic_source_name)
+            : z.traffic_source_id
+                ? `\`${mdCell(z.traffic_source_id)}\``
+                : "—";
+        lines.push(`| \`${z.id}\` | ${mdCell(z.name)} | ${source} | ${z.status} | ${z.postback_url ? mdCell(shortUrl(z.postback_url)) : "⚠️ none"} | ${mdCell(shortUrl(z.site_url))} | ${mdCell(z.user_email ?? "—")} |`);
     }
     return lines.join("\n");
 }

package/dist/tools/removeTargetingRule.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { type AffsetClient } from "../client.js";
+import { type TargetingMethod } from "../lib/targeting.js";
+export declare const REMOVE_TARGETING_RULE_DESCRIPTION: string;
+export declare const removeTargetingRuleInputSchema: {
+    campaign_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    rule_id: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    method: z.ZodOptional<z.ZodEnum<["whitelist", "blacklist"]>>;
+    confirm: z.ZodDefault<z.ZodBoolean>;
+};
+type RemoveTargetingRuleArgs = {
+    campaign_id: string | number;
+    rule_id?: number;
+    type?: string | number;
+    method?: TargetingMethod;
+    confirm: boolean;
+};
+export declare function removeTargetingRule(client: AffsetClient, args: RemoveTargetingRuleArgs): Promise<CallToolResult>;
+export {};

package/dist/tools/setCampaignStatus.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { AffsetClient } from "../client.js";
+/** Media-buyer verbs → API status. */
+export declare const CAMPAIGN_ACTIONS: readonly ["run", "pause"];
+export declare const SET_CAMPAIGN_STATUS_DESCRIPTION: string;
+export declare const setCampaignStatusInputSchema: {
+    campaign_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    action: z.ZodEnum<["run", "pause"]>;
+    confirm: z.ZodDefault<z.ZodBoolean>;
+};
+type SetCampaignStatusArgs = {
+    campaign_id: string | number;
+    action: (typeof CAMPAIGN_ACTIONS)[number];
+    confirm: boolean;
+};
+export declare function setCampaignStatus(client: AffsetClient, args: SetCampaignStatusArgs): Promise<CallToolResult>;
+export {};

package/dist/tools/setPayoutGoal.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { type AffsetClient } from "../client.js";
+export declare const SET_PAYOUT_GOAL_DESCRIPTION: string;
+export declare const setPayoutGoalInputSchema: {
+    campaign_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    goal_type: z.ZodUnion<[z.ZodString, z.ZodNull]>;
+    confirm: z.ZodDefault<z.ZodBoolean>;
+};
+type SetPayoutGoalArgs = {
+    campaign_id: string | number;
+    goal_type: string | null;
+    confirm: boolean;
+};
+export declare function setPayoutGoal(client: AffsetClient, args: SetPayoutGoalArgs): Promise<CallToolResult>;
+export {};

package/dist/tools/setPayoutRule.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { type AffsetClient } from "../client.js";
+export declare const SET_PAYOUT_RULE_DESCRIPTION: string;
+export declare const setPayoutRuleInputSchema: {
+    campaign_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    payout: z.ZodNumber;
+    zone_id: z.ZodOptional<z.ZodString>;
+    confirm: z.ZodDefault<z.ZodBoolean>;
+};
+type SetPayoutRuleArgs = {
+    campaign_id: string | number;
+    payout: number;
+    zone_id?: string;
+    confirm: boolean;
+};
+export declare function setPayoutRule(client: AffsetClient, args: SetPayoutRuleArgs): Promise<CallToolResult>;
+export {};

package/dist/tools/setSubLabels.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { AffsetClient } from "../client.js";
+export declare const SET_SUB_LABELS_DESCRIPTION: string;
+export declare const setSubLabelsInputSchema: {
+    sub1: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    sub2: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    sub3: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    sub4: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    sub5: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    confirm: z.ZodDefault<z.ZodBoolean>;
+};
+type SetSubLabelsArgs = {
+    sub1?: string | null;
+    sub2?: string | null;
+    sub3?: string | null;
+    sub4?: string | null;
+    sub5?: string | null;
+    confirm: boolean;
+};
+export declare function setSubLabels(client: AffsetClient, args: SetSubLabelsArgs): Promise<CallToolResult>;
+export {};