@cite42/mcp 0.1.16 → 0.1.17

package/README.md

@@ -6,6 +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** for rankings, comparisons, citations, and sentiment, then ask your agent for stored run 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
@@ -91,7 +92,7 @@ You do not need to keep `npx -y @cite42/mcp` running in a separate terminal. Loc
 - **Claude Code:** run `claude mcp list` and check that `cite42` shows as ✔ connected. Or type `/mcp` inside a session.
 - **Claude Desktop:** open **Settings → Connectors** and confirm Cite42 is connected.
 - **Codex CLI:** run `codex mcp list`.
-- **Cursor:** look for `cite42` in the MCP/tools indicator. 15 tools should be listed.
+- **Cursor:** look for `cite42` in the MCP/tools indicator. 26 tools should be listed.
 
 If it doesn't appear, see [Troubleshooting](#troubleshooting).
 
@@ -104,6 +105,7 @@ After connecting or restarting, just ask in plain language. Your agent picks the
 - *"Get search volume, CPC, and related keywords for 'ai seo tools'."*
 - *"What are people on Reddit complaining about regarding email marketing tools?"*
 - *"Run a content brief for the topic 'ai website builder'."*
+- *"Create a weekly Cite42 tracker for our rankings, citations, and sentiment. Show me the estimated credits per run before activating it."*
 
 ### Example: what a session looks like
 
@@ -124,7 +126,15 @@ After connecting or restarting, just ask in plain language. Your agent picks the
 
 The exact brands and sources change by query and model. A good result should show the tool used, model/source evidence, and a short summary you can act on.
 
-## Endpoint tools
+## Tools
+
+Cite42 exposes 26 MCP tools: 3 free account tools, 9 primitive data tools, 6 research workflows, and 8 tracker tools.
+
+### Account & pricing (free)
+
+- `cite42_credits`: check the connected account's remaining Cite42 credit balance.
+- `cite42_pricing`: get current per-tool prices and estimate a planned set of calls.
+- `cite42_usage`: read recent call status and cost together with the remaining balance.
 
 ### AI search visibility
 
@@ -150,6 +160,17 @@ The exact brands and sources change by query and model. A good result should sho
 - `cite42_find_ai_citation_gaps`: find queries where AI answers cite competitors but not your brand, domain, or URL.
 - `cite42_generate_content_brief`: collect AI answers, citations, keyword demand, and social signals into brief-ready data.
 
+### Trackers
+
+- `cite42_tracker_create`: create a draft daily or weekly tracker from saved rankings, compare, citations, and sentiment inputs. Creating a draft is free and does not schedule calls.
+- `cite42_tracker_update`: replace a tracker's name, cadence, and saved primitive inputs. Updating configuration 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.
+- `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 from the saved primitive inputs. The underlying primitive calls are billed at their normal rates.
+- `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.
+
 ## Configuration
 
 - `CITE42_API_KEY`: required. Your API key from [www.cite42.dev/app/keys](https://www.cite42.dev/app/keys).
@@ -163,7 +184,7 @@ npx -y @cite42/mcp --api-key=cite42_live_your_key_here --api-base=https://www.ci
 
 ## Billing
 
-Tool calls consume Cite42 credits from your account. 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).
+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 its saved primitive calls at their normal rates. 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

