@cite42/mcp 0.3.0 → 0.5.0

package/README.md

@@ -6,7 +6,7 @@ Once connected, Claude Code, Claude Desktop, Codex CLI, or Cursor can:
 
 - **Query AI models** (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) and see each model's answer and the sources it cites
 - **Track brand visibility** in AI answers: rankings, head-to-head comparisons, and sentiment
-- **Schedule daily or weekly trackers**: one measurement — rankings, comparisons, citations, or sentiment — over a list of prompts, with email when something changes, then ask your agent for stored run history
+- **Schedule weekly or monthly trackers**: one measurement — rankings, comparisons, citations, or sentiment — over a list of prompts, with setup confirmation and a useful email after every run, then ask your agent for stored history
 - **Pull SEO data**: keyword search volume, CPC, competition, and Google Trends
 - **Mine Reddit and YouTube** for audience questions, pain points, and rising content
 - **Run full research workflows**: content gaps, topic demand, AI prompt maps, competitor analysis, and content briefs in a single call
@@ -128,7 +128,7 @@ That is the three default surfaces; ask for `fullSweep` to add Claude and Google
 
 ## Tools
 
-Cite42 exposes 26 MCP tools: 3 free account tools, 9 primitive data tools, 6 research workflows, and 8 tracker tools.
+Cite42 exposes 26 MCP tools: 3 free account tools, 9 data tools, 6 research workflows, and 8 tracker tools.
 
 ### Account & pricing (free)
 
@@ -162,12 +162,12 @@ Cite42 exposes 26 MCP tools: 3 free account tools, 9 primitive data tools, 6 res
 
 ### Trackers
 
-- `cite42_tracker_create`: create a draft daily or weekly tracker — one measurement applied to a list of prompts. No prompt list yet? Run `cite42_map_ai_prompts` first. Creating a draft is free and does not schedule calls.
+- `cite42_tracker_create`: create a draft weekly or monthly tracker — one measurement applied to a list of prompts. No prompt list yet? Run `cite42_map_ai_prompts` first. Creating a draft is free and does not schedule calls.
 - `cite42_tracker_update`: replace the whole tracker definition — name, cadence, measurement, prompts and configuration. A tracker read returns the same shape, so read it, change what you need, and send it back. Updating is free.
-- `cite42_tracker_activate`: activate or resume recurring runs. You must pass the exact `estimatedCostMicroPerRun` from the latest tracker record as `maxCostMicroPerRun`; activation authorizes billed scheduled runs until the tracker is paused. The response carries the balance, the cost per run and `runsDryAt` — the date the balance stops covering your active trackers — and activation is refused when the balance cannot cover even the next run.
+- `cite42_tracker_activate`: activate or resume recurring runs. You must pass the exact `estimatedCostMicroPerRun` from the latest tracker record as `maxCostMicroPerRun`; activation authorizes billed scheduled runs until the tracker is paused. The response carries the balance, the cost per run and `runsDryAt` — the date the balance stops covering your active trackers — and activation is refused when the balance cannot cover even the next run. When tracker emails are on, activation also sends a setup summary.
 - `cite42_tracker_pause`: stop future scheduled runs while preserving configuration and history. Pausing is free.
 - `cite42_tracker_delete`: permanently delete a draft or paused tracker and its run history. Active trackers must be paused first, and deletion is rejected while a run is queued or running. Financial usage records remain available.
-- `cite42_tracker_run`: queue one manual run of every saved prompt. Each prompt is billed as its own primitive call at the normal rate.
+- `cite42_tracker_run`: queue one manual run of every saved prompt. Each prompt is billed as its own tool call at the normal rate, and completion sends the same current-results email as a scheduled run—even for a baseline or an unchanged result.
 - `cite42_trackers`: list trackers, schedules, statuses, cost estimates, and last/next run times. Reading the list is free.
 - `cite42_tracker_report`: read bounded stored run history with results, changes, status, sampled time, and costs (latest 8 by default, up to 20). Reading stored reports is free.
 
@@ -184,7 +184,7 @@ npx -y @cite42/mcp --api-key=cite42_live_your_key_here --api-base=https://www.ci
 
 ## Billing
 
