@fil-technology/appmate-mcp 0.3.0 → 0.4.0

package/README.md

@@ -68,6 +68,14 @@ staging or self-hosted instances.
 | `publish_waitlist_flow` | Promote the waitlist draft live. |
 | `list_waitlist_signups` | Paginated list (cursor + nextCursor). |
 | `export_waitlist_csv` | Return the full waitlist as a CSV string. |
+| `get_feedback_flow` | Read published + draft feedback config. |
+| `update_feedback_draft` | Replace the feedback draft. |
+| `publish_feedback_flow` | Promote the feedback draft live. |
+| `list_feedback_submissions` | Paginated list of feedback rows (rating + message + email). |
+| `get_report_flow` | Read published + draft report config. |
+| `update_report_draft` | Replace the report draft (categorised). |
+| `publish_report_flow` | Promote the report draft live. |
+| `list_report_submissions` | Paginated, optional `category` filter. |
 
 Tools that accept an app reference (`get_app`, `update_cancel_draft`,
 etc.) accept either the cuid `id` or the human-readable `slug` — use

package/dist/tools.js

@@ -125,22 +125,50 @@ export const updateWaitlistDraft = {
     description: [
         "Replace the draft waitlist config. Body MUST be a full waitlist config object (type: 'waitlist').",
         "",
-        "Required shape:",
+        "The public URL at signup.appmate.cloud/{slug} renders a FULL landing",
+        "page — not just a form. The `hero` block drives the visual treatment;",
+        "omit it for the minimal/legacy look.",
+        "",
+        "Full shape:",
         "  {",
         "    type: 'waitlist',",
         "    intro: {",
-        "      title, subtitle,",
-        "      emailPlaceholder, submitLabel,",
-        "      legal? (small print, optional)",
+        "      title,            // h1 on the landing",
+        "      subtitle,         // lede paragraph",
+        "      emailPlaceholder, // input placeholder, e.g. 'you@example.com'",
+        "      submitLabel,      // button text, e.g. 'Notify me'",
+        "      legal?            // small print under the form (optional)",
         "    },",
         "    success: {",
-        "      title, body,",
-        "      ctaLabel?, ctaUrl?    // both-or-neither: ctaLabel without ctaUrl renders nothing",
-        "    }",
+        "      title, body,      // shown after signup",
+        "      ctaLabel?, ctaUrl?   // both-or-neither — partial pair renders nothing",
+        "    },",
+        "    hero?: {              // ALL fields optional; omit `hero` entirely for minimal",
+        "      theme?: 'minimal' | 'gradient' | 'dark' | 'side_by_side',",
+        "      eyebrow?: string,   // short chip above title, e.g. 'Coming soon · Q1 2026'",
+        "      accentColor?: string, // hex '#rrggbb'; tints button + chip + gradient blob",
+        "      bullets?: [           // 0–5 value-prop cards under the form",
+        "        { icon?: '✨', title: 'Fast', body?: 'Sub-second responses' }",
+        "      ],",
+        "      showCount?: boolean,  // renders '{N} on the waitlist' pill (hides if <3 signups)",
+        "      heroImage?: string,   // optional URL of a hero image",
+        "    },",
+        "    templateId?: string     // analytics tag if seeded from a template",
         "  }",
         "",
+        "Theme picker guide — pick from intent:",
+        "  - minimal       → no brand, conservative B2B. Default.",
+        "  - gradient      → marketing-launch energy. Pastel blobs + accent color.",
+        "  - dark          → premium / product-reveal vibe. Dark hero + accent glow.",
+        "  - side_by_side  → desktop-first 2-column (story left, form right).",
+        "                    Collapses to minimal on phone — fine for landing-pageiness.",
+        "",
+        "Starter templates available (see /examples?kind=waitlist):",
+        "  minimal_email_only, feature_tease, launching_soon, pro_upsell,",
+        "  private_beta, early_access_referral.",
+        "",
         "Server returns { ok:true, warnings: [...] } — check warnings before publishing.",
-        "Common: partial_cta (label without url, or vice versa).",
+        "Common warnings: partial_cta (label without url, or vice versa).",
     ].join("\n"),
     inputSchema: z.object({
         appIdOrSlug: z.string().min(1),
@@ -182,17 +210,166 @@ export const exportWaitlistCsv = {
         return { csv };
     },
 };
+// ─── Feedback flow ──────────────────────────────────────────────────────────
+export const getFeedbackFlow = {
+    name: "get_feedback_flow",
+    description: "Read the published and draft feedback flow configs for an app. Feedback flows host an open-ended message form (optional 1–5 star rating + optional reply email) at appmate.cloud/feedback/{appSlug}.",
+    inputSchema: z.object({ appIdOrSlug: z.string().min(1) }),
+    handler: (input, cfg) => apiFetch(cfg, "GET", `/api/v1/apps/${encodeURIComponent(input.appIdOrSlug)}/flows/feedback`),
+};
+export const updateFeedbackDraft = {
+    name: "update_feedback_draft",
+    description: [
+        "Replace the draft feedback config. Body MUST be a full feedback config object (type: 'feedback').",
+        "",
+        "Shape:",
+        "  {",
+        "    type: 'feedback',",
+        "    intro: {",
+        "      title, subtitle,",
+        "      messagePlaceholder,           // textarea placeholder",
+        "      submitLabel,",
+        "      legal?                        // small print under the form (optional)",
+        "    },",
+        "    rating?: {                      // OPTIONAL 1–5 star widget",
+        "      enabled: true,",
+        "      prompt?: 'How would you rate your experience?',",
+        "      required?: false              // when true, blocks submit until picked",
+        "    },",
+        "    emailField?: {                  // OPTIONAL reply-to email field",
+        "      enabled: true,",
+        "      placeholder?: 'you@example.com (optional)',",
+        "      required?: false",
+        "    },",
+        "    success: {",
+        "      title, body,",
+        "      ctaLabel?, ctaUrl?            // both-or-neither follow-up CTA",
+        "    },",
+        "    hero?: {                        // visual treatment, matches waitlist hero",
+        "      theme?: 'minimal' | 'gradient' | 'dark' | 'side_by_side',",
+        "      eyebrow?, accentColor?, titleFont?",
+        "    }",
+        "  }",
+        "",
+        "Server returns { ok:true, warnings: [] }. Warning rules will be added later — for now treat any non-empty array as advisory.",
+    ].join("\n"),
+    inputSchema: z.object({
+        appIdOrSlug: z.string().min(1),
+        config: z.unknown(),
+    }),
+    handler: (input, cfg) => apiFetch(cfg, "PUT", `/api/v1/apps/${encodeURIComponent(input.appIdOrSlug)}/flows/feedback`, input.config),
+};
+export const publishFeedbackFlow = {
+    name: "publish_feedback_flow",
+    description: "Promote the draft feedback config to the live published version. Visitors at appmate.cloud/feedback/{appSlug} see the new version immediately.",
+    inputSchema: z.object({ appIdOrSlug: z.string().min(1) }),
+    handler: (input, cfg) => apiFetch(cfg, "POST", `/api/v1/apps/${encodeURIComponent(input.appIdOrSlug)}/flows/feedback/publish`),
+};
+export const listFeedbackSubmissions = {
+    name: "list_feedback_submissions",
+    description: "Paginated list of feedback submissions for an app. Each row: { id, message, rating, email, source, createdAt }. limit max 200, default 50; pass nextCursor back for the next page.",
+    inputSchema: z.object({
+        appIdOrSlug: z.string().min(1),
+        limit: z.number().int().min(1).max(200).optional(),
+        cursor: z.string().optional(),
+    }),
+    handler: (input, cfg) => {
+        const qs = new URLSearchParams();
+        if (input.limit !== undefined)
+            qs.set("limit", String(input.limit));
+        if (input.cursor)
+            qs.set("cursor", input.cursor);
+        const tail = qs.toString() ? `?${qs.toString()}` : "";
+        return apiFetch(cfg, "GET", `/api/v1/apps/${encodeURIComponent(input.appIdOrSlug)}/feedback/submissions${tail}`);
+    },
+};
+// ─── Report flow ────────────────────────────────────────────────────────────
+export const getReportFlow = {
+    name: "get_report_flow",
+    description: "Read the published and draft report flow configs for an app. Report flows host a categorised bug/abuse/spam form (required category picker + message + optional reply email) at appmate.cloud/report/{appSlug}.",
+    inputSchema: z.object({ appIdOrSlug: z.string().min(1) }),
+    handler: (input, cfg) => apiFetch(cfg, "GET", `/api/v1/apps/${encodeURIComponent(input.appIdOrSlug)}/flows/report`),
+};
+export const updateReportDraft = {
+    name: "update_report_draft",
+    description: [
+        "Replace the draft report config. Body MUST be a full report config object (type: 'report').",
+        "",
+        "Shape:",
+        "  {",
+        "    type: 'report',",
+        "    intro: {",
+        "      title, subtitle,",
+        "      messagePlaceholder,           // textarea placeholder",
+        "      submitLabel,",
+        "      legal?                        // optional small print",
+        "    },",
+        "    categories: [                   // REQUIRED 1–10 entries",
+        "      { id: 'bug',   label: 'Bug or crash',       emoji?: '🐞', hint?: '…' },",
+        "      { id: 'abuse', label: 'Harassment or abuse', emoji?: '🚫' },",
+        "      { id: 'spam',  label: 'Spam',                emoji?: '🧹' },",
+        "      { id: 'privacy', label: 'Privacy concern',   emoji?: '🔒' },",
+        "      { id: 'other', label: 'Something else',      emoji?: '💬' }",
+        "    ],",
+        "    emailField?: { enabled, placeholder?, required? },",
+        "    success: { title, body, ctaLabel?, ctaUrl? },",
+        "    hero?: { theme?, eyebrow?, accentColor?, titleFont? }",
+        "  }",
+        "",
+        "Category ids must be snake_case ([a-z][a-z0-9_]*). The public submit endpoint validates posted category against this list — unknown ids return 422.",
+    ].join("\n"),
+    inputSchema: z.object({
+        appIdOrSlug: z.string().min(1),
+        config: z.unknown(),
+    }),
+    handler: (input, cfg) => apiFetch(cfg, "PUT", `/api/v1/apps/${encodeURIComponent(input.appIdOrSlug)}/flows/report`, input.config),
+};
+export const publishReportFlow = {
+    name: "publish_report_flow",
+    description: "Promote the draft report config to the live published version. Visitors at appmate.cloud/report/{appSlug} see the new version immediately.",
+    inputSchema: z.object({ appIdOrSlug: z.string().min(1) }),
+    handler: (input, cfg) => apiFetch(cfg, "POST", `/api/v1/apps/${encodeURIComponent(input.appIdOrSlug)}/flows/report/publish`),
+};
+export const listReportSubmissions = {
+    name: "list_report_submissions",
+    description: "Paginated list of report submissions for an app. Each row: { id, message, category, email, source, createdAt }. Pass `category` to scope to one bucket (e.g. 'bug') for triage.",
+    inputSchema: z.object({
+        appIdOrSlug: z.string().min(1),
+        limit: z.number().int().min(1).max(200).optional(),
+        cursor: z.string().optional(),
+        category: z.string().optional(),
+    }),
+    handler: (input, cfg) => {
+        const qs = new URLSearchParams();
+        if (input.limit !== undefined)
+            qs.set("limit", String(input.limit));
+        if (input.cursor)
+            qs.set("cursor", input.cursor);
+        if (input.category)
+            qs.set("category", input.category);
+        const tail = qs.toString() ? `?${qs.toString()}` : "";
+        return apiFetch(cfg, "GET", `/api/v1/apps/${encodeURIComponent(input.appIdOrSlug)}/report/submissions${tail}`);
+    },
+};
 // Registered alphabetically so `list_tools` reads predictably.
 export const ALL_TOOLS = [
     createApp,
     exportWaitlistCsv,
     getApp,
     getCancelFlow,
+    getFeedbackFlow,
+    getReportFlow,
     getWaitlistFlow,
     listApps,
+    listFeedbackSubmissions,
+    listReportSubmissions,
     listWaitlistSignups,
     publishCancelFlow,
+    publishFeedbackFlow,
+    publishReportFlow,
     publishWaitlistFlow,
     updateCancelDraft,
+    updateFeedbackDraft,
+    updateReportDraft,
     updateWaitlistDraft,
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fil-technology/appmate-mcp",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Model Context Protocol server for AppMate — lets Claude / Cursor / Codex drive your retention flows via API tokens.",
   "type": "module",
   "bin": {