@@ -87,9 +87,27 @@ function getBaseUrl() {
   return readFlag("api-base") ?? process.env.CITE42_API_BASE ?? DEFAULT_BASE_URL;
 }
 async function aivPost(path, body) {
+  return aivWrite("POST", path, body);
+}
+async function aivPatch(path, body) {
+  return aivWrite("PATCH", path, body);
+}
+async function aivDelete(path) {
+  const url = `${getBaseUrl()}${path.startsWith("/") ? path : `/${path}`}`;
+  const res = await fetch(url, {
+    method: "DELETE",
+    headers: { Authorization: `Bearer ${getApiKey()}` }
+  });
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(errorMessageForMcp(res.status, path, body));
+  }
+  return toCite42McpResult(await res.json());
+}
+async function aivWrite(method, path, body) {
   const url = `${getBaseUrl()}${path.startsWith("/") ? path : `/${path}`}`;
   const res = await fetch(url, {
-    method: "POST",
+    method,
     headers: {
       "Content-Type": "application/json",
       Authorization: `Bearer ${getApiKey()}`
@@ -136,6 +154,17 @@ function workflowDescription(description) {
 function readOnly(title, openWorldHint = true) {
   return { annotations: { title, readOnlyHint: true, openWorldHint } };
 }
+function mutation(title, options = {}) {
+  return {
+    annotations: {
+      title,
+      readOnlyHint: false,
+      destructiveHint: options.destructiveHint ?? false,
+      openWorldHint: options.openWorldHint ?? false,
+      ...options.idempotentHint === void 0 ? {} : { idempotentHint: options.idempotentHint }
+    }
+  };
+}
 function queryText(description) {
   return import_zod.z.string().trim().min(1).max(QUERY_MAX_CHARS).describe(description);
 }
@@ -381,6 +410,143 @@ var aivGenerateContentBrief = (0, import_tools.createTool)({
   }),
   execute: async (input) => aivPost("/workflows/content-brief", input)
 });
+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"]),
+  timezone: import_zod.z.string().trim().min(1).max(100).refine((timezone) => {
+    try {
+      new Intl.DateTimeFormat("en-US", { timeZone: timezone }).format();
+      return true;
+    } catch {
+      return false;
+    }
+  }, "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.")
+}).superRefine((cadence, context) => {
+  if (cadence.frequency === "weekly" && cadence.weekday === void 0) {
+    context.addIssue({
+      code: "custom",
+      path: ["weekday"],
+      message: "weekday is required for a weekly tracker"
+    });
+  }
+});
+var trackerItemInput = import_zod.z.discriminatedUnion("primitive", [
+  import_zod.z.object({
+    primitive: import_zod.z.literal("rankings"),
+    input: import_zod.z.object({
+      query: queryText("Prompt to measure brand visibility for."),
+      competitors: competitorList,
+      models: modelsInput
+    })
+  }),
+  import_zod.z.object({
+    primitive: import_zod.z.literal("compare"),
+    input: import_zod.z.object({
+      query: queryText("Prompt to compare the brand and competitors for."),
+      brand: shortText("Primary brand to compare."),
+      competitors: import_zod.z.array(shortText("Competitor brand/domain name.")).nonempty().max(10),
+      models: modelsInput
+    })
+  }),
+  import_zod.z.object({
+    primitive: import_zod.z.literal("citations"),
+    input: import_zod.z.object({
+      query: queryText("Prompt whose cited sources should be tracked."),
+      url: import_zod.z.string().trim().max(500).optional(),
+      models: modelsInput
+    })
+  }),
+  import_zod.z.object({
+    primitive: import_zod.z.literal("sentiment"),
+    input: import_zod.z.object({
+      query: queryText("Prompt whose brand sentiment should be tracked."),
+      brand: shortText("Brand whose sentiment should be scored."),
+      models: modelsInput
+    })
+  })
+]);
+var trackerDefinitionFields = {
+  name: import_zod.z.string().trim().min(1).max(100),
+  cadence: trackerCadenceInput,
+  items: import_zod.z.array(trackerItemInput).min(1).max(25).describe("Primitive calls to execute and store on each scheduled run.")
+};
+var TRACKER_BILLING_DESCRIPTION = "Tracker management and stored-report reads are free. Each scheduled or manual run bills the underlying primitive calls at their normal per-model rates; the activation response and tracker record expose the accepted maximum cost per run.";
+var aivTrackerCreate = (0, import_tools.createTool)({
+  id: "cite42_tracker_create",
+  mcp: mutation("Create Cite42 tracker draft"),
+  description: `Create a draft daily or weekly tracker from ordinary rankings, compare, citations, and sentiment primitive inputs. Creation does not start recurring calls. ${TRACKER_BILLING_DESCRIPTION}`,
+  inputSchema: import_zod.z.object(trackerDefinitionFields),
+  execute: async (input) => aivPost("/trackers", input)
+});
+var aivTrackerUpdate = (0, import_tools.createTool)({
+  id: "cite42_tracker_update",
+  mcp: mutation("Update Cite42 tracker", { destructiveHint: true }),
+  description: `Replace a tracker configuration with a validated name, cadence, and primitive item set. An edit returns the tracker to draft so its new recurring cost can be confirmed. ${TRACKER_BILLING_DESCRIPTION}`,
+  inputSchema: import_zod.z.object({ trackerId: trackerIdInput, ...trackerDefinitionFields }),
+  execute: async ({ trackerId, ...input }) => aivPatch(`/trackers/${encodeURIComponent(trackerId)}`, input)
+});
+var aivTrackerActivate = (0, import_tools.createTool)({
+  id: "cite42_tracker_activate",
+  mcp: mutation("Activate Cite42 tracker", {
+    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. ${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.")
+  }),
+  execute: async ({ trackerId, maxCostMicroPerRun }) => aivPost(`/trackers/${encodeURIComponent(trackerId)}/activate`, { maxCostMicroPerRun })
+});
+var aivTrackerPause = (0, import_tools.createTool)({
+  id: "cite42_tracker_pause",
+  mcp: mutation("Pause Cite42 tracker", { idempotentHint: true }),
+  description: "Pause future recurring calls for a tracker while preserving its configuration and stored run history. Free: costs 0 credits.",
+  inputSchema: import_zod.z.object({ trackerId: trackerIdInput }),
+  execute: async ({ trackerId }) => aivPost(`/trackers/${encodeURIComponent(trackerId)}/pause`, {})
+});
+var aivTrackerDelete = (0, import_tools.createTool)({
+  id: "cite42_tracker_delete",
+  mcp: mutation("Permanently delete Cite42 tracker", {
+    destructiveHint: true,
+    idempotentHint: true
+  }),
+  description: "Permanently delete a draft or paused tracker, including its saved configuration and run history. Active trackers must be paused first, and deletion is rejected while a run is queued or running. Financial usage and credit ledger records are retained. Free: costs 0 credits.",
+  inputSchema: import_zod.z.object({ trackerId: trackerIdInput }),
+  execute: async ({ trackerId }) => aivDelete(`/trackers/${encodeURIComponent(trackerId)}`)
+});
+var aivTrackerRun = (0, import_tools.createTool)({
+  id: "cite42_tracker_run",
+  mcp: mutation("Run Cite42 tracker now", {
+    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}`,
+  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.")
+  }),
+  execute: async ({ trackerId, requestToken }) => aivPost(`/trackers/${encodeURIComponent(trackerId)}/runs`, { requestToken })
+});
+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.",
+  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.",
+  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.")
+  }),
+  execute: async ({ trackerId, limit }) => aivGet(`/trackers/${encodeURIComponent(trackerId)}/report?limit=${limit}`)
+});
 
 // src/server.ts
 var CITE42_TOOLS = {
@@ -401,7 +567,15 @@ var CITE42_TOOLS = {
   cite42_map_ai_prompts: aivMapAiPrompts,
   cite42_analyze_competitor_content: aivAnalyzeCompetitorContent,
   cite42_find_ai_citation_gaps: aivFindAiCitationGaps,
-  cite42_generate_content_brief: aivGenerateContentBrief
+  cite42_generate_content_brief: aivGenerateContentBrief,
+  cite42_tracker_create: aivTrackerCreate,
+  cite42_tracker_update: aivTrackerUpdate,
+  cite42_tracker_activate: aivTrackerActivate,
+  cite42_tracker_pause: aivTrackerPause,
+  cite42_tracker_delete: aivTrackerDelete,
+  cite42_tracker_run: aivTrackerRun,
+  cite42_trackers: aivTrackers,
+  cite42_tracker_report: aivTrackerReport
 };
 function buildCite42Server(version) {
   return new import_mcp.MCPServer({
@@ -420,7 +594,7 @@ if (!resolveApiKey()) {
   );
   process.exit(1);
 }
-buildCite42Server("0.1.16").startStdio().catch((error) => {
+buildCite42Server("0.1.17").startStdio().catch((error) => {
   console.error("[@cite42/mcp] Fatal error:", error);
   process.exit(1);
 });

package/dist/stdio.mjs

@@ -86,9 +86,27 @@ function getBaseUrl() {
   return readFlag("api-base") ?? process.env.CITE42_API_BASE ?? DEFAULT_BASE_URL;
 }
 async function aivPost(path, body) {
+  return aivWrite("POST", path, body);
+}
+async function aivPatch(path, body) {
+  return aivWrite("PATCH", path, body);
+}
+async function aivDelete(path) {
+  const url = `${getBaseUrl()}${path.startsWith("/") ? path : `/${path}`}`;
+  const res = await fetch(url, {
+    method: "DELETE",
+    headers: { Authorization: `Bearer ${getApiKey()}` }
+  });
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(errorMessageForMcp(res.status, path, body));
+  }
+  return toCite42McpResult(await res.json());
+}
+async function aivWrite(method, path, body) {
   const url = `${getBaseUrl()}${path.startsWith("/") ? path : `/${path}`}`;
   const res = await fetch(url, {
-    method: "POST",
+    method,
     headers: {
       "Content-Type": "application/json",
       Authorization: `Bearer ${getApiKey()}`
@@ -135,6 +153,17 @@ function workflowDescription(description) {
 function readOnly(title, openWorldHint = true) {
   return { annotations: { title, readOnlyHint: true, openWorldHint } };
 }
+function mutation(title, options = {}) {
+  return {
+    annotations: {
+      title,
+      readOnlyHint: false,
+      destructiveHint: options.destructiveHint ?? false,
+      openWorldHint: options.openWorldHint ?? false,
+      ...options.idempotentHint === void 0 ? {} : { idempotentHint: options.idempotentHint }
+    }
+  };
+}
 function queryText(description) {
   return z.string().trim().min(1).max(QUERY_MAX_CHARS).describe(description);
 }
@@ -380,6 +409,143 @@ var aivGenerateContentBrief = createTool({
   }),
   execute: async (input) => aivPost("/workflows/content-brief", input)
 });
+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"]),
+  timezone: z.string().trim().min(1).max(100).refine((timezone) => {
+    try {
+      new Intl.DateTimeFormat("en-US", { timeZone: timezone }).format();
+      return true;
+    } catch {
+      return false;
+    }
+  }, "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.")
+}).superRefine((cadence, context) => {
+  if (cadence.frequency === "weekly" && cadence.weekday === void 0) {
+    context.addIssue({
+      code: "custom",
+      path: ["weekday"],
+      message: "weekday is required for a weekly tracker"
+    });
+  }
+});
+var trackerItemInput = z.discriminatedUnion("primitive", [
+  z.object({
+    primitive: z.literal("rankings"),
+    input: z.object({
+      query: queryText("Prompt to measure brand visibility for."),
+      competitors: competitorList,
+      models: modelsInput
+    })
+  }),
+  z.object({
+    primitive: z.literal("compare"),
+    input: z.object({
+      query: queryText("Prompt to compare the brand and competitors for."),
+      brand: shortText("Primary brand to compare."),
+      competitors: z.array(shortText("Competitor brand/domain name.")).nonempty().max(10),
+      models: modelsInput
+    })
+  }),
+  z.object({
+    primitive: z.literal("citations"),
+    input: z.object({
+      query: queryText("Prompt whose cited sources should be tracked."),
+      url: z.string().trim().max(500).optional(),
+      models: modelsInput
+    })
+  }),
+  z.object({
+    primitive: z.literal("sentiment"),
+    input: z.object({
+      query: queryText("Prompt whose brand sentiment should be tracked."),
+      brand: shortText("Brand whose sentiment should be scored."),
+      models: modelsInput
+    })
+  })
+]);
+var trackerDefinitionFields = {
+  name: z.string().trim().min(1).max(100),
+  cadence: trackerCadenceInput,
+  items: z.array(trackerItemInput).min(1).max(25).describe("Primitive calls to execute and store on each scheduled run.")
+};
+var TRACKER_BILLING_DESCRIPTION = "Tracker management and stored-report reads are free. Each scheduled or manual run bills the underlying primitive calls at their normal per-model rates; the activation response and tracker record expose the accepted maximum cost per run.";
+var aivTrackerCreate = createTool({
+  id: "cite42_tracker_create",
+  mcp: mutation("Create Cite42 tracker draft"),
+  description: `Create a draft daily or weekly tracker from ordinary rankings, compare, citations, and sentiment primitive inputs. Creation does not start recurring calls. ${TRACKER_BILLING_DESCRIPTION}`,
+  inputSchema: z.object(trackerDefinitionFields),
+  execute: async (input) => aivPost("/trackers", input)
+});
+var aivTrackerUpdate = createTool({
+  id: "cite42_tracker_update",
+  mcp: mutation("Update Cite42 tracker", { destructiveHint: true }),
+  description: `Replace a tracker configuration with a validated name, cadence, and primitive item set. An edit returns the tracker to draft so its new recurring cost can be confirmed. ${TRACKER_BILLING_DESCRIPTION}`,
+  inputSchema: z.object({ trackerId: trackerIdInput, ...trackerDefinitionFields }),
+  execute: async ({ trackerId, ...input }) => aivPatch(`/trackers/${encodeURIComponent(trackerId)}`, input)
+});
+var aivTrackerActivate = createTool({
+  id: "cite42_tracker_activate",
+  mcp: mutation("Activate Cite42 tracker", {
+    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. ${TRACKER_BILLING_DESCRIPTION}`,
+  inputSchema: z.object({
+    trackerId: trackerIdInput,
+    maxCostMicroPerRun: z.number().int().nonnegative().describe("Exact estimatedCostMicroPerRun returned by the latest tracker record.")
+  }),
+  execute: async ({ trackerId, maxCostMicroPerRun }) => aivPost(`/trackers/${encodeURIComponent(trackerId)}/activate`, { maxCostMicroPerRun })
+});
+var aivTrackerPause = createTool({
+  id: "cite42_tracker_pause",
+  mcp: mutation("Pause Cite42 tracker", { idempotentHint: true }),
+  description: "Pause future recurring calls for a tracker while preserving its configuration and stored run history. Free: costs 0 credits.",
+  inputSchema: z.object({ trackerId: trackerIdInput }),
+  execute: async ({ trackerId }) => aivPost(`/trackers/${encodeURIComponent(trackerId)}/pause`, {})
+});
+var aivTrackerDelete = createTool({
+  id: "cite42_tracker_delete",
+  mcp: mutation("Permanently delete Cite42 tracker", {
+    destructiveHint: true,
+    idempotentHint: true
+  }),
+  description: "Permanently delete a draft or paused tracker, including its saved configuration and run history. Active trackers must be paused first, and deletion is rejected while a run is queued or running. Financial usage and credit ledger records are retained. Free: costs 0 credits.",
+  inputSchema: z.object({ trackerId: trackerIdInput }),
+  execute: async ({ trackerId }) => aivDelete(`/trackers/${encodeURIComponent(trackerId)}`)
+});
+var aivTrackerRun = createTool({
+  id: "cite42_tracker_run",
+  mcp: mutation("Run Cite42 tracker now", {
+    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}`,
+  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.")
+  }),
+  execute: async ({ trackerId, requestToken }) => aivPost(`/trackers/${encodeURIComponent(trackerId)}/runs`, { requestToken })
+});
+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.",
+  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.",
+  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.")
+  }),
+  execute: async ({ trackerId, limit }) => aivGet(`/trackers/${encodeURIComponent(trackerId)}/report?limit=${limit}`)
+});
 
 // src/server.ts
 var CITE42_TOOLS = {
@@ -400,7 +566,15 @@ var CITE42_TOOLS = {
   cite42_map_ai_prompts: aivMapAiPrompts,
   cite42_analyze_competitor_content: aivAnalyzeCompetitorContent,
   cite42_find_ai_citation_gaps: aivFindAiCitationGaps,
-  cite42_generate_content_brief: aivGenerateContentBrief
+  cite42_generate_content_brief: aivGenerateContentBrief,
+  cite42_tracker_create: aivTrackerCreate,
+  cite42_tracker_update: aivTrackerUpdate,
+  cite42_tracker_activate: aivTrackerActivate,
+  cite42_tracker_pause: aivTrackerPause,
+  cite42_tracker_delete: aivTrackerDelete,
+  cite42_tracker_run: aivTrackerRun,
+  cite42_trackers: aivTrackers,
+  cite42_tracker_report: aivTrackerReport
 };
 function buildCite42Server(version) {
   return new MCPServer({
@@ -419,7 +593,7 @@ if (!resolveApiKey()) {
   );
   process.exit(1);
 }
-buildCite42Server("0.1.16").startStdio().catch((error) => {
+buildCite42Server("0.1.17").startStdio().catch((error) => {
   console.error("[@cite42/mcp] Fatal error:", error);
   process.exit(1);
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cite42/mcp",
   "mcpName": "dev.cite42/mcp",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "Cite42 MCP server: query ChatGPT, Claude, Perplexity, Gemini & Google AI Overviews for brand rankings, AI citations, SEO keyword data, and Reddit/YouTube trends. Works with Claude Code, Claude Desktop, Codex CLI, Cursor, and any MCP client.",
   "license": "MIT",
   "type": "module",