-Primitive and workflow calls consume Cite42 credits from your account. Tracker management and stored-history reads are free; every scheduled or manual tracker run bills one call per saved prompt at the normal rate. Activating or resuming a tracker requires explicit confirmation of the current maximum credits per run and authorizes recurring billed calls until you pause it. Calls fail with a clear error if the API key is missing or credits run out. See [www.cite42.dev/pricing](https://www.cite42.dev/pricing).
+Tool and workflow calls consume Cite42 credits from your account. Tracker management and stored-history reads are free; every scheduled or manual tracker run bills one call per saved prompt at the normal rate. Activating or resuming a tracker requires explicit confirmation of the current maximum credits per run and authorizes recurring billed calls until you pause it. Calls fail with a clear error if the API key is missing or credits run out. See [www.cite42.dev/pricing](https://www.cite42.dev/pricing).
 
 ## Troubleshooting
 

package/dist/stdio.cjs

@@ -17,10 +17,14 @@ function formatCredits(microCredits) {
     Number.isInteger(credits) ? { maximumFractionDigits: 0 } : { minimumFractionDigits: 0, maximumFractionDigits: 2 }
   );
 }
+function isTrackerCommitment(billing) {
+  return typeof billing.balanceMicro === "number" && typeof billing.costMicroPerRun === "number";
+}
 function toCite42McpResult(value) {
   if (!isJsonObject(value)) return value;
   const { billing, warning, ...result } = value;
   if (!isJsonObject(billing)) return value;
+  if (isTrackerCommitment(billing)) return { ...result, billing };
   const cost = isJsonObject(billing.cost) ? billing.cost.microCredits : void 0;
   const balance = isJsonObject(billing.balance) ? billing.balance.microCredits : void 0;
   if (typeof cost !== "number" || !Number.isFinite(cost) || typeof balance !== "number" || !Number.isFinite(balance)) {
@@ -148,7 +152,8 @@ var FULL_SWEEP_DESCRIPTION = "Query all five AI surfaces instead of the three de
 var MCP_USAGE_GUIDANCE = "Covers AI-search, citation, SEO, keyword, trend, and market-research data. If a plan needs more than 20 endpoint calls or may use more than 500 Cite42 credits, estimate the credits and ask the user before continuing. When a result contains cite42Credits, that figure is Cite42 credits, not a model or host balance. Free (0 credits): cite42_credits for the remaining balance, cite42_pricing for exact per-tool prices and cost estimates, cite42_usage for recent calls.";
 var MODEL_PRICING = "Pricing is per selected AI surface. Omitting models queries the three default surfaces (chatgpt, perplexity, gemini); fullSweep: true queries all five, adding claude and google_ai_overview for more credits. Use the models field when the user names a surface or asks to reduce credit use, and call cite42_pricing for exact current rates.";
 var DATA_PRICING = "Data tools have flat per-call prices; call cite42_pricing for exact current rates.";
-var WORKFLOW_PRICING = "Pricing: workflow cost is calculated from the primitive endpoints that run successfully and the selected model rates.";
+var KEYWORDS_PRICING = "Pricing: billed by outcome \u2014 cheapest when the seed has no search volume, more when it has metrics, most with ideas:true. Call cite42_pricing for exact current rates.";
+var WORKFLOW_PRICING = "Pricing: workflow cost is calculated from the tools that run successfully and the selected model rates.";
 function workflowDescription(description) {
   return `${description} ${MCP_USAGE_GUIDANCE} ${MODEL_PRICING} ${DATA_PRICING} ${WORKFLOW_PRICING}`;
 }
@@ -235,7 +240,7 @@ var aivSearch = (0, import_tools.createTool)({
 var aivCitations = (0, import_tools.createTool)({
   id: "cite42_citations",
   mcp: readOnly("Find AI citations"),
-  description: `Find which sources AI models cite for a query. Aggregates cited URLs across models with per-model counts; optionally checks whether a specific URL is cited. ${MODEL_PRICING} ${MCP_USAGE_GUIDANCE}`,
+  description: `Find which sources a model's web search surfaces for a query. Aggregates cited URLs across models with per-model counts; optionally checks whether a specific URL is cited. Measures the retrieval corpus behind a prompt \u2014 which domains own your category in AI search, and where your content is missing \u2014 not the citation links a consumer chat UI renders for a logged-in user. ${MODEL_PRICING} ${MCP_USAGE_GUIDANCE}`,
   inputSchema: import_zod.z.object({
     query: queryText("The concise query to look up cited sources for."),
     url: import_zod.z.string().trim().max(500).optional().describe("Optional URL to check whether it was cited."),
@@ -284,10 +289,13 @@ var aivSentiment = (0, import_tools.createTool)({
 var aivKeywords = (0, import_tools.createTool)({
   id: "cite42_keywords",
   mcp: readOnly("Get SEO keyword data"),
-  description: `Classic keyword data for a seed term. Omit ideas when the user only needs that seed's monthly search volume, CPC, or competition. Set ideas:true only when the user asks for related, alternative, or long-tail suggestions from provider candidates. A flat-priced data tool, not a multi-model AI-search query. ${DATA_PRICING} ${MCP_USAGE_GUIDANCE}`,
+  description: `Classic keyword data for a seed term. Omit ideas when the user only needs that seed's monthly search volume, CPC, or competition. Set ideas:true only when the user asks for related, alternative, or long-tail suggestions from provider candidates. Not a multi-model AI-search query. The reply echoes requestedKeyword and carries status "exact" or "no_data"; when the seed has no search volume, any related term that does appears under alternatives \u2014 never treat an alternative's metrics as the requested keyword's. ${KEYWORDS_PRICING} ${MCP_USAGE_GUIDANCE}`,
   inputSchema: import_zod.z.object({
     seed: queryText("Seed keyword or concise topic to fetch search volume, CPC, and competition for."),
     country: import_zod.z.string().trim().max(8).optional().describe('ISO-2 country code for localized metrics. Defaults to "us".'),
+    language: import_zod.z.string().trim().max(8).optional().describe(
+      `Optional ISO-2 language code. Defaults to the country's primary search language, so country "de" searches in German. Only multilingual markets accept an override: us (en, es), ca (en, fr), in (en, hi). Every other country has a single search language and rejects anything else.`
+    ),
     ideas: import_zod.z.boolean().optional().describe(
       "Omit for volume, CPC, and competition on the seed only. Set true only for related, alternative, or long-tail keyword ideas."
     )
@@ -420,7 +428,7 @@ var aivGenerateContentBrief = (0, import_tools.createTool)({
 });
 var trackerIdInput = import_zod.z.string().trim().min(1).max(128).describe("Cite42 tracker ID returned by a tracker management or report tool.");
 var trackerCadenceInput = import_zod.z.object({
-  frequency: import_zod.z.enum(["daily", "weekly"]),
+  frequency: import_zod.z.enum(["weekly", "monthly"]),
   timezone: import_zod.z.string().trim().min(1).max(100).refine((timezone) => {
     try {
       new Intl.DateTimeFormat("en-US", { timeZone: timezone }).format();
@@ -430,7 +438,10 @@ var trackerCadenceInput = import_zod.z.object({
     }
   }, "Timezone must be a valid IANA timezone.").describe("IANA timezone, for example Europe/London or America/New_York."),
   time: import_zod.z.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/).describe("Local run time in 24-hour HH:mm format."),
-  weekday: import_zod.z.number().int().min(0).max(6).optional().describe("Weekly day, where 0 is Sunday and 6 is Saturday.")
+  weekday: import_zod.z.number().int().min(0).max(6).optional().describe("Weekly trackers only. Day of week, where 0 is Sunday and 6 is Saturday."),
+  monthday: import_zod.z.number().int().min(1).max(31).optional().describe(
+    `Monthly trackers only. Day of month 1-31; a value past the end of a shorter month runs on that month's last day, so 31 always means "month end".`
+  )
 }).superRefine((cadence, context) => {
   if (cadence.frequency === "weekly" && cadence.weekday === void 0) {
     context.addIssue({
@@ -439,12 +450,19 @@ var trackerCadenceInput = import_zod.z.object({
       message: "weekday is required for a weekly tracker"
     });
   }
+  if (cadence.frequency === "monthly" && cadence.monthday === void 0) {
+    context.addIssue({
+      code: "custom",
+      path: ["monthday"],
+      message: "monthday is required for a monthly tracker"
+    });
+  }
 });
 var trackerPrimitiveInput = import_zod.z.enum(["rankings", "compare", "citations", "sentiment"]).describe(
   "What to measure on every prompt: rankings (which brands get named), compare (the brand against named competitors), citations (which sources are cited), or sentiment (how one brand is described). One measurement per tracker."
 );
 var trackerPromptsInput = import_zod.z.array(queryText("A prompt to run on every scheduled run.")).min(1).max(25).describe(
-  "Prompts to track, up to 25. Each is billed as its own call on every run. Keep the wording stable so runs stay comparable, avoid dates, and do not repeat a prompt."
+  "Prompts to track, up to 30. Each is billed as its own call on every run. Keep the wording stable so runs stay comparable, avoid dates, and do not repeat a prompt."
 );
 var trackerDefinitionFields = {
   name: import_zod.z.string().trim().min(1).max(100).describe("Human-readable tracker name."),
@@ -464,7 +482,7 @@ var TRACKER_BILLING_DESCRIPTION = "Tracker management and stored-report reads ar
 var aivTrackerCreate = (0, import_tools.createTool)({
   id: "cite42_tracker_create",
   mcp: mutation("Create Cite42 tracker draft"),
-  description: "Create a draft daily or weekly tracker: one measurement \u2014 rankings, compare, citations, or sentiment \u2014 applied to a list of prompts, with the brand, competitors and AI surfaces set once for all of them. When the user has no prompt list yet, run cite42_map_ai_prompts first and track the prompts it recommends. Creation does not start recurring calls. " + TRACKER_BILLING_DESCRIPTION,
+  description: "Create a draft weekly or monthly tracker: one measurement \u2014 rankings, compare, citations, or sentiment \u2014 applied to a list of prompts, with the brand, competitors and AI surfaces set once for all of them. When the user has no prompt list yet, run cite42_map_ai_prompts first and track the prompts it recommends. Creation does not start recurring calls. " + TRACKER_BILLING_DESCRIPTION,
   inputSchema: import_zod.z.object(trackerDefinitionFields),
   execute: async (input) => aivPost("/trackers", input)
 });
@@ -481,7 +499,7 @@ var aivTrackerActivate = (0, import_tools.createTool)({
     openWorldHint: true,
     idempotentHint: true
   }),
-  description: `Activate or resume recurring daily or weekly primitive calls. maxCostMicroPerRun must equal the tracker estimate being accepted; activation authorizes future billed calls until the tracker is paused. The response carries a billing block with the balance, the cost per run, and runsDryAt \u2014 the date the balance stops covering the account's active trackers \u2014 so relay it. Activation is refused when the balance cannot cover even the next run; tell the user to top up at cite42.dev/app/billing. ${TRACKER_BILLING_DESCRIPTION}`,
+  description: `Activate or resume recurring weekly or monthly tool calls. maxCostMicroPerRun must equal the tracker estimate being accepted; activation authorizes future billed calls until the tracker is paused. The response carries a billing block with the balance, the cost per run, and runsDryAt \u2014 the date the balance stops covering the account's active trackers \u2014 so relay it. When tracker emails are enabled, activation sends a setup summary and every completed run sends current results and suggested next steps, even when nothing changed. Activation is refused when the balance cannot cover even the next run; tell the user to top up at cite42.dev/app/billing. ${TRACKER_BILLING_DESCRIPTION}`,
   inputSchema: import_zod.z.object({
     trackerId: trackerIdInput,
     maxCostMicroPerRun: import_zod.z.number().int().nonnegative().describe("Exact estimatedCostMicroPerRun returned by the latest tracker record.")
@@ -511,7 +529,7 @@ var aivTrackerRun = (0, import_tools.createTool)({
     openWorldHint: true,
     idempotentHint: true
   }),
-  description: `Queue one manual run using the tracker\u2019s saved primitive inputs. A repeated requestToken returns the same logical run. ${TRACKER_BILLING_DESCRIPTION}`,
+  description: `Queue one manual run using the tracker\u2019s saved tool inputs. A repeated requestToken returns the same logical run. ${TRACKER_BILLING_DESCRIPTION}`,
   inputSchema: import_zod.z.object({
     trackerId: trackerIdInput,
     requestToken: import_zod.z.string().trim().min(1).max(200).describe("Stable caller-generated token used to deduplicate a retried manual run.")
@@ -521,14 +539,14 @@ var aivTrackerRun = (0, import_tools.createTool)({
 var aivTrackers = (0, import_tools.createTool)({
   id: "cite42_trackers",
   mcp: readOnly("List Cite42 trackers", false),
-  description: "List the connected account\u2019s trackers with status, cadence, primitive configuration, cost estimate, accepted per-run maximum, and next/last run times. Free: costs 0 credits.",
+  description: "List the connected account\u2019s trackers with status, cadence, tool configuration, cost estimate, accepted per-run maximum, and next/last run times. Free: costs 0 credits.",
   inputSchema: import_zod.z.object({}),
   execute: async () => aivGet("/trackers")
 });
 var aivTrackerReport = (0, import_tools.createTool)({
   id: "cite42_tracker_report",
   mcp: readOnly("Read Cite42 tracker report", false),
-  description: "Read bounded stored run history for one tracker, including per-primitive results, changes from the prior comparable observation, statuses, sampled times, and costs. Free: costs 0 credits.",
+  description: "Read bounded stored run history for one tracker, including per-tool results, changes from the prior comparable observation, statuses, sampled times, and costs. Free: costs 0 credits.",
   inputSchema: import_zod.z.object({
     trackerId: trackerIdInput,
     limit: import_zod.z.number().int().min(1).max(20).optional().default(8).describe("Most recent runs to return, capped for LLM context.")
@@ -582,7 +600,7 @@ if (!resolveApiKey()) {
   );
   process.exit(1);
 }
-buildCite42Server("0.3.0").startStdio().catch((error) => {
+buildCite42Server("0.5.0").startStdio().catch((error) => {
   console.error("[@cite42/mcp] Fatal error:", error);
   process.exit(1);
 });

package/dist/stdio.mjs

@@ -16,10 +16,14 @@ function formatCredits(microCredits) {
     Number.isInteger(credits) ? { maximumFractionDigits: 0 } : { minimumFractionDigits: 0, maximumFractionDigits: 2 }
   );
 }
+function isTrackerCommitment(billing) {
+  return typeof billing.balanceMicro === "number" && typeof billing.costMicroPerRun === "number";
+}
 function toCite42McpResult(value) {
   if (!isJsonObject(value)) return value;
   const { billing, warning, ...result } = value;
   if (!isJsonObject(billing)) return value;
+  if (isTrackerCommitment(billing)) return { ...result, billing };
   const cost = isJsonObject(billing.cost) ? billing.cost.microCredits : void 0;
   const balance = isJsonObject(billing.balance) ? billing.balance.microCredits : void 0;
   if (typeof cost !== "number" || !Number.isFinite(cost) || typeof balance !== "number" || !Number.isFinite(balance)) {
@@ -147,7 +151,8 @@ var FULL_SWEEP_DESCRIPTION = "Query all five AI surfaces instead of the three de
 var MCP_USAGE_GUIDANCE = "Covers AI-search, citation, SEO, keyword, trend, and market-research data. If a plan needs more than 20 endpoint calls or may use more than 500 Cite42 credits, estimate the credits and ask the user before continuing. When a result contains cite42Credits, that figure is Cite42 credits, not a model or host balance. Free (0 credits): cite42_credits for the remaining balance, cite42_pricing for exact per-tool prices and cost estimates, cite42_usage for recent calls.";
 var MODEL_PRICING = "Pricing is per selected AI surface. Omitting models queries the three default surfaces (chatgpt, perplexity, gemini); fullSweep: true queries all five, adding claude and google_ai_overview for more credits. Use the models field when the user names a surface or asks to reduce credit use, and call cite42_pricing for exact current rates.";
 var DATA_PRICING = "Data tools have flat per-call prices; call cite42_pricing for exact current rates.";
-var WORKFLOW_PRICING = "Pricing: workflow cost is calculated from the primitive endpoints that run successfully and the selected model rates.";
+var KEYWORDS_PRICING = "Pricing: billed by outcome \u2014 cheapest when the seed has no search volume, more when it has metrics, most with ideas:true. Call cite42_pricing for exact current rates.";
+var WORKFLOW_PRICING = "Pricing: workflow cost is calculated from the tools that run successfully and the selected model rates.";
 function workflowDescription(description) {
   return `${description} ${MCP_USAGE_GUIDANCE} ${MODEL_PRICING} ${DATA_PRICING} ${WORKFLOW_PRICING}`;
 }
@@ -234,7 +239,7 @@ var aivSearch = createTool({
 var aivCitations = createTool({
   id: "cite42_citations",
   mcp: readOnly("Find AI citations"),
-  description: `Find which sources AI models cite for a query. Aggregates cited URLs across models with per-model counts; optionally checks whether a specific URL is cited. ${MODEL_PRICING} ${MCP_USAGE_GUIDANCE}`,
+  description: `Find which sources a model's web search surfaces for a query. Aggregates cited URLs across models with per-model counts; optionally checks whether a specific URL is cited. Measures the retrieval corpus behind a prompt \u2014 which domains own your category in AI search, and where your content is missing \u2014 not the citation links a consumer chat UI renders for a logged-in user. ${MODEL_PRICING} ${MCP_USAGE_GUIDANCE}`,
   inputSchema: z.object({
     query: queryText("The concise query to look up cited sources for."),
     url: z.string().trim().max(500).optional().describe("Optional URL to check whether it was cited."),
@@ -283,10 +288,13 @@ var aivSentiment = createTool({
 var aivKeywords = createTool({
   id: "cite42_keywords",
   mcp: readOnly("Get SEO keyword data"),
-  description: `Classic keyword data for a seed term. Omit ideas when the user only needs that seed's monthly search volume, CPC, or competition. Set ideas:true only when the user asks for related, alternative, or long-tail suggestions from provider candidates. A flat-priced data tool, not a multi-model AI-search query. ${DATA_PRICING} ${MCP_USAGE_GUIDANCE}`,
+  description: `Classic keyword data for a seed term. Omit ideas when the user only needs that seed's monthly search volume, CPC, or competition. Set ideas:true only when the user asks for related, alternative, or long-tail suggestions from provider candidates. Not a multi-model AI-search query. The reply echoes requestedKeyword and carries status "exact" or "no_data"; when the seed has no search volume, any related term that does appears under alternatives \u2014 never treat an alternative's metrics as the requested keyword's. ${KEYWORDS_PRICING} ${MCP_USAGE_GUIDANCE}`,
   inputSchema: z.object({
     seed: queryText("Seed keyword or concise topic to fetch search volume, CPC, and competition for."),
     country: z.string().trim().max(8).optional().describe('ISO-2 country code for localized metrics. Defaults to "us".'),
+    language: z.string().trim().max(8).optional().describe(
+      `Optional ISO-2 language code. Defaults to the country's primary search language, so country "de" searches in German. Only multilingual markets accept an override: us (en, es), ca (en, fr), in (en, hi). Every other country has a single search language and rejects anything else.`
+    ),
     ideas: z.boolean().optional().describe(
       "Omit for volume, CPC, and competition on the seed only. Set true only for related, alternative, or long-tail keyword ideas."
     )
@@ -419,7 +427,7 @@ var aivGenerateContentBrief = createTool({
 });
 var trackerIdInput = z.string().trim().min(1).max(128).describe("Cite42 tracker ID returned by a tracker management or report tool.");
 var trackerCadenceInput = z.object({
-  frequency: z.enum(["daily", "weekly"]),
+  frequency: z.enum(["weekly", "monthly"]),
   timezone: z.string().trim().min(1).max(100).refine((timezone) => {
     try {
       new Intl.DateTimeFormat("en-US", { timeZone: timezone }).format();
@@ -429,7 +437,10 @@ var trackerCadenceInput = z.object({
     }
   }, "Timezone must be a valid IANA timezone.").describe("IANA timezone, for example Europe/London or America/New_York."),
   time: z.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/).describe("Local run time in 24-hour HH:mm format."),
-  weekday: z.number().int().min(0).max(6).optional().describe("Weekly day, where 0 is Sunday and 6 is Saturday.")
+  weekday: z.number().int().min(0).max(6).optional().describe("Weekly trackers only. Day of week, where 0 is Sunday and 6 is Saturday."),
+  monthday: z.number().int().min(1).max(31).optional().describe(
+    `Monthly trackers only. Day of month 1-31; a value past the end of a shorter month runs on that month's last day, so 31 always means "month end".`
+  )
 }).superRefine((cadence, context) => {
   if (cadence.frequency === "weekly" && cadence.weekday === void 0) {
     context.addIssue({
@@ -438,12 +449,19 @@ var trackerCadenceInput = z.object({
       message: "weekday is required for a weekly tracker"
     });
   }
+  if (cadence.frequency === "monthly" && cadence.monthday === void 0) {
+    context.addIssue({
+      code: "custom",
+      path: ["monthday"],
+      message: "monthday is required for a monthly tracker"
+    });
+  }
 });
 var trackerPrimitiveInput = z.enum(["rankings", "compare", "citations", "sentiment"]).describe(
   "What to measure on every prompt: rankings (which brands get named), compare (the brand against named competitors), citations (which sources are cited), or sentiment (how one brand is described). One measurement per tracker."
 );
 var trackerPromptsInput = z.array(queryText("A prompt to run on every scheduled run.")).min(1).max(25).describe(
-  "Prompts to track, up to 25. Each is billed as its own call on every run. Keep the wording stable so runs stay comparable, avoid dates, and do not repeat a prompt."
+  "Prompts to track, up to 30. Each is billed as its own call on every run. Keep the wording stable so runs stay comparable, avoid dates, and do not repeat a prompt."
 );
 var trackerDefinitionFields = {
   name: z.string().trim().min(1).max(100).describe("Human-readable tracker name."),
@@ -463,7 +481,7 @@ var TRACKER_BILLING_DESCRIPTION = "Tracker management and stored-report reads ar
 var aivTrackerCreate = createTool({
   id: "cite42_tracker_create",
   mcp: mutation("Create Cite42 tracker draft"),
-  description: "Create a draft daily or weekly tracker: one measurement \u2014 rankings, compare, citations, or sentiment \u2014 applied to a list of prompts, with the brand, competitors and AI surfaces set once for all of them. When the user has no prompt list yet, run cite42_map_ai_prompts first and track the prompts it recommends. Creation does not start recurring calls. " + TRACKER_BILLING_DESCRIPTION,
+  description: "Create a draft weekly or monthly tracker: one measurement \u2014 rankings, compare, citations, or sentiment \u2014 applied to a list of prompts, with the brand, competitors and AI surfaces set once for all of them. When the user has no prompt list yet, run cite42_map_ai_prompts first and track the prompts it recommends. Creation does not start recurring calls. " + TRACKER_BILLING_DESCRIPTION,
   inputSchema: z.object(trackerDefinitionFields),
   execute: async (input) => aivPost("/trackers", input)
 });
@@ -480,7 +498,7 @@ var aivTrackerActivate = createTool({
     openWorldHint: true,
     idempotentHint: true
   }),
-  description: `Activate or resume recurring daily or weekly primitive calls. maxCostMicroPerRun must equal the tracker estimate being accepted; activation authorizes future billed calls until the tracker is paused. The response carries a billing block with the balance, the cost per run, and runsDryAt \u2014 the date the balance stops covering the account's active trackers \u2014 so relay it. Activation is refused when the balance cannot cover even the next run; tell the user to top up at cite42.dev/app/billing. ${TRACKER_BILLING_DESCRIPTION}`,
+  description: `Activate or resume recurring weekly or monthly tool calls. maxCostMicroPerRun must equal the tracker estimate being accepted; activation authorizes future billed calls until the tracker is paused. The response carries a billing block with the balance, the cost per run, and runsDryAt \u2014 the date the balance stops covering the account's active trackers \u2014 so relay it. When tracker emails are enabled, activation sends a setup summary and every completed run sends current results and suggested next steps, even when nothing changed. Activation is refused when the balance cannot cover even the next run; tell the user to top up at cite42.dev/app/billing. ${TRACKER_BILLING_DESCRIPTION}`,
   inputSchema: z.object({
     trackerId: trackerIdInput,
     maxCostMicroPerRun: z.number().int().nonnegative().describe("Exact estimatedCostMicroPerRun returned by the latest tracker record.")
@@ -510,7 +528,7 @@ var aivTrackerRun = createTool({
     openWorldHint: true,
     idempotentHint: true
   }),
-  description: `Queue one manual run using the tracker\u2019s saved primitive inputs. A repeated requestToken returns the same logical run. ${TRACKER_BILLING_DESCRIPTION}`,
+  description: `Queue one manual run using the tracker\u2019s saved tool inputs. A repeated requestToken returns the same logical run. ${TRACKER_BILLING_DESCRIPTION}`,
   inputSchema: z.object({
     trackerId: trackerIdInput,
     requestToken: z.string().trim().min(1).max(200).describe("Stable caller-generated token used to deduplicate a retried manual run.")
@@ -520,14 +538,14 @@ var aivTrackerRun = createTool({
 var aivTrackers = createTool({
   id: "cite42_trackers",
   mcp: readOnly("List Cite42 trackers", false),
-  description: "List the connected account\u2019s trackers with status, cadence, primitive configuration, cost estimate, accepted per-run maximum, and next/last run times. Free: costs 0 credits.",
+  description: "List the connected account\u2019s trackers with status, cadence, tool configuration, cost estimate, accepted per-run maximum, and next/last run times. Free: costs 0 credits.",
   inputSchema: z.object({}),
   execute: async () => aivGet("/trackers")
 });
 var aivTrackerReport = createTool({
   id: "cite42_tracker_report",
   mcp: readOnly("Read Cite42 tracker report", false),
-  description: "Read bounded stored run history for one tracker, including per-primitive results, changes from the prior comparable observation, statuses, sampled times, and costs. Free: costs 0 credits.",
+  description: "Read bounded stored run history for one tracker, including per-tool results, changes from the prior comparable observation, statuses, sampled times, and costs. Free: costs 0 credits.",
   inputSchema: z.object({
     trackerId: trackerIdInput,
     limit: z.number().int().min(1).max(20).optional().default(8).describe("Most recent runs to return, capped for LLM context.")
@@ -581,7 +599,7 @@ if (!resolveApiKey()) {
   );
   process.exit(1);
 }
-buildCite42Server("0.3.0").startStdio().catch((error) => {
+buildCite42Server("0.5.0").startStdio().catch((error) => {
   console.error("[@cite42/mcp] Fatal error:", error);
   process.exit(1);
 });

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@cite42/mcp",
   "mcpName": "dev.cite42/mcp",
-  "version": "0.3.0",
-  "description": "Cite42 MCP server: query ChatGPT, Claude, Perplexity, Gemini & Google AI Overviews for brand rankings, AI citations, SEO keyword data, and Reddit/YouTube trends, and schedule daily or weekly trackers that watch a list of prompts over time. Works with Claude Code, Claude Desktop, Codex CLI, Cursor, and any MCP client.",
+  "version": "0.5.0",
+  "description": "Cite42 MCP server: query the models behind ChatGPT, Claude, Perplexity & Gemini, plus Google AI Overviews, for brand rankings, AI citations, SEO keyword data, and Reddit/YouTube trends, and schedule weekly or monthly trackers that watch a list of prompts over time. Works with Claude Code, Claude Desktop, Codex CLI, Cursor, and any MCP client.",
   "license": "MIT",
   "type": "module",
   "bin": {