@cliangdev/conductor 0.52.0 → 0.53.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/assets/claude/skills/conductor-marketing-report/SKILL.md +5 -4
- package/assets/claude/skills/conductor-marketing-report/references/html-layout.md +2 -1
- package/assets/cli-manifest.json +257 -19
- package/dist/mcp/index.d.ts +10979 -187
- package/dist/mcp/index.d.ts.map +1 -1
- package/dist/mcp/index.js +570 -4
- package/dist/mcp/index.js.map +1 -1
- package/dist/mcp/tools/ai-visibility.d.ts +18 -0
- package/dist/mcp/tools/ai-visibility.d.ts.map +1 -0
- package/dist/mcp/tools/ai-visibility.js +124 -0
- package/dist/mcp/tools/ai-visibility.js.map +1 -0
- package/dist/mcp/tools/budget.d.ts +35 -0
- package/dist/mcp/tools/budget.d.ts.map +1 -0
- package/dist/mcp/tools/budget.js +205 -0
- package/dist/mcp/tools/budget.js.map +1 -0
- package/dist/mcp/tools/creators.d.ts +15 -0
- package/dist/mcp/tools/creators.d.ts.map +1 -0
- package/dist/mcp/tools/creators.js +69 -0
- package/dist/mcp/tools/creators.js.map +1 -0
- package/dist/mcp/tools/growth-signals.d.ts +38 -0
- package/dist/mcp/tools/growth-signals.d.ts.map +1 -0
- package/dist/mcp/tools/growth-signals.js +135 -0
- package/dist/mcp/tools/growth-signals.js.map +1 -0
- package/dist/mcp/tools/insights.d.ts +9 -0
- package/dist/mcp/tools/insights.d.ts.map +1 -1
- package/dist/mcp/tools/insights.js +12 -3
- package/dist/mcp/tools/insights.js.map +1 -1
- package/dist/mcp/tools/links.d.ts +26 -0
- package/dist/mcp/tools/links.d.ts.map +1 -0
- package/dist/mcp/tools/links.js +92 -0
- package/dist/mcp/tools/links.js.map +1 -0
- package/dist/mcp/tools/marketing-changes.d.ts +25 -0
- package/dist/mcp/tools/marketing-changes.d.ts.map +1 -0
- package/dist/mcp/tools/marketing-changes.js +108 -0
- package/dist/mcp/tools/marketing-changes.js.map +1 -0
- package/dist/mcp/tools/marketing-definitions.d.ts +11 -0
- package/dist/mcp/tools/marketing-definitions.d.ts.map +1 -0
- package/dist/mcp/tools/marketing-definitions.js +37 -0
- package/dist/mcp/tools/marketing-definitions.js.map +1 -0
- package/dist/mcp/tools/marketing-report.d.ts +7 -0
- package/dist/mcp/tools/marketing-report.d.ts.map +1 -1
- package/dist/mcp/tools/marketing-report.js +43 -5
- package/dist/mcp/tools/marketing-report.js.map +1 -1
- package/dist/mcp/tools/posts.d.ts.map +1 -1
- package/dist/mcp/tools/posts.js +16 -0
- package/dist/mcp/tools/posts.js.map +1 -1
- package/dist/mcp/tools/promises.d.ts +39 -0
- package/dist/mcp/tools/promises.d.ts.map +1 -0
- package/dist/mcp/tools/promises.js +98 -0
- package/dist/mcp/tools/promises.js.map +1 -0
- package/dist/mcp/tools/proposals.d.ts +26 -0
- package/dist/mcp/tools/proposals.d.ts.map +1 -0
- package/dist/mcp/tools/proposals.js +102 -0
- package/dist/mcp/tools/proposals.js.map +1 -0
- package/dist/mcp/tools/switchback.d.ts +36 -0
- package/dist/mcp/tools/switchback.d.ts.map +1 -0
- package/dist/mcp/tools/switchback.js +123 -0
- package/dist/mcp/tools/switchback.js.map +1 -0
- package/dist/mcp/tools/verification.d.ts +24 -0
- package/dist/mcp/tools/verification.d.ts.map +1 -0
- package/dist/mcp/tools/verification.js +124 -0
- package/dist/mcp/tools/verification.js.map +1 -0
- package/package.json +1 -1
package/dist/mcp/index.js
CHANGED
|
@@ -17,7 +17,18 @@ import { submitKnowledgeSource, readKnowledgeSources, searchKnowledge, readKnowl
|
|
|
17
17
|
import { listPublishTargets, setPublishTargets, uploadAsset, retryFailedPublishTargets, completeManualPublish, requestTikTokConsent, } from './tools/marketing.js';
|
|
18
18
|
import { createPost, getPostStatus, submitPost, listPosts, submitReview, listAssets, getPostAnalytics, listTopPosts, } from './tools/posts.js';
|
|
19
19
|
import { getMarketingInsights } from './tools/insights.js';
|
|
20
|
+
import { getBudgetPacing, setMarketingBudget, setStopRule, removeStopRule } from './tools/budget.js';
|
|
21
|
+
import { getMarketingDefinitions } from './tools/marketing-definitions.js';
|
|
20
22
|
import { getMarketingReport, setMarketingBenchmark, deleteMarketingBenchmark } from './tools/marketing-report.js';
|
|
23
|
+
import { getVerificationLedger, recordPlatformRead } from './tools/verification.js';
|
|
24
|
+
import { proposeMarketingChange, installWeeklyGrowthWorkflow } from './tools/proposals.js';
|
|
25
|
+
import { getGrowthSignals, setMarketingMoment, linkMomentChange, addCompetitor, removeCompetitor, setTrackedKeywords, } from './tools/growth-signals.js';
|
|
26
|
+
import { getAiVisibility, setAiQuestions, runAiVisibilityCheck } from './tools/ai-visibility.js';
|
|
27
|
+
import { createSwitchbackTest, startSwitchbackTest, getSwitchbackTest, listSwitchbackTests } from './tools/switchback.js';
|
|
28
|
+
import { importMarketingChanges } from './tools/marketing-changes.js';
|
|
29
|
+
import { getCreatorResults } from './tools/creators.js';
|
|
30
|
+
import { createTrackedLink, listTrackedLinks } from './tools/links.js';
|
|
31
|
+
import { tagMessage, untagMessage, listPromises } from './tools/promises.js';
|
|
21
32
|
import { getBrandKit, updateBrandKit, createBrandKit, uploadBrandImage, listCreatives, listCreativeMedia, getCreative, createCreative, updateCreative, uploadCreativeMediaAny, uploadCreativePhoto, renderCreativeTool, previewCreative, attachCreativeToPost, createExperiment, } from './tools/creatives.js';
|
|
22
33
|
import { previewCreativeDraft, commitCreativeDraft, } from './tools/creative-drafts.js';
|
|
23
34
|
import { closeOcr } from '../lib/safe-zone/ocr.js';
|
|
@@ -1271,7 +1282,7 @@ export const TOOLS = [
|
|
|
1271
1282
|
},
|
|
1272
1283
|
{
|
|
1273
1284
|
name: 'get_marketing_insights',
|
|
1274
|
-
description: 'What is working in marketing. Default include ["posts"]: published Posts only (totals, engagement rate by platform, format and time, best and worst posts, top Creatives, movers vs the prior window). Add "channels" for "how is marketing doing overall / per channel": per-channel status (LIVE, STALE, NOT_CONNECTED, COMING_SOON, MISMATCH), the acquisition funnel (every stage and `window` share one window ending at the earliest complete day of the channels that feed the funnel, so conversions compare the same days; each channel\'s own metrics keep that channel\'s window), and per metric value, previous, changePct, noise (true = within normal variation, do not call it a trend) and target. Channels are WEB, SEARCH, SOCIAL, ADS, STORE, PRODUCT (the in-app numbers a connected product backend reports: `stages` in funnel order from first open to paid, plus metrics such as cost per trial; the funnel continues into them after store downloads). A metric with `provisional` has newest days that may still change; `smallSample` means too few users or events to call a change real. A metric with a target carries `status` (ON_TRACK
|
|
1285
|
+
description: 'What is working in marketing. Default include ["posts"]: published Posts only (totals, engagement rate by platform, format and time, best and worst posts, top Creatives, movers vs the prior window). Add "channels" for "how is marketing doing overall / per channel": per-channel status (LIVE, STALE, NOT_CONNECTED, COMING_SOON, MISMATCH; `noDataYet` = connected but no complete day of data yet), the acquisition funnel (every stage and `window` share one window ending at the earliest complete day of the channels that feed the funnel, so conversions compare the same days; each channel\'s own metrics keep that channel\'s window), and per metric value, previous, changePct, noise (true = within normal variation, do not call it a trend) and target. Channels are WEB, SEARCH, SOCIAL, ADS, STORE, PRODUCT (the in-app numbers a connected product backend reports: `stages` in funnel order from first open to paid, plus metrics such as cost per trial; the funnel continues into them after store downloads). A metric with `provisional` has newest days that may still change; `smallSample` means too few users or events to call a change real. A metric with a target carries `status` (ON_TRACK = met; WATCH = close, or a rate miss too small a sample to call real; OFF_TRACK = missed by more; TOO_EARLY = no value, or a rate on fewer than 20 observations; STOPPED = a snapshot the feed stopped sending, so it is not judged; `note` says when it was last reported) and `missPct`, the shortfall as a fraction of the target (a count or money total is judged against the target prorated to the window). `basis` COHORT means each day counts the people who first opened that day, followed to now; `funnelBasis` says the in-app funnel is counted that way. A target with `readOnly` is set by the product backend (`setIn` says where) and cannot be changed here. A MISMATCH channel carries `mismatch`: the Conductor figure vs the product backend reference over the same settled days; treat the connector number as the one to trust until the gap is explained. Numbers are platform-reported and cover complete days only (see dataCompleteThrough), so they can differ from a platform UI that shows today. Pass `channel` with "channels" to also get that channel\'s series (weekly buckets: sums for counts and money, means for rates and positions; provisional = may still change) and its top 10 rows per breakdown (referrers, queries, campaigns, platforms, App Store traffic sources). Windows: 7d, 30d, 90d. For channels, 30d is read as the 28-day window, and 90d is valid only with `channel`. Read-only. Use get_post_analytics for one Post\'s series and list_top_posts for a full ranking by one metric.',
|
|
1275
1286
|
inputSchema: {
|
|
1276
1287
|
type: 'object',
|
|
1277
1288
|
properties: {
|
|
@@ -1282,19 +1293,79 @@ export const TOOLS = [
|
|
|
1282
1293
|
},
|
|
1283
1294
|
},
|
|
1284
1295
|
},
|
|
1296
|
+
{
|
|
1297
|
+
name: 'get_budget_pacing',
|
|
1298
|
+
description: 'Paid spend against the month\'s budget cap, per paid channel (any channel with a spend metric; Apple Ads is one). Returns the cap (null when none is set: then there is no pace), settled month-to-date spend (provisionalSpend is kept apart and never counted), pacePct against a straight-line expectation (1.0 = on pace), projected month-end spend, the last 7 days, and per channel: compliance (spend with no active stop rule is non-compliant), each stop rule with its observed value and state (TRIPPED, BELOW_MIN_SAMPLE, NO_DATA, OK), and marginal cost per install (last 7 settled days vs the prior 7 vs month-to-date; cpiNote "no installs" when a window has none). Read-only. Conductor only proposes and records: a tripped rule is a prompt for a human to change the bid or budget in the ad platform (or Rexipe\'s gated tool). Set the cap with set_marketing_budget and rules with set_stop_rule.',
|
|
1299
|
+
inputSchema: {
|
|
1300
|
+
type: 'object',
|
|
1301
|
+
properties: {
|
|
1302
|
+
month: { type: 'string', description: 'YYYY-MM, UTC (default: the current month)' },
|
|
1303
|
+
},
|
|
1304
|
+
},
|
|
1305
|
+
},
|
|
1306
|
+
{
|
|
1307
|
+
name: 'set_marketing_budget',
|
|
1308
|
+
description: 'Set or replace the paid budget cap for a month (idempotent per month). capAmount must be above 0; to have no cap, set none. Spend is summed as the ad platform reports it, so give the cap in that account\'s currency. Records the cap only; it does not change any ad platform. Requires the Editor role (or Admin). Verify with get_budget_pacing.',
|
|
1309
|
+
inputSchema: {
|
|
1310
|
+
type: 'object',
|
|
1311
|
+
properties: {
|
|
1312
|
+
month: { type: 'string', description: 'YYYY-MM, UTC' },
|
|
1313
|
+
capAmount: { type: 'number', description: 'The month\'s cap, above 0' },
|
|
1314
|
+
currency: { type: 'string', description: 'Three-letter code (default USD)' },
|
|
1315
|
+
},
|
|
1316
|
+
required: ['month', 'capAmount'],
|
|
1317
|
+
},
|
|
1318
|
+
},
|
|
1319
|
+
{
|
|
1320
|
+
name: 'set_stop_rule',
|
|
1321
|
+
description: 'Add a stop rule for a paid channel: it trips when `metric` is above (GT) or below (LT) `threshold` over the last `windowDays` settled days, once the window holds at least `minSample` taps. A rule below its minSample never trips, so set one for any rate or cost per install. A paid channel with spend needs at least one active rule or get_budget_pacing flags it non-compliant. Rates are fractions (0.05 = 5%). scope narrows it to one campaign or keyword by id. Conductor only evaluates and records: a tripped rule is a prompt for a human to change the bid or budget in the ad platform (or Rexipe\'s gated tool), never an action taken here. Requires the Editor role (or Admin). Verify with get_budget_pacing; remove with remove_stop_rule.',
|
|
1322
|
+
inputSchema: {
|
|
1323
|
+
type: 'object',
|
|
1324
|
+
properties: {
|
|
1325
|
+
channel: { type: 'string', description: 'The channel, e.g. ADS' },
|
|
1326
|
+
metric: { type: 'string', enum: ['cost_per_install', 'spend', 'installs', 'taps', 'tap_through_rate', 'install_rate'], description: 'What to watch. tap_through_rate = taps / impressions; install_rate = installs / taps' },
|
|
1327
|
+
comparator: { type: 'string', enum: ['GT', 'LT'], description: 'GT trips above the threshold, LT below' },
|
|
1328
|
+
threshold: { type: 'number', description: 'In the metric\'s own unit, 0 or more' },
|
|
1329
|
+
minSample: { type: 'number', description: 'Taps the window must hold before the rule can trip (default 0 = none)' },
|
|
1330
|
+
windowDays: { type: 'number', description: 'Settled days to read, 1 to 90 (default 7)' },
|
|
1331
|
+
scope: { type: 'string', description: 'channel (default), campaign:<id> or keyword:<id>' },
|
|
1332
|
+
note: { type: 'string', description: 'What a human should consider when it trips (optional)' },
|
|
1333
|
+
},
|
|
1334
|
+
required: ['channel', 'metric', 'comparator', 'threshold'],
|
|
1335
|
+
},
|
|
1336
|
+
},
|
|
1337
|
+
{
|
|
1338
|
+
name: 'remove_stop_rule',
|
|
1339
|
+
description: 'Remove a stop rule by id (it stays on record but stops being evaluated). Removing the last active rule of a paid channel makes it non-compliant again. Requires the Editor role (or Admin). Find ruleId in get_budget_pacing (channels[].rules); verify there afterwards.',
|
|
1340
|
+
inputSchema: {
|
|
1341
|
+
type: 'object',
|
|
1342
|
+
properties: { ruleId: { type: 'string', description: 'The rule id from get_budget_pacing or set_stop_rule' } },
|
|
1343
|
+
required: ['ruleId'],
|
|
1344
|
+
},
|
|
1345
|
+
},
|
|
1346
|
+
{
|
|
1347
|
+
name: 'get_marketing_definitions',
|
|
1348
|
+
description: 'What each marketing metric counts: per metric (metricRef CHANNEL.key) its source report or field, numerator and denominator, source type (ALL or one App Store traffic source), what it excludes and the time zone of its days. Check it before comparing a metric with a benchmark or another source: two figures compare only when numerator, denominator and source type match. Read-only. Use get_marketing_report or get_marketing_insights for the numbers.',
|
|
1349
|
+
inputSchema: {
|
|
1350
|
+
type: 'object',
|
|
1351
|
+
properties: {
|
|
1352
|
+
channel: { type: 'string', enum: ['WEB', 'SEARCH', 'SOCIAL', 'ADS', 'STORE', 'PRODUCT'], description: 'Only this channel\'s metrics (default all)' },
|
|
1353
|
+
},
|
|
1354
|
+
},
|
|
1355
|
+
},
|
|
1285
1356
|
{
|
|
1286
1357
|
name: 'get_marketing_report',
|
|
1287
|
-
description: 'The whole-funnel marketing report in one payload: sources, headline, acquisition, funnel, scorecard, keywords, ads, benchmarks and
|
|
1358
|
+
description: 'The whole-funnel marketing report in one payload: sources, headline, acquisition (organic search net of Apple Ads over the same settled days, see derivation), funnel, store downloads of record, scorecard, keywords (with cost per activated install, week-2 retained install and trial), payback (cohort proceeds over spend per paid channel, 12-month horizon), exclusions (likely App Review installs), asoKeywords (organic rank and popularity, best 20), email, shares and link_family acquisition rows, a verification tally, adsCoverage, ads, benchmarks (judged only against a metric with the same definition), changes with changeMarkers, and definitions for every metric. A figure the source did not send is absent or null, never 0. Percent values are fractions. Read-only. Use get_marketing_insights for per-Post performance; set_marketing_benchmark to record an industry benchmark.',
|
|
1288
1359
|
inputSchema: {
|
|
1289
1360
|
type: 'object',
|
|
1290
1361
|
properties: {
|
|
1291
|
-
window: { type: 'string',
|
|
1362
|
+
window: { type: 'string', description: 'Report window: "7d", "28d" (default) or a fixed range "YYYY-MM-DD..YYYY-MM-DD" (at most 92 days, ending yesterday or earlier), e.g. to check a past window against platform numbers' },
|
|
1292
1363
|
},
|
|
1293
1364
|
},
|
|
1294
1365
|
},
|
|
1295
1366
|
{
|
|
1296
1367
|
name: 'set_marketing_benchmark',
|
|
1297
|
-
description: 'Record or replace the industry benchmark for one metric. The value must come from a source you read in this session, never from memory: sourceUrl (the page) and checkedOn (the day you read it) are required. metricRef is CHANNEL.metric (e.g. STORE.conversion_rate) or PRODUCT.<key>. A count or currency total (downloads, spend) is stated per 28 days and prorated to the report window; a rate or ratio is compared as stated. Requires the Editor role (or Admin). Verify with get_marketing_report (benchmarks).',
|
|
1368
|
+
description: 'Record or replace the industry benchmark for one metric. The value must come from a source you read in this session, never from memory: sourceUrl (the page) and checkedOn (the day you read it) are required. metricRef is CHANNEL.metric (e.g. STORE.conversion_rate) or PRODUCT.<key>. A count or currency total (downloads, spend) is stated per 28 days and prorated to the report window; a rate or ratio is compared as stated. Say what it measures with numerator, denominator and sourceType: a benchmark is judged only against a metric with the same definition, and one without them shows as "definition missing". Each call replaces the whole benchmark, so repeat the definition when you update the value. Requires the Editor role (or Admin). Verify with get_marketing_report (benchmarks).',
|
|
1298
1369
|
inputSchema: {
|
|
1299
1370
|
type: 'object',
|
|
1300
1371
|
properties: {
|
|
@@ -1307,6 +1378,9 @@ export const TOOLS = [
|
|
|
1307
1378
|
sourceUrl: { type: 'string', description: 'http(s) URL of the page you read' },
|
|
1308
1379
|
checkedOn: { type: 'string', description: 'YYYY-MM-DD, the day you read the source (not in the future)' },
|
|
1309
1380
|
notes: { type: 'string', description: 'Caveats (optional)' },
|
|
1381
|
+
numerator: { type: 'string', description: 'What the benchmark counts (optional): impressions, unique_impressions, page_views, unique_page_views, first_time_downloads, redownloads, total_downloads, downloads_of_record, tap_installs, tap_new_downloads, view_through_installs, taps, spend, visitors, sessions, pageviews, conversion_sessions, conversion_events, clicks, followers, posts, likes, channel_views, website_clicks, rating_count, rating_avg, position, or product:<key> for an in-app metric. AppFollow example: total_downloads' },
|
|
1382
|
+
denominator: { type: 'string', description: 'What the numerator is divided by (optional; same names as numerator; omit for a count; needs numerator). AppFollow example: unique_impressions' },
|
|
1383
|
+
sourceType: { type: 'string', description: 'The traffic source it covers (optional; needs numerator): ALL (default), APP_STORE_SEARCH, APP_STORE_BROWSE, APP_REFERRER, WEB_REFERRER, APP_CLIP, INSTITUTIONAL_PURCHASE or OTHER. AppFollow example: APP_STORE_SEARCH' },
|
|
1310
1384
|
},
|
|
1311
1385
|
required: ['metricRef', 'value', 'sourceName', 'sourceUrl', 'checkedOn'],
|
|
1312
1386
|
},
|
|
@@ -1320,6 +1394,318 @@ export const TOOLS = [
|
|
|
1320
1394
|
required: ['metricRef'],
|
|
1321
1395
|
},
|
|
1322
1396
|
},
|
|
1397
|
+
{
|
|
1398
|
+
name: 'get_verification_ledger',
|
|
1399
|
+
description: 'Which marketing numbers to trust: per metric (CHANNEL.key) Conductor\'s value, the product backend\'s value over the settled days both have, the latest direct platform read and a verdict. BOTH: every second source agrees. CONNECTOR: trust the connector (a read agrees with it, or only the backend disagrees). BACKEND: backend and read agree, the connector does not. PLATFORM: the read disagrees with every other source. UNCHECKED: no second source, never verified. `mismatch` means a second source disagrees; `stale` means the read is over 7 days old; `over` is set when a row covers other days than the window. Cite a number only when its verdict is not UNCHECKED and it has no mismatch. Read-only. Use record_platform_read to log a direct read.',
|
|
1400
|
+
inputSchema: {
|
|
1401
|
+
type: 'object',
|
|
1402
|
+
properties: {
|
|
1403
|
+
window: { type: 'string', description: '7d, 28d (default), 90d, or a range of whole days YYYY-MM-DD..YYYY-MM-DD ending yesterday or earlier (at most 92 days)' },
|
|
1404
|
+
channel: { type: 'string', enum: ['WEB', 'SEARCH', 'SOCIAL', 'ADS', 'STORE', 'PRODUCT'], description: 'Only this channel\'s rows (default all)' },
|
|
1405
|
+
onlyProblems: { type: 'boolean', description: 'Only rows that are UNCHECKED, have a mismatch or have a stale read (default false)' },
|
|
1406
|
+
},
|
|
1407
|
+
},
|
|
1408
|
+
},
|
|
1409
|
+
{
|
|
1410
|
+
name: 'record_platform_read',
|
|
1411
|
+
description: 'Log a direct read: what the platform\'s own UI or API shows for one metric over an exact day range. Look at the platform for that range; never copy Conductor\'s number. from and to are whole days, to yesterday or earlier, at most 92 days apart (a level such as followers is read on `to`; unique visitors need a range of 7, 28 or 90 days). Append-only: a newer read supersedes this one, nothing is edited or deleted. Returns the metric\'s row with its verdict. Requires the Editor role (or Admin). Always call get_verification_ledger after to verify.',
|
|
1412
|
+
inputSchema: {
|
|
1413
|
+
type: 'object',
|
|
1414
|
+
properties: {
|
|
1415
|
+
channel: { type: 'string', enum: ['WEB', 'SEARCH', 'SOCIAL', 'ADS', 'STORE', 'PRODUCT'], description: 'The channel the metric belongs to' },
|
|
1416
|
+
metric: { type: 'string', description: 'Metric key within the channel, e.g. installs (ADS), clicks (SEARCH), downloads (STORE); a sum, a level or visitors, not a ratio' },
|
|
1417
|
+
from: { type: 'string', description: 'First day the platform figure covers, YYYY-MM-DD' },
|
|
1418
|
+
to: { type: 'string', description: 'Last day the platform figure covers, YYYY-MM-DD (yesterday or earlier)' },
|
|
1419
|
+
value: { type: 'number', description: 'The platform\'s figure for those days (zero or more)' },
|
|
1420
|
+
sourceName: { type: 'string', description: 'Where you read it, e.g. Apple Ads console or Search Console UI' },
|
|
1421
|
+
note: { type: 'string', description: 'Caveats, e.g. the filter or time zone the platform used (optional)' },
|
|
1422
|
+
},
|
|
1423
|
+
required: ['channel', 'metric', 'from', 'to', 'value', 'sourceName'],
|
|
1424
|
+
},
|
|
1425
|
+
},
|
|
1426
|
+
{
|
|
1427
|
+
name: 'propose_marketing_change',
|
|
1428
|
+
description: 'Propose one marketing change, backed by exactly two signals on two different metrics, as a PLANNED change with a review date. It refuses a signal whose metric get_verification_ledger does not verify (UNCHECKED, a MISMATCH or no row; it names the metric and verdict), a value that is not the ledger\'s figure for that window, and more than 3 a week per workspace (ISO week, UTC). A human approves every change: it stays PLANNED and moving it to LIVE is a human step this tool cannot take. It changes nothing on an ad platform. Requires the Editor role (or Admin). Verify with get_work_item (workItemId) or get_marketing_report (changes).',
|
|
1429
|
+
inputSchema: {
|
|
1430
|
+
type: 'object',
|
|
1431
|
+
properties: {
|
|
1432
|
+
title: { type: 'string', description: 'Short name of the change (at most 255 characters)' },
|
|
1433
|
+
type: { type: 'string', description: 'A type of the workspace\'s MARKETING_CHANGES workflow (LISTING, ADS, PRICING, PRODUCT, CONTENT, BASELINE or OTHER by default)' },
|
|
1434
|
+
hypothesis: { type: 'string', description: 'What to change and what you expect it to do' },
|
|
1435
|
+
reviewOn: { type: 'string', description: 'YYYY-MM-DD, the day to review the result; after today' },
|
|
1436
|
+
signals: {
|
|
1437
|
+
type: 'array',
|
|
1438
|
+
minItems: 2,
|
|
1439
|
+
maxItems: 2,
|
|
1440
|
+
description: 'The evidence: two figures on two different metrics, each verified by the ledger for its window',
|
|
1441
|
+
items: {
|
|
1442
|
+
type: 'object',
|
|
1443
|
+
properties: {
|
|
1444
|
+
metricRef: { type: 'string', description: 'CHANNEL.metric as in get_verification_ledger, e.g. ADS.installs' },
|
|
1445
|
+
window: { type: 'string', description: '7d, 28d, 90d or YYYY-MM-DD..YYYY-MM-DD: the window the figure is for' },
|
|
1446
|
+
value: { type: 'number', description: 'The ledger\'s figure for that metric over that window' },
|
|
1447
|
+
note: { type: 'string', description: 'What the figure shows (optional)' },
|
|
1448
|
+
},
|
|
1449
|
+
required: ['metricRef', 'window', 'value'],
|
|
1450
|
+
},
|
|
1451
|
+
},
|
|
1452
|
+
runId: { type: 'string', description: 'The workflow run making the proposal (optional)' },
|
|
1453
|
+
},
|
|
1454
|
+
required: ['title', 'type', 'hypothesis', 'reviewOn', 'signals'],
|
|
1455
|
+
},
|
|
1456
|
+
},
|
|
1457
|
+
{
|
|
1458
|
+
name: 'install_weekly_growth_workflow',
|
|
1459
|
+
description: 'Install the "Weekly growth review" workflow from Conductor\'s template: every Monday 07:30 UTC a Claude Code step reads the report, the verification ledger and the budget, and proposes at most 3 changes with propose_marketing_change. It is created disabled, so nothing runs until a person enables it, and its Claude Code step needs a runtime target. Safe to repeat: an existing workflow with that name is returned unchanged. Requires the Admin role. Verify with get_workflow (workflowId).',
|
|
1460
|
+
inputSchema: { type: 'object', properties: {} },
|
|
1461
|
+
},
|
|
1462
|
+
{
|
|
1463
|
+
name: 'get_growth_signals',
|
|
1464
|
+
description: 'Growth signals from public data: seasonal moments with their surfaces and overdue warnings, the weekly ratings program (our app and each competitor: latest and previous snapshot, weeklyGrowth = rating-count change, null until two snapshots), recent reviews, what changed on competitor listings, and App Store keyword positions. Read-only. Change the inputs with set_marketing_moment, link_moment_change, add_competitor, remove_competitor and set_tracked_keywords.',
|
|
1465
|
+
inputSchema: { type: 'object', properties: {} },
|
|
1466
|
+
},
|
|
1467
|
+
{
|
|
1468
|
+
name: 'set_marketing_moment',
|
|
1469
|
+
description: 'Record or replace a dated moment (for example Thanksgiving, 2026-11-26) and the surfaces that must change for it, each with a due date. A surface past its due date with no linked change shows a warning. surfaces is the whole list: a surface kept by name keeps its linked change, one left out is removed. Requires the Editor role (or Admin). Verify with get_growth_signals (moments).',
|
|
1470
|
+
inputSchema: {
|
|
1471
|
+
type: 'object',
|
|
1472
|
+
properties: {
|
|
1473
|
+
key: { type: 'string', description: 'Stable id: lower-case letters, digits, hyphens, underscores (e.g. thanksgiving-2026)' },
|
|
1474
|
+
name: { type: 'string', description: 'Display name' },
|
|
1475
|
+
date: { type: 'string', description: 'YYYY-MM-DD, the day of the moment' },
|
|
1476
|
+
leadDays: { type: 'integer', description: 'Days ahead the moment counts as upcoming (default 21)' },
|
|
1477
|
+
surfaces: {
|
|
1478
|
+
type: 'array',
|
|
1479
|
+
description: 'Where a change is needed and by when',
|
|
1480
|
+
items: {
|
|
1481
|
+
type: 'object',
|
|
1482
|
+
properties: {
|
|
1483
|
+
surface: { type: 'string', description: 'e.g. App Store promotional text, TikTok post, Email' },
|
|
1484
|
+
dueOn: { type: 'string', description: 'YYYY-MM-DD, the day the change must be recorded by' },
|
|
1485
|
+
},
|
|
1486
|
+
required: ['surface', 'dueOn'],
|
|
1487
|
+
},
|
|
1488
|
+
},
|
|
1489
|
+
},
|
|
1490
|
+
required: ['key', 'name', 'date', 'surfaces'],
|
|
1491
|
+
},
|
|
1492
|
+
},
|
|
1493
|
+
{
|
|
1494
|
+
name: 'link_moment_change',
|
|
1495
|
+
description: 'Record the marketing change (a MARKETING_CHANGES Work Item of this project) that handled a moment surface, which clears its warning. A Work Item of another project or workflow is refused. Requires the Editor role (or Admin). Verify with get_growth_signals (moments).',
|
|
1496
|
+
inputSchema: {
|
|
1497
|
+
type: 'object',
|
|
1498
|
+
properties: {
|
|
1499
|
+
key: { type: 'string', description: 'The moment key' },
|
|
1500
|
+
surfaceId: { type: 'string', description: 'The surface id from get_growth_signals' },
|
|
1501
|
+
workItemId: { type: 'string', description: 'The change Work Item: its id or display id (e.g. RE-12)' },
|
|
1502
|
+
},
|
|
1503
|
+
required: ['key', 'surfaceId', 'workItemId'],
|
|
1504
|
+
},
|
|
1505
|
+
},
|
|
1506
|
+
{
|
|
1507
|
+
name: 'add_competitor',
|
|
1508
|
+
description: 'Watch a competitor app: each week its public App Store listing, rating count, reviews and keyword positions are recorded. Idempotent per appId (re-adding updates the name and country). Requires the Editor role (or Admin). Verify with get_growth_signals (ratings.competitors); data appears after the next weekly run.',
|
|
1509
|
+
inputSchema: {
|
|
1510
|
+
type: 'object',
|
|
1511
|
+
properties: {
|
|
1512
|
+
appId: { type: 'string', description: 'Numeric App Store id, digits only' },
|
|
1513
|
+
name: { type: 'string', description: 'Display name' },
|
|
1514
|
+
country: { type: 'string', description: 'Two-letter App Store country (default: our app\'s)' },
|
|
1515
|
+
},
|
|
1516
|
+
required: ['appId', 'name'],
|
|
1517
|
+
},
|
|
1518
|
+
},
|
|
1519
|
+
{
|
|
1520
|
+
name: 'remove_competitor',
|
|
1521
|
+
description: 'Stop watching a competitor app (idempotent); its stored history is kept. Requires the Editor role (or Admin). Verify with get_growth_signals (ratings.competitors).',
|
|
1522
|
+
inputSchema: {
|
|
1523
|
+
type: 'object',
|
|
1524
|
+
properties: { appId: { type: 'string', description: 'Numeric App Store id' } },
|
|
1525
|
+
required: ['appId'],
|
|
1526
|
+
},
|
|
1527
|
+
},
|
|
1528
|
+
{
|
|
1529
|
+
name: 'set_tracked_keywords',
|
|
1530
|
+
description: 'Replace the App Store keywords whose search position is recorded weekly for our app and each competitor (at most 25; an empty list clears it). Used only while the product feed has no aso:<keyword> rows; otherwise those keywords are tracked. Requires the Editor role (or Admin). Verify with get_growth_signals (trackedKeywords, keywordPresence).',
|
|
1531
|
+
inputSchema: {
|
|
1532
|
+
type: 'object',
|
|
1533
|
+
properties: {
|
|
1534
|
+
keywords: { type: 'array', items: { type: 'string' }, description: 'The full list of keywords' },
|
|
1535
|
+
country: { type: 'string', description: 'Two-letter App Store country to search in (default: our app\'s)' },
|
|
1536
|
+
},
|
|
1537
|
+
required: ['keywords'],
|
|
1538
|
+
},
|
|
1539
|
+
},
|
|
1540
|
+
{
|
|
1541
|
+
name: 'get_ai_visibility',
|
|
1542
|
+
description: 'Whether AI assistants name the brand when asked a fixed set of questions, checked weekly: per question and assistant the latest answer (named or not, list rank, excerpt) and a weekly trend. An assistant the workspace has no provider key for is listed under skipped and has no readings; it is never shown as not named. Read-only. Change the questions with set_ai_questions.',
|
|
1543
|
+
inputSchema: {
|
|
1544
|
+
type: 'object',
|
|
1545
|
+
properties: {
|
|
1546
|
+
weeks: { type: 'integer', description: 'ISO weeks back to read, 1-52 (default 8)' },
|
|
1547
|
+
},
|
|
1548
|
+
},
|
|
1549
|
+
},
|
|
1550
|
+
{
|
|
1551
|
+
name: 'set_ai_questions',
|
|
1552
|
+
description: 'Replace the questions put to the AI assistants each week (at most 20; an empty list switches all off; dropped questions keep their history), and optionally the brand terms that count as naming the brand (default: the workspace name; an empty list goes back to it). Requires the Editor role (or Admin). Verify with get_ai_visibility.',
|
|
1553
|
+
inputSchema: {
|
|
1554
|
+
type: 'object',
|
|
1555
|
+
properties: {
|
|
1556
|
+
questions: { type: 'array', items: { type: 'string' }, description: 'The full list of questions, e.g. "best app to save recipes from TikTok"' },
|
|
1557
|
+
brandTerms: { type: 'array', items: { type: 'string' }, description: 'Words that count as naming the brand, whole word in any case with an optional plural s (omit to leave unchanged)' },
|
|
1558
|
+
},
|
|
1559
|
+
required: ['questions'],
|
|
1560
|
+
},
|
|
1561
|
+
},
|
|
1562
|
+
{
|
|
1563
|
+
name: 'run_ai_visibility_check',
|
|
1564
|
+
description: 'Run this week\'s AI-assistant checks now instead of waiting for Monday. Spends the workspace\'s own AI provider keys (at most 20 calls a week) and needs the Admin role. Safe to repeat: a question and assistant already read this week is not asked again. Returns what was recorded, skipped (no credential, weekly limit) and failed. Call get_ai_visibility after to read the results.',
|
|
1565
|
+
inputSchema: { type: 'object', properties: {} },
|
|
1566
|
+
},
|
|
1567
|
+
{
|
|
1568
|
+
name: 'create_switchback_test',
|
|
1569
|
+
description: 'Declare a weekly on/off test of one Apple Ads keyword to see whether paid adds installs or only relabels organic ones. Give weeks, or startWeek (a Monday) with weekCount (2-12, alternating, first week ON). The rule and minimum n are fixed up front (defaults: total installs up by at least 1 a week, organic down by at most 20%, 20 search downloads). Creates a draft; call start_switchback_test to freeze it. A person switches the keyword in the ad platform or through Rexipe\'s gated tool; Conductor never does. Requires the Editor role (or Admin). Verify with get_switchback_test.',
|
|
1570
|
+
inputSchema: {
|
|
1571
|
+
type: 'object',
|
|
1572
|
+
properties: {
|
|
1573
|
+
name: { type: 'string', description: 'A label for the test' },
|
|
1574
|
+
keywordId: { type: 'string', description: 'The Apple Ads keyword id' },
|
|
1575
|
+
keywordText: { type: 'string', description: 'The keyword text' },
|
|
1576
|
+
weeks: {
|
|
1577
|
+
type: 'array',
|
|
1578
|
+
items: {
|
|
1579
|
+
type: 'object',
|
|
1580
|
+
properties: {
|
|
1581
|
+
weekStart: { type: 'string', description: 'A Monday, yyyy-MM-dd (UTC)' },
|
|
1582
|
+
on: { type: 'boolean', description: 'true = keyword on that week, false = off' },
|
|
1583
|
+
},
|
|
1584
|
+
required: ['weekStart', 'on'],
|
|
1585
|
+
},
|
|
1586
|
+
description: 'Consecutive Mondays with at least one on and one off week (omit when using startWeek and weekCount)',
|
|
1587
|
+
},
|
|
1588
|
+
startWeek: { type: 'string', description: 'First Monday, yyyy-MM-dd; use with weekCount instead of weeks' },
|
|
1589
|
+
weekCount: { type: 'integer', description: 'How many weeks, 2-12; used with startWeek' },
|
|
1590
|
+
minN: { type: 'integer', description: 'Fewest first-time search downloads across all weeks a verdict may rest on (default 20)' },
|
|
1591
|
+
minLift: { type: 'number', description: 'Extra total first-time installs a week paid must add (default 1)' },
|
|
1592
|
+
maxCannibalisationPct: { type: 'number', description: 'Most the on-week organic mean may fall, in percent (default 20)' },
|
|
1593
|
+
},
|
|
1594
|
+
required: ['name', 'keywordId', 'keywordText'],
|
|
1595
|
+
},
|
|
1596
|
+
},
|
|
1597
|
+
{
|
|
1598
|
+
name: 'start_switchback_test',
|
|
1599
|
+
description: 'Start a drafted switchback test: from now its weeks and rule cannot change (edits are refused). The first week must not have begun. The test then settles itself once its last week has ended and the daily data is settled, recording the verdict as a reviewed change; no polling needed. Requires the Editor role (or Admin). Verify with get_switchback_test, which also says which state the keyword should be in this week.',
|
|
1600
|
+
inputSchema: {
|
|
1601
|
+
type: 'object',
|
|
1602
|
+
properties: { id: { type: 'string', description: 'The test id' } },
|
|
1603
|
+
required: ['id'],
|
|
1604
|
+
},
|
|
1605
|
+
},
|
|
1606
|
+
{
|
|
1607
|
+
name: 'get_switchback_test',
|
|
1608
|
+
description: 'One switchback test: its plan, the rule, which state (ON, OFF or not running) the keyword should be in this week, what it is waiting for when its last week has ended but data is not settled, and once settled the verdict, per-week figures, n reached and the change Work Item that records it. Read-only.',
|
|
1609
|
+
inputSchema: {
|
|
1610
|
+
type: 'object',
|
|
1611
|
+
properties: { id: { type: 'string', description: 'The test id' } },
|
|
1612
|
+
required: ['id'],
|
|
1613
|
+
},
|
|
1614
|
+
},
|
|
1615
|
+
{
|
|
1616
|
+
name: 'list_switchback_tests',
|
|
1617
|
+
description: 'The workspace\'s switchback tests, newest first, with status, this week\'s state and any verdict. Read-only. Read one with get_switchback_test.',
|
|
1618
|
+
inputSchema: { type: 'object', properties: {} },
|
|
1619
|
+
},
|
|
1620
|
+
{
|
|
1621
|
+
name: 'import_marketing_changes',
|
|
1622
|
+
description: 'Import a marketing change log from a local JSONL file (one record per line: id, date, type, title, status, changed, evidence[], hypothesis, baseline, control, live_since, review_on, outcome, verdict, lesson, stop_rules, stop_rules_note) as Changes on the MARKETING_CHANGES workflow, each in the status its record has. Reference records are skipped; an unknown status or verdict refuses that record and names it, never guessed. A bad line stops everything before anything is sent. Safe to run again: a record already imported (same source and id) is left alone. Requires the Editor role (or Admin). Verify with get_marketing_report (changes).',
|
|
1623
|
+
inputSchema: {
|
|
1624
|
+
type: 'object',
|
|
1625
|
+
properties: {
|
|
1626
|
+
filePath: { type: 'string', description: 'Absolute path to the .jsonl file on this machine' },
|
|
1627
|
+
source: { type: 'string', description: 'Names the log the records come from (default "rexipe"); a record id is unique within its source' },
|
|
1628
|
+
},
|
|
1629
|
+
required: ['filePath'],
|
|
1630
|
+
},
|
|
1631
|
+
},
|
|
1632
|
+
{
|
|
1633
|
+
name: 'get_creator_results',
|
|
1634
|
+
description: 'What one creator (a Work Item on the CREATORS workflow) has produced: its posts with views, the downloads of its campaign links, and the redemptions of its offer code over a window of settled days (default the 28 days ending yesterday). An unknown figure is null with a note (Apple omits links under its reporting threshold; the product backend may not send redemptions), never 0. Read-only. Fill in the creator\'s fields with update_work_item.',
|
|
1635
|
+
inputSchema: {
|
|
1636
|
+
type: 'object',
|
|
1637
|
+
properties: {
|
|
1638
|
+
creatorId: { type: 'string', description: 'The creator Work Item: its id or display id (e.g. RE-12)' },
|
|
1639
|
+
from: { type: 'string', description: 'First day, YYYY-MM-DD (default 27 days before to)' },
|
|
1640
|
+
to: { type: 'string', description: 'Last day, YYYY-MM-DD, yesterday or earlier (default yesterday); at most 92 days from from' },
|
|
1641
|
+
},
|
|
1642
|
+
required: ['creatorId'],
|
|
1643
|
+
},
|
|
1644
|
+
},
|
|
1645
|
+
{
|
|
1646
|
+
name: 'create_tracked_link',
|
|
1647
|
+
description: 'Create an App Store campaign link (pt/ct) for a bio, creator, email or any other place, and return its url. Every new Post already gets one automatically, so use this for the rest. token is the ct (lowercase letters, digits, dashes, at most 40); family groups tokens so their downloads add up past Apple\'s reporting threshold (about 5 per token). One kind per family. Needs an App Store Connect connection with its provider token set. Requires the Editor role (or Admin). Verify with list_tracked_links.',
|
|
1648
|
+
inputSchema: {
|
|
1649
|
+
type: 'object',
|
|
1650
|
+
properties: {
|
|
1651
|
+
kind: { type: 'string', enum: ['POST', 'BIO', 'CREATOR', 'EMAIL', 'OTHER'], description: 'What the link is for. POST needs workItemId' },
|
|
1652
|
+
family: { type: 'string', description: 'The group the token rolls up into, e.g. creators (lowercase letters, digits, dashes, at most 64)' },
|
|
1653
|
+
token: { type: 'string', description: 'The campaign token (ct)' },
|
|
1654
|
+
label: { type: 'string', description: 'What the link is for, at most 200 characters (optional)' },
|
|
1655
|
+
workItemId: { type: 'string', description: 'The Work Item it belongs to, e.g. the creator (optional; required for POST)' },
|
|
1656
|
+
},
|
|
1657
|
+
required: ['kind', 'family', 'token'],
|
|
1658
|
+
},
|
|
1659
|
+
},
|
|
1660
|
+
{
|
|
1661
|
+
name: 'list_tracked_links',
|
|
1662
|
+
description: 'List tracked App Store links, newest first, with their urls. withPerformance adds per family: tokens, first-time downloads over the last 28 settled days and, for Post links, views. A family Apple reported nothing for has downloads null and belowThreshold true ("below Apple\'s reporting threshold"), which is not 0. Read-only. Create more with create_tracked_link; a Post\'s own link is also in get_post_status.',
|
|
1663
|
+
inputSchema: {
|
|
1664
|
+
type: 'object',
|
|
1665
|
+
properties: {
|
|
1666
|
+
kind: { type: 'string', enum: ['POST', 'BIO', 'CREATOR', 'EMAIL', 'OTHER'], description: 'Only this kind (optional)' },
|
|
1667
|
+
workItemId: { type: 'string', description: 'Only the links of this Work Item (optional)' },
|
|
1668
|
+
withPerformance: { type: 'boolean', description: 'Add downloads and views per family (default false)' },
|
|
1669
|
+
},
|
|
1670
|
+
},
|
|
1671
|
+
},
|
|
1672
|
+
{
|
|
1673
|
+
name: 'tag_message',
|
|
1674
|
+
description: 'Tag a target with the message it makes (a short tag such as save-from-tiktok): an Apple Ads keyword, a custom product page, a Post, a creative or a paywall headline. list_promises then joins the message to installs, intent picks, trial rate and D7. A target carries one message: tagging it again moves it and replaces its label. targetRef is the keyword id, product page id, Post id or creative id, or the headline text for a paywall headline. Requires the Editor role (or Admin). Verify with list_promises.',
|
|
1675
|
+
inputSchema: {
|
|
1676
|
+
type: 'object',
|
|
1677
|
+
properties: {
|
|
1678
|
+
message: { type: 'string', description: 'The message, at most 120 characters (stored lower-case). Match the product feed\'s message:<tag> value to see outcomes' },
|
|
1679
|
+
targetKind: { type: 'string', enum: ['CREATIVE', 'PRODUCT_PAGE', 'KEYWORD', 'PAYWALL_HEADLINE', 'POST'], description: 'What is being tagged' },
|
|
1680
|
+
targetRef: { type: 'string', description: 'The target\'s id, or the headline text for PAYWALL_HEADLINE' },
|
|
1681
|
+
label: { type: 'string', description: 'A human name for the target, at most 200 characters (optional)' },
|
|
1682
|
+
},
|
|
1683
|
+
required: ['message', 'targetKind', 'targetRef'],
|
|
1684
|
+
},
|
|
1685
|
+
},
|
|
1686
|
+
{
|
|
1687
|
+
name: 'untag_message',
|
|
1688
|
+
description: 'Remove the message from a target. Safe to repeat: untagging a target with no tag changes nothing. Requires the Editor role (or Admin). Verify with list_promises.',
|
|
1689
|
+
inputSchema: {
|
|
1690
|
+
type: 'object',
|
|
1691
|
+
properties: {
|
|
1692
|
+
targetKind: { type: 'string', enum: ['CREATIVE', 'PRODUCT_PAGE', 'KEYWORD', 'PAYWALL_HEADLINE', 'POST'], description: 'What was tagged' },
|
|
1693
|
+
targetRef: { type: 'string', description: 'The id (or headline text) the tag was made with' },
|
|
1694
|
+
},
|
|
1695
|
+
required: ['targetKind', 'targetRef'],
|
|
1696
|
+
},
|
|
1697
|
+
},
|
|
1698
|
+
{
|
|
1699
|
+
name: 'list_promises',
|
|
1700
|
+
description: 'The promise ledger: per message, the tagged targets by kind, installs (Apple Ads tap installs of tagged keywords and product pages plus first-time downloads of tagged Posts\' links), intent mix, trial rate and D7, each rate with its 95% range and n, flagged "small sample" under n=20. A figure with no data is null, never 0. Default window: the last 28 settled days. Read-only. Tag targets with tag_message.',
|
|
1701
|
+
inputSchema: {
|
|
1702
|
+
type: 'object',
|
|
1703
|
+
properties: {
|
|
1704
|
+
from: { type: 'string', description: 'First day, YYYY-MM-DD (default 27 days before to)' },
|
|
1705
|
+
to: { type: 'string', description: 'Last day, YYYY-MM-DD (default the latest settled day)' },
|
|
1706
|
+
},
|
|
1707
|
+
},
|
|
1708
|
+
},
|
|
1323
1709
|
{
|
|
1324
1710
|
name: 'submit_review',
|
|
1325
1711
|
description: 'Record a review verdict on a Post as this API key\'s user, who must be an assigned member holding the Reviewer role (or an Admin). Approving on a reviewed Workflow schedules it in the same call. TikTok consent is a human step the person does in their own browser (request_tiktok_consent hands them the link), not this tool. Returns the confirmation table.',
|
|
@@ -2423,6 +2809,34 @@ export async function runMcpServer() {
|
|
|
2423
2809
|
channel: params['channel'],
|
|
2424
2810
|
}));
|
|
2425
2811
|
}
|
|
2812
|
+
case 'get_budget_pacing': {
|
|
2813
|
+
return successResponse(await getBudgetPacing(config, { month: params['month'] }));
|
|
2814
|
+
}
|
|
2815
|
+
case 'set_marketing_budget': {
|
|
2816
|
+
return successResponse(await setMarketingBudget(config, {
|
|
2817
|
+
month: params['month'],
|
|
2818
|
+
capAmount: params['capAmount'],
|
|
2819
|
+
currency: params['currency'],
|
|
2820
|
+
}));
|
|
2821
|
+
}
|
|
2822
|
+
case 'set_stop_rule': {
|
|
2823
|
+
return successResponse(await setStopRule(config, {
|
|
2824
|
+
channel: params['channel'],
|
|
2825
|
+
metric: params['metric'],
|
|
2826
|
+
comparator: params['comparator'],
|
|
2827
|
+
threshold: params['threshold'],
|
|
2828
|
+
minSample: params['minSample'],
|
|
2829
|
+
windowDays: params['windowDays'],
|
|
2830
|
+
scope: params['scope'],
|
|
2831
|
+
note: params['note'],
|
|
2832
|
+
}));
|
|
2833
|
+
}
|
|
2834
|
+
case 'remove_stop_rule': {
|
|
2835
|
+
return successResponse(await removeStopRule(config, { ruleId: params['ruleId'] }));
|
|
2836
|
+
}
|
|
2837
|
+
case 'get_marketing_definitions': {
|
|
2838
|
+
return successResponse(await getMarketingDefinitions(config, { channel: params['channel'] }));
|
|
2839
|
+
}
|
|
2426
2840
|
case 'get_marketing_report': {
|
|
2427
2841
|
return successResponse(await getMarketingReport(config, { window: params['window'] }));
|
|
2428
2842
|
}
|
|
@@ -2437,11 +2851,163 @@ export async function runMcpServer() {
|
|
|
2437
2851
|
sourceUrl: params['sourceUrl'],
|
|
2438
2852
|
checkedOn: params['checkedOn'],
|
|
2439
2853
|
notes: params['notes'],
|
|
2854
|
+
numerator: params['numerator'],
|
|
2855
|
+
denominator: params['denominator'],
|
|
2856
|
+
sourceType: params['sourceType'],
|
|
2440
2857
|
}));
|
|
2441
2858
|
}
|
|
2442
2859
|
case 'delete_marketing_benchmark': {
|
|
2443
2860
|
return successResponse(await deleteMarketingBenchmark(config, { metricRef: params['metricRef'] }));
|
|
2444
2861
|
}
|
|
2862
|
+
case 'get_verification_ledger': {
|
|
2863
|
+
return successResponse(await getVerificationLedger(config, {
|
|
2864
|
+
window: params['window'],
|
|
2865
|
+
channel: params['channel'],
|
|
2866
|
+
onlyProblems: params['onlyProblems'],
|
|
2867
|
+
}));
|
|
2868
|
+
}
|
|
2869
|
+
case 'record_platform_read': {
|
|
2870
|
+
return successResponse(await recordPlatformRead(config, {
|
|
2871
|
+
channel: params['channel'],
|
|
2872
|
+
metric: params['metric'],
|
|
2873
|
+
from: params['from'],
|
|
2874
|
+
to: params['to'],
|
|
2875
|
+
value: params['value'],
|
|
2876
|
+
sourceName: params['sourceName'],
|
|
2877
|
+
note: params['note'],
|
|
2878
|
+
}));
|
|
2879
|
+
}
|
|
2880
|
+
case 'propose_marketing_change': {
|
|
2881
|
+
return successResponse(await proposeMarketingChange(config, {
|
|
2882
|
+
title: params['title'],
|
|
2883
|
+
type: params['type'],
|
|
2884
|
+
hypothesis: params['hypothesis'],
|
|
2885
|
+
reviewOn: params['reviewOn'],
|
|
2886
|
+
signals: params['signals'],
|
|
2887
|
+
runId: params['runId'],
|
|
2888
|
+
}));
|
|
2889
|
+
}
|
|
2890
|
+
case 'install_weekly_growth_workflow': {
|
|
2891
|
+
return successResponse(await installWeeklyGrowthWorkflow(config));
|
|
2892
|
+
}
|
|
2893
|
+
case 'get_growth_signals': {
|
|
2894
|
+
return successResponse(await getGrowthSignals(config));
|
|
2895
|
+
}
|
|
2896
|
+
case 'set_marketing_moment': {
|
|
2897
|
+
return successResponse(await setMarketingMoment(config, {
|
|
2898
|
+
key: params['key'],
|
|
2899
|
+
name: params['name'],
|
|
2900
|
+
date: params['date'],
|
|
2901
|
+
leadDays: params['leadDays'],
|
|
2902
|
+
surfaces: params['surfaces'],
|
|
2903
|
+
}));
|
|
2904
|
+
}
|
|
2905
|
+
case 'link_moment_change': {
|
|
2906
|
+
return successResponse(await linkMomentChange(config, {
|
|
2907
|
+
key: params['key'],
|
|
2908
|
+
surfaceId: params['surfaceId'],
|
|
2909
|
+
workItemId: params['workItemId'],
|
|
2910
|
+
}));
|
|
2911
|
+
}
|
|
2912
|
+
case 'add_competitor': {
|
|
2913
|
+
return successResponse(await addCompetitor(config, {
|
|
2914
|
+
appId: params['appId'],
|
|
2915
|
+
name: params['name'],
|
|
2916
|
+
country: params['country'],
|
|
2917
|
+
}));
|
|
2918
|
+
}
|
|
2919
|
+
case 'remove_competitor': {
|
|
2920
|
+
return successResponse(await removeCompetitor(config, { appId: params['appId'] }));
|
|
2921
|
+
}
|
|
2922
|
+
case 'set_tracked_keywords': {
|
|
2923
|
+
return successResponse(await setTrackedKeywords(config, {
|
|
2924
|
+
keywords: params['keywords'],
|
|
2925
|
+
country: params['country'],
|
|
2926
|
+
}));
|
|
2927
|
+
}
|
|
2928
|
+
case 'get_ai_visibility': {
|
|
2929
|
+
return successResponse(await getAiVisibility(config, { weeks: params['weeks'] }));
|
|
2930
|
+
}
|
|
2931
|
+
case 'set_ai_questions': {
|
|
2932
|
+
return successResponse(await setAiQuestions(config, {
|
|
2933
|
+
questions: params['questions'],
|
|
2934
|
+
brandTerms: params['brandTerms'],
|
|
2935
|
+
}));
|
|
2936
|
+
}
|
|
2937
|
+
case 'run_ai_visibility_check': {
|
|
2938
|
+
return successResponse(await runAiVisibilityCheck(config));
|
|
2939
|
+
}
|
|
2940
|
+
case 'create_switchback_test': {
|
|
2941
|
+
return successResponse(await createSwitchbackTest(config, {
|
|
2942
|
+
name: params['name'],
|
|
2943
|
+
keywordId: params['keywordId'],
|
|
2944
|
+
keywordText: params['keywordText'],
|
|
2945
|
+
weeks: params['weeks'],
|
|
2946
|
+
startWeek: params['startWeek'],
|
|
2947
|
+
weekCount: params['weekCount'],
|
|
2948
|
+
minN: params['minN'],
|
|
2949
|
+
minLift: params['minLift'],
|
|
2950
|
+
maxCannibalisationPct: params['maxCannibalisationPct'],
|
|
2951
|
+
}));
|
|
2952
|
+
}
|
|
2953
|
+
case 'start_switchback_test': {
|
|
2954
|
+
return successResponse(await startSwitchbackTest(config, { id: params['id'] }));
|
|
2955
|
+
}
|
|
2956
|
+
case 'get_switchback_test': {
|
|
2957
|
+
return successResponse(await getSwitchbackTest(config, { id: params['id'] }));
|
|
2958
|
+
}
|
|
2959
|
+
case 'list_switchback_tests': {
|
|
2960
|
+
return successResponse(await listSwitchbackTests(config));
|
|
2961
|
+
}
|
|
2962
|
+
case 'import_marketing_changes': {
|
|
2963
|
+
return successResponse(await importMarketingChanges(config, {
|
|
2964
|
+
filePath: params['filePath'],
|
|
2965
|
+
source: params['source'],
|
|
2966
|
+
}));
|
|
2967
|
+
}
|
|
2968
|
+
case 'get_creator_results': {
|
|
2969
|
+
return successResponse(await getCreatorResults(config, {
|
|
2970
|
+
creatorId: params['creatorId'],
|
|
2971
|
+
from: params['from'],
|
|
2972
|
+
to: params['to'],
|
|
2973
|
+
}));
|
|
2974
|
+
}
|
|
2975
|
+
case 'create_tracked_link': {
|
|
2976
|
+
return successResponse(await createTrackedLink(config, {
|
|
2977
|
+
kind: params['kind'],
|
|
2978
|
+
family: params['family'],
|
|
2979
|
+
token: params['token'],
|
|
2980
|
+
label: params['label'],
|
|
2981
|
+
workItemId: params['workItemId'],
|
|
2982
|
+
}));
|
|
2983
|
+
}
|
|
2984
|
+
case 'list_tracked_links': {
|
|
2985
|
+
return successResponse(await listTrackedLinks(config, {
|
|
2986
|
+
kind: params['kind'],
|
|
2987
|
+
workItemId: params['workItemId'],
|
|
2988
|
+
withPerformance: params['withPerformance'],
|
|
2989
|
+
}));
|
|
2990
|
+
}
|
|
2991
|
+
case 'tag_message': {
|
|
2992
|
+
return successResponse(await tagMessage(config, {
|
|
2993
|
+
message: params['message'],
|
|
2994
|
+
targetKind: params['targetKind'],
|
|
2995
|
+
targetRef: params['targetRef'],
|
|
2996
|
+
label: params['label'],
|
|
2997
|
+
}));
|
|
2998
|
+
}
|
|
2999
|
+
case 'untag_message': {
|
|
3000
|
+
return successResponse(await untagMessage(config, {
|
|
3001
|
+
targetKind: params['targetKind'],
|
|
3002
|
+
targetRef: params['targetRef'],
|
|
3003
|
+
}));
|
|
3004
|
+
}
|
|
3005
|
+
case 'list_promises': {
|
|
3006
|
+
return successResponse(await listPromises(config, {
|
|
3007
|
+
from: params['from'],
|
|
3008
|
+
to: params['to'],
|
|
3009
|
+
}));
|
|
3010
|
+
}
|
|
2445
3011
|
case 'get_post_analytics': {
|
|
2446
3012
|
return successResponse(await getPostAnalytics({ postId: params['postId'], since: params['since'] }, config));
|
|
2447
3013
|
}
|