growtics-mcp 1.0.0 → 1.1.0

package/index.js

@@ -29,6 +29,7 @@ import * as getFunnels          from './tools/get-funnels.js';
 import * as getReleases         from './tools/get-releases.js';
 import * as getSeoSuggestions   from './tools/get-seo-suggestions.js';
 import * as analyzeTrafficDrop  from './tools/analyze-traffic-drop.js';
+import * as getGrowActions      from './tools/get-grow-actions.js';
 
 // ── Configuration ─────────────────────────────────────────────────────────────
 const API_KEY  = process.env.GROWTICS_API_KEY;
@@ -79,6 +80,7 @@ const TOOLS = [
   getReleases,
   getSeoSuggestions,
   analyzeTrafficDrop,
+  getGrowActions,
 ];
 
 const TOOL_MAP = Object.fromEntries(TOOLS.map(t => [t.definition.name, t]));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "growtics-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for Growtics Analytics — ask your AI assistant questions about your website traffic, SEO, conversions, and releases.",
   "type": "module",
   "main": "index.js",

package/tools/get-grow-actions.js

@@ -0,0 +1,83 @@
+/**
+ * get-grow-actions tool
+ * Returns active and past Grow Actions (daily marketing checklist items) from Growtics.
+ */
+export const definition = {
+  name: 'get-grow-actions',
+  description:
+    'Get active (today\'s) and past Grow Actions (daily marketing tasks, social posts, directories) ' +
+    'configured for a site, including statuses and completion metrics. Use this to answer ' +
+    '"What marketing actions should I take today?", "What is my marketing task history?", ' +
+    'or "How many grow actions have I completed this week?"',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      siteId: {
+        type: 'string',
+        description: 'The Growtics site UUID (get it from list-sites)',
+      },
+      status: {
+        type: 'string',
+        enum: ['pending', 'done', 'skipped', 'expired'],
+        description: 'Filter by status. Leave empty to get all.',
+      },
+    },
+    required: ['siteId'],
+  },
+};
+
+const STATUS_EMOJI = {
+  pending: '⏳ Pending',
+  done: '✅ Done',
+  skipped: '🚫 Skipped',
+  expired: '🛑 Expired',
+};
+
+export async function run({ args, apiClient }) {
+  const { siteId, status } = args;
+
+  const params = new URLSearchParams({ siteId });
+  if (status) params.set('status', status);
+
+  const data = await apiClient.get(`/api/v1/grow-actions?${params.toString()}`);
+  const { activeActions, history, metrics } = data.data;
+  const meta = data.meta;
+
+  const lines = [
+    `## Grow Actions — ${meta.siteName}`,
+    `**Domain:** ${meta.domain} | **Done (All Time):** ${metrics.totalDone} | **Done (This Week):** ${metrics.doneThisWeek}\n`,
+  ];
+
+  // 1. Active Actions
+  lines.push('### 🎯 Active Actions (Today & Outstanding)');
+  if (!activeActions?.length) {
+    lines.push('_No active actions at the moment._\n');
+  } else {
+    activeActions.forEach((act) => {
+      const statusText = STATUS_EMOJI[act.status] || act.status;
+      lines.push(`\n**• ${act.title}** (${statusText})`);
+      lines.push(`  > ${act.description}`);
+      if (act.completedAt) {
+        lines.push(`  _Completed at: ${new Date(act.completedAt).toLocaleDateString()}_`);
+      }
+    });
+    lines.push('');
+  }
+
+  // 2. History
+  lines.push('### 📜 Action History (Last 30 Days)');
+  if (!history?.length) {
+    lines.push('_No history records found._');
+  } else {
+    history.forEach((act) => {
+      const statusText = STATUS_EMOJI[act.status] || act.status;
+      lines.push(`\n**• ${act.title}** (${statusText})`);
+      lines.push(`  > ${act.description}`);
+      if (act.completedAt) {
+        lines.push(`  _Completed at: ${new Date(act.completedAt).toLocaleDateString()}_`);
+      }
+    });
+  }
+
+  return { text: lines.join('\n') };
+}