@reynandaptr/replyto-mcp 0.1.1 → 0.2.1

package/README.md

@@ -23,6 +23,7 @@ Instagram automations from any MCP-capable AI client.
 
 ## Tools
 
-Products: list, get, create, update, delete, replace links.
-Automations: list, get, create, update, toggle, delete, preview conflicts, list runs.
+Products: list, get, update, delete, replace links.
+Automations: list, get, update, toggle, delete, preview conflicts, list runs.
 Lookups: stores, Instagram accounts, Instagram media.
+Analytics: aggregate metrics across bio, stores, products, short links, automations; account overview.

package/dist/client.js

@@ -8,6 +8,7 @@ export const err = (text) => ({ content: [{ type: "text", text }], isError: true
 const HINTS = {
     unauthorized: "Check that REPLYTO_API_KEY is a valid, non-revoked Replyto API key.",
     plan_upgrade_required: "API access requires a paid Replyto plan — upgrade in the Replyto dashboard.",
+    plan_required: "Analytics requires a plan with full analytics — upgrade in the Replyto dashboard.",
     email_unverified: "Verify your email address in the Replyto dashboard first.",
 };
 export class ReplytoClient {

package/dist/index.js

@@ -8,6 +8,7 @@ import { DEFAULT_BASE_URL } from "./config.js";
 import { productTools } from "./tools/products.js";
 import { automationTools } from "./tools/automations.js";
 import { lookupTools } from "./tools/lookups.js";
+import { analyticsTools } from "./tools/analytics.js";
 const apiKey = process.env.REPLYTO_API_KEY;
 if (!apiKey) {
     console.error("REPLYTO_API_KEY is not set.\n" +
@@ -15,8 +16,8 @@ if (!apiKey) {
     process.exit(1);
 }
 const client = new ReplytoClient(process.env.REPLYTO_URL ?? DEFAULT_BASE_URL, apiKey);
-const server = new McpServer({ name: "replyto", version: "0.1.0" });
-for (const def of [...productTools, ...automationTools, ...lookupTools]) {
+const server = new McpServer({ name: "replyto", version: "0.2.0" });
+for (const def of [...productTools, ...automationTools, ...lookupTools, ...analyticsTools]) {
     server.registerTool(def.name, { description: def.description, inputSchema: def.inputSchema, annotations: def.annotations }, (args) => def.handler(client, args ?? {}));
 }
 try {

package/dist/tools/analytics.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+const dims = ["time", "surface", "target", "platform", "source", "device", "kind"];
+export const analyticsTools = [
+    {
+        name: "aggregate_analytics",
+        description: "Aggregate event counts across the user's surfaces. metric=views (bio/store/product page views), " +
+            "clicks (bio_link/bio_social/product/short_link clicks), or automation_events (rule firings). " +
+            "group_by up to TWO of: time (bucket start; hourly for range=24h, daily 7d, weekly 30d, monthly 90d), " +
+            "surface, target (rows include a human label), platform (clicks), source (clicks; 'organic' = no campaign), " +
+            "device (views/clicks), kind (automation_events: reply_sent/dm_sent/dm_seen/error). " +
+            "Filters: surface, store_id, product_id (views/clicks), source (clicks), ig_account (automation_events). " +
+            "Cross-surface comparison: group_by=surface. Ranking: group_by=target. Time series: group_by=time. " +
+            "rows are capped at 500 (truncated flag set); total is the ungrouped count.",
+        inputSchema: {
+            metric: z.enum(["views", "clicks", "automation_events"]),
+            range: z.enum(["24h", "7d", "30d", "90d"]).optional(),
+            group_by: z.array(z.enum(dims)).max(2).optional(),
+            surface: z.string().optional().describe("views: bio|store|product; clicks: bio_link|bio_social|product|short_link"),
+            store_id: z.string().uuid().optional(),
+            product_id: z.string().uuid().optional(),
+            ig_account: z.string().optional().describe("Instagram handle (automation_events only)"),
+            source: z.string().optional().describe("clicks only, e.g. dm or organic"),
+        },
+        annotations: { readOnlyHint: true },
+        handler: (c, { group_by, ...rest }) => c.call("GET", "/analytics/aggregate", {
+            query: {
+                ...rest,
+                ...(Array.isArray(group_by) && group_by.length ? { group_by: group_by.join(",") } : {}),
+            },
+        }),
+    },
+    {
+        name: "get_overview",
+        description: "Account overview: replies/DMs sent with period-over-period deltas, DM open rate, automation counts, " +
+            "connected accounts, product counts, storefront views and product-click CTR (paid plans).",
+        inputSchema: {
+            range: z.enum(["7d", "30d", "90d"]).optional().describe("Defaults to 7d"),
+        },
+        annotations: { readOnlyHint: true },
+        handler: (c, a) => c.call("GET", "/overview", { query: a }),
+    },
+];

package/dist/tools/automations.js

@@ -40,13 +40,6 @@ export const automationTools = [
         annotations: { readOnlyHint: true },
         handler: (c, { id }) => c.call("GET", `/automations/${id}`),
     },
-    {
-        name: "create_automation",
-        description: "Create an Instagram auto-reply/DM rule. On a 409 the response lists conflicting rules — " +
-            "adjust keyword/scope/accounts or ask the user. Consider preview_automation_conflicts first.",
-        inputSchema: ruleFields,
-        handler: (c, a) => c.call("POST", "/automations", { body: a }),
-    },
     {
         name: "update_automation",
         description: "Update rule fields by id. Only send the fields to change.",
@@ -71,7 +64,7 @@ export const automationTools = [
     },
     {
         name: "preview_automation_conflicts",
-        description: "Dry-run conflict check for a prospective rule — returns conflicting existing rules without creating anything. " +
+        description: "Dry-run conflict check for a prospective rule configuration — returns conflicting existing rules without changing anything. " +
             "Pass exclude_id when checking an edit to an existing rule.",
         inputSchema: {
             trigger: ruleFields.trigger,

package/dist/tools/products.js

@@ -8,6 +8,7 @@ const linkInput = {
     price: z.number().int().optional().describe("Current price in integer rupiah (no decimals)"),
     original: z.number().int().optional().describe("Pre-discount price in integer rupiah; omit if no discount"),
     label: z.string().optional().describe("Optional badge label shown on the button, e.g. 'Official Store'"),
+    display_name: z.string().optional().describe("Display name shown instead of the platform label, e.g. 'Toko Utama Jakarta'"),
 };
 const productFields = {
     slug: z.string().describe("URL slug for the public product page (/p/<slug>). Lowercase, hyphenated."),
@@ -44,13 +45,6 @@ export const productTools = [
         annotations: { readOnlyHint: true },
         handler: (c, { id }) => c.call("GET", `/products/${id}`),
     },
-    {
-        name: "create_product",
-        description: "Create a product. mode=platforms needs links[] (marketplace buttons); mode=redirect needs redirect_url. " +
-            "The API auto-creates short links and returns their click URLs.",
-        inputSchema: productFields,
-        handler: (c, a) => c.call("POST", "/products", { body: a }),
-    },
     {
         name: "update_product",
         description: "Update product fields by id. Only send the fields to change. Links are managed via replace_product_links.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reynandaptr/replyto-mcp",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "MCP server for Replyto — manage your products and Instagram automations from any AI client",
   "license": "MIT",
   "type": "module",