atracker-mcp-server 1.1.1 → 1.2.0

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "atracker-mcp-server",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "MCP Server for ATracker self-hosted ad tracker",
   "type": "module",
   "bin": {
     "atracker-mcp-server": "./src/index.js"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "files": [
     "src"
   ],

package/src/index.js

@@ -12,6 +12,8 @@ import { registerReportTools } from './tools/reports.js';
 import { registerStatusTools } from './tools/status.js';
 import { registerSettingsTools } from './tools/settings.js';
 import { registerGeoTools } from './tools/geo.js';
+import { registerInsightsTools } from './tools/insights.js';
+import { registerFunnelTools } from './tools/funnels.js';
 
 const url = process.env.ATRACKER_URL;
 const token = process.env.ATRACKER_TOKEN;
@@ -27,7 +29,7 @@ const client = createClient(url, token);
 
 const server = new McpServer({
   name: 'atracker',
-  version: '1.1.1',
+  version: '1.2.0',
 });
 
 registerCampaignTools(server, client);
@@ -40,6 +42,8 @@ registerReportTools(server, client);
 registerStatusTools(server, client);
 registerSettingsTools(server, client);
 registerGeoTools(server, client);
+registerInsightsTools(server, client);
+registerFunnelTools(server, client);
 
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/src/tools/funnels.js

@@ -0,0 +1,113 @@
+import { defineTool, jsonText } from '../util.js';
+
+export function registerFunnelTools(server, client) {
+  // ── Registry ──
+  defineTool(server, 'get_funnel_registry', 'Get funnel registry: available modes, steps, breakdowns, filter fields.', {}, async () => {
+    const data = await client.get('/funnels/registry');
+    return jsonText(data);
+  });
+
+  // ── Query ──
+  defineTool(server, 'execute_funnel_query', 'Execute a funnel visualization query. Analyze drop-off and conversion rates between steps.', {
+    mode: { type: 'string', description: 'Funnel mode: status, path, or events.', enum: ['status', 'path', 'events'] },
+    steps: { type: 'string', description: 'JSON array of step names (status mode: click,lead,sale,rebill; path mode: traffic_source,campaign,flow,landing_page,offer,conversion; events mode: [{"table":"clicks","field":"country_code","value":"US"},...])' },
+    range_key: { type: 'string', description: 'Time range key. Default: 7d.', enum: ['today', 'yesterday', '7d', '14d', '21d', '1m'], default: '7d' },
+    filters: { type: 'string', description: 'JSON array of filters: [{"field":"campaign_id","operator":"in","value":["uuid1","uuid2"]}] (optional)' },
+    breakdown: { type: 'string', description: 'Breakdown field (e.g. campaign_id) for segmented results (optional)' },
+    visualization: { type: 'string', description: 'Chart type: bars, funnel, horizontal, sankey, table, trend, segmented. Default: bars.', default: 'bars' },
+  }, async ({ mode, steps, range_key, filters, breakdown, visualization }) => {
+    let parsedSteps;
+    try { parsedSteps = JSON.parse(steps || '[]'); } catch { parsedSteps = []; }
+    let parsedFilters;
+    try { parsedFilters = JSON.parse(filters || '[]'); } catch { parsedFilters = []; }
+
+    const body = {
+      mode,
+      steps: parsedSteps,
+      range_key: range_key || '7d',
+      filters: parsedFilters,
+      breakdown: breakdown || undefined,
+      visualization: visualization || 'bars',
+    };
+    const data = await client.post('/funnels/query', body);
+    return jsonText(data);
+  });
+
+  // ── Trends ──
+  defineTool(server, 'execute_funnel_trends', 'Execute funnel trends over time. Shows how each step performs day-by-day, hour-by-hour, or week-by-week.', {
+    mode: { type: 'string', description: 'Funnel mode: status, path, or events.', enum: ['status', 'path', 'events'] },
+    steps: { type: 'string', description: 'JSON array of step names (same format as query)' },
+    range_key: { type: 'string', description: 'Time range key. Default: 7d.', enum: ['today', 'yesterday', '7d', '14d', '21d', '1m'], default: '7d' },
+    filters: { type: 'string', description: 'JSON array of filters (optional)' },
+    time_grain: { type: 'string', description: 'Time granularity: hour, day, week. Default: day.', enum: ['hour', 'day', 'week'], default: 'day' },
+  }, async ({ mode, steps, range_key, filters, time_grain }) => {
+    let parsedSteps;
+    try { parsedSteps = JSON.parse(steps || '[]'); } catch { parsedSteps = []; }
+    let parsedFilters;
+    try { parsedFilters = JSON.parse(filters || '[]'); } catch { parsedFilters = []; }
+
+    const body = {
+      mode,
+      steps: parsedSteps,
+      range_key: range_key || '7d',
+      filters: parsedFilters,
+      time_grain: time_grain || 'day',
+    };
+    const data = await client.post('/funnels/trends', body);
+    return jsonText(data);
+  });
+
+  // ── Presets ──
+  defineTool(server, 'list_funnel_presets', 'List saved funnel presets for the account.', {}, async () => {
+    const data = await client.get('/funnels/presets');
+    return jsonText(data);
+  });
+
+  defineTool(server, 'create_funnel_preset', 'Save a new funnel preset (configuration).', {
+    name: { type: 'string', description: 'Preset name' },
+    config: { type: 'string', description: 'JSON funnel config: {mode, steps, filters, breakdown, visualization, range_key}' },
+    description: { type: 'string', description: 'Optional description' },
+  }, async ({ name, config, description }) => {
+    let parsedConfig;
+    try { parsedConfig = JSON.parse(config || '{}'); } catch { parsedConfig = {}; }
+
+    const row = await client.post('/funnels/presets', {
+      name,
+      config: parsedConfig,
+      description: description || '',
+    });
+    return jsonText(row);
+  });
+
+  defineTool(server, 'update_funnel_preset', 'Update an existing funnel preset.', {
+    id: { type: 'string', description: 'Preset UUID' },
+    name: { type: 'string', description: 'New name (optional)' },
+    config: { type: 'string', description: 'New JSON funnel config (optional)' },
+    description: { type: 'string', description: 'New description (optional)' },
+  }, async ({ id, name, config, description }) => {
+    const body = {};
+    if (name !== undefined) body.name = name;
+    if (description !== undefined) body.description = description;
+    if (config !== undefined) {
+      let parsedConfig;
+      try { parsedConfig = JSON.parse(config); } catch { parsedConfig = config; }
+      body.config = parsedConfig;
+    }
+    const row = await client.patch(`/funnels/presets/${id}`, body);
+    return jsonText(row);
+  });
+
+  defineTool(server, 'delete_funnel_preset', 'Delete a funnel preset.', {
+    id: { type: 'string', description: 'Preset UUID' },
+  }, async ({ id }) => {
+    await client.del(`/funnels/presets/${id}`);
+    return { content: [{ type: 'text', text: 'Funnel preset deleted.' }] };
+  });
+
+  defineTool(server, 'share_funnel_preset', 'Generate a share link for a funnel preset.', {
+    id: { type: 'string', description: 'Preset UUID' },
+  }, async ({ id }) => {
+    const data = await client.post(`/funnels/presets/${id}/share`);
+    return jsonText(data);
+  });
+}

package/src/tools/insights.js

@@ -0,0 +1,11 @@
+import { defineTool, jsonText } from '../util.js';
+
+export function registerInsightsTools(server, client) {
+  defineTool(server, 'get_insights', 'Get AI-powered campaign insights and recommendations. Uses the configured AI provider to analyze click/conversion data for the selected time range.', {
+    mode: { type: 'string', description: 'Analysis mode: "ai" (LLM) or "offline" (rule-based). Default: "ai".', enum: ['ai', 'offline'], default: 'ai' },
+    range: { type: 'string', description: 'Time range key: today, yesterday, 7d, 14d, 21d, 1m. Default: 7d.', enum: ['today', 'yesterday', '7d', '14d', '21d', '1m'], default: '7d' },
+  }, async ({ mode, range }) => {
+    const data = await client.post('/insights/analyze', { mode: mode || 'ai', range: range || '7d' });
+    return jsonText(data);
+  });
+}

package/src/tools/settings.js

@@ -26,4 +26,14 @@ export function registerSettingsTools(server, client) {
     const data = await client.put('/settings', items);
     return jsonText(data);
   });
+
+  defineTool(server, 'get_global_postback', 'Get global postback URL and installation token (resolves campaign from subid).', {}, async () => {
+    const data = await client.get('/global-postback');
+    return jsonText(data);
+  });
+
+  defineTool(server, 'regenerate_global_postback_token', 'Regenerate global postback token. The old global postback URL stops working.', {}, async () => {
+    const data = await client.post('/global-postback/regenerate');
+    return jsonText(data);
+  });
 }