@ascendkit/cli 0.1.10

package/dist/index.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { AscendKitClient } from "./api/client.js";
+import { registerAuthTools } from "./tools/auth.js";
+import { registerContentTools } from "./tools/content.js";
+import { registerSurveyTools } from "./tools/surveys.js";
+const args = process.argv.slice(2);
+const publicKey = args[0];
+const apiUrl = args[1] ?? process.env.ASCENDKIT_API_URL ?? "http://localhost:8000";
+if (!publicKey) {
+    console.error("Usage: ascendkit-mcp <public-key> [api-url]");
+    console.error("  public-key  Your project's public key (pk_live_...)");
+    console.error("  api-url     AscendKit API URL (default: http://localhost:8000)");
+    process.exit(1);
+}
+const client = new AscendKitClient({ apiUrl, publicKey });
+const server = new McpServer({
+    name: "ascendkit",
+    version: "0.1.0",
+});
+registerAuthTools(server, client);
+registerContentTools(server, client);
+registerSurveyTools(server, client);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);

package/dist/mcp.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/mcp.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { AscendKitClient } from "./api/client.js";
+import { registerAuthTools } from "./tools/auth.js";
+import { registerContentTools } from "./tools/content.js";
+import { registerSurveyTools } from "./tools/surveys.js";
+import { registerPlatformTools } from "./tools/platform.js";
+import { registerEmailTools } from "./tools/email.js";
+import { registerJourneyTools } from "./tools/journeys.js";
+import { registerWebhookTools } from "./tools/webhooks.js";
+const client = new AscendKitClient({
+    apiUrl: process.env.ASCENDKIT_API_URL ?? "https://api.ascendkit.com",
+});
+const server = new McpServer({
+    name: "ascendkit",
+    version: "0.1.0",
+});
+server.tool("ascendkit_configure", "Configure AscendKit with your project's public key. Must be called before using any other AscendKit tools.", {
+    publicKey: z.string().describe("Your project's public key (pk_dev_..., pk_beta_..., or pk_prod_...)"),
+    apiUrl: z.string().optional().describe("AscendKit API URL (default: https://api.ascendkit.com)"),
+}, async (params) => {
+    client.configure(params.publicKey, params.apiUrl);
+    return {
+        content: [{ type: "text", text: `Configured for project ${params.publicKey}` }],
+    };
+});
+registerPlatformTools(server, client);
+registerAuthTools(server, client);
+registerContentTools(server, client);
+registerSurveyTools(server, client);
+registerEmailTools(server, client);
+registerJourneyTools(server, client);
+registerWebhookTools(server, client);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);

package/dist/tools/auth.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AscendKitClient } from "../api/client.js";
+export declare function registerAuthTools(server: McpServer, client: AscendKitClient): void;

package/dist/tools/auth.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import * as auth from "../commands/auth.js";
+export function registerAuthTools(server, client) {
+    server.tool("auth_get_settings", "Get authentication settings for the current project (enabled providers, features, OAuth configs)", {}, async () => {
+        const data = await auth.getSettings(client);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("auth_update_settings", "Update authentication settings: providers, features, session duration. Credentials and magic-link are mutually exclusive. Social-only login is valid. emailVerification, passwordReset, requireUsername only apply when credentials is active; waitlist applies to all modes.", {
+        providers: z
+            .array(z.string())
+            .optional()
+            .describe('Enabled auth providers, e.g. ["credentials", "google", "github"]'),
+        features: z
+            .object({
+            emailVerification: z.boolean().optional(),
+            waitlist: z.boolean().optional(),
+            passwordReset: z.boolean().optional(),
+            requireUsername: z.boolean().optional(),
+        })
+            .optional()
+            .describe("Feature toggles for auth"),
+        sessionDuration: z
+            .string()
+            .optional()
+            .describe('Session duration, e.g. "7d", "24h"'),
+    }, async (params) => {
+        const data = await auth.updateSettings(client, params);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("auth_update_providers", "Set which auth providers are enabled for the project. Credentials and magic-link are mutually exclusive. Social-only login (e.g. [\"google\"]) is valid. At least one provider required.", {
+        providers: z
+            .array(z.string())
+            .describe('List of provider names, e.g. ["credentials", "google", "github"]'),
+    }, async (params) => {
+        const data = await auth.updateProviders(client, params.providers);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("auth_setup_oauth", "Configure OAuth credentials for a provider. Pass clientId and clientSecret to set credentials directly, or omit them to get a portal URL for browser-based entry. Note: credentials in tool args may appear in logs — use the portal URL for sensitive environments.", {
+        provider: z.string().describe('OAuth provider name, e.g. "google", "github"'),
+        clientId: z.string().optional().describe("OAuth client ID (to set credentials directly)"),
+        clientSecret: z.string().optional().describe("OAuth client secret (to set credentials directly)"),
+        callbackUrl: z.string().optional().describe("Auth callback URL for this provider"),
+    }, async (params) => {
+        if ((params.clientId && !params.clientSecret) || (!params.clientId && params.clientSecret)) {
+            return {
+                content: [{
+                        type: "text",
+                        text: "Both clientId and clientSecret are required to set credentials directly.",
+                    }],
+                isError: true,
+            };
+        }
+        if (params.clientId && params.clientSecret) {
+            const data = await auth.updateOAuthCredentials(client, params.provider, params.clientId, params.clientSecret, params.callbackUrl);
+            return {
+                content: [{
+                        type: "text",
+                        text: `OAuth credentials saved for ${params.provider}.\n\n${JSON.stringify(data, null, 2)}`,
+                    }],
+            };
+        }
+        const portalUrl = process.env.ASCENDKIT_PORTAL_URL ?? "http://localhost:3000";
+        const url = auth.getOAuthSetupUrl(portalUrl, params.provider, client.currentPublicKey ?? undefined);
+        return {
+            content: [{
+                    type: "text",
+                    text: `Open this URL in your browser to configure ${params.provider} OAuth credentials:\n\n${url}\n\nFor sensitive environments, enter credentials through the browser portal.`,
+                }],
+        };
+    });
+    server.tool("auth_list_users", "List all project users (end-users who signed up via the SDK)", {}, async () => {
+        const data = await auth.listUsers(client);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+}

package/dist/tools/content.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AscendKitClient } from "../api/client.js";
+export declare function registerContentTools(server: McpServer, client: AscendKitClient): void;

package/dist/tools/content.js

@@ -0,0 +1,64 @@
+import { z } from "zod";
+import * as content from "../commands/content.js";
+export function registerContentTools(server, client) {
+    server.tool("content_create_template", "Create a new email content template with HTML and plain-text versions. Supports {{variable}} placeholders.", {
+        name: z.string().describe("Template name, e.g. 'welcome-email'"),
+        subject: z.string().describe("Email subject line"),
+        bodyHtml: z.string().describe("HTML email body. Use {{variable}} for placeholders"),
+        bodyText: z.string().describe("Plain-text email body. Use {{variable}} for placeholders"),
+        slug: z.string().optional().describe("URL-safe identifier for programmatic lookup, e.g. 'welcome-email'"),
+        description: z.string().optional().describe("Template description"),
+    }, async (params) => {
+        const data = await content.createTemplate(client, params);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("content_list_templates", "List all content templates for the current project", {
+        query: z.string().optional().describe("Search templates by name, slug, or description"),
+        isSystem: z.boolean().optional().describe("Filter: true for system templates, false for custom"),
+    }, async (params) => {
+        const listParams = (params.query || params.isSystem !== undefined)
+            ? { query: params.query, isSystem: params.isSystem }
+            : undefined;
+        const data = await content.listTemplates(client, listParams);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("content_get_template", "Get a content template by ID, including current version body and variables", {
+        templateId: z.string().describe("Template ID (tpl_ prefixed)"),
+    }, async (params) => {
+        const data = await content.getTemplate(client, params.templateId);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("content_update_template", "Update a content template. Creates a new immutable version — previous versions are preserved for result tracking.", {
+        templateId: z.string().describe("Template ID (tpl_ prefixed)"),
+        subject: z.string().optional().describe("New email subject line"),
+        bodyHtml: z.string().optional().describe("New HTML email body"),
+        bodyText: z.string().optional().describe("New plain-text email body"),
+        changeNote: z
+            .string()
+            .optional()
+            .describe("Note describing what changed in this version"),
+    }, async (params) => {
+        const { templateId, ...rest } = params;
+        const data = await content.updateTemplate(client, templateId, rest);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("content_delete_template", "Delete a content template and all its versions", {
+        templateId: z.string().describe("Template ID (tpl_ prefixed)"),
+    }, async (params) => {
+        const data = await content.deleteTemplate(client, params.templateId);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("content_list_versions", "List all versions of a content template (newest first)", {
+        templateId: z.string().describe("Template ID (tpl_ prefixed)"),
+    }, async (params) => {
+        const data = await content.listVersions(client, params.templateId);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("content_get_version", "Get a specific version of a content template", {
+        templateId: z.string().describe("Template ID (tpl_ prefixed)"),
+        versionNumber: z.number().describe("Version number to retrieve"),
+    }, async (params) => {
+        const data = await content.getVersion(client, params.templateId, params.versionNumber);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+}

package/dist/tools/email.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AscendKitClient } from "../api/client.js";
+export declare function registerEmailTools(server: McpServer, client: AscendKitClient): void;

package/dist/tools/email.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import * as email from "../commands/email.js";
+export function registerEmailTools(server, client) {
+    server.tool("email_get_settings", "Get email settings (sender address, domain, verification status)", {}, async () => {
+        const data = await email.getSettings(client);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("email_update_settings", "Update email sender settings (fromEmail, fromName)", {
+        fromEmail: z.string().optional().describe("Sender email address"),
+        fromName: z.string().optional().describe("Sender display name"),
+    }, async (params) => {
+        const data = await email.updateSettings(client, params);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("email_setup_domain", "Initiate domain verification for email sending. Returns DNS records, detected DNS provider details, and guided setup links.", {
+        domain: z.string().describe("Domain to verify (e.g. 'myapp.com')"),
+        dnsProvider: z
+            .string()
+            .optional()
+            .describe("Optional preferred DNS provider hint, e.g. 'cloudflare'."),
+    }, async (params) => {
+        const data = await email.setupDomain(client, params.domain);
+        // Manual DNS setup — show records for copy-paste
+        const records = data.dnsRecords ?? [];
+        const formatted = records.map((r) => `  ${r.type}\t${r.name}\t→\t${r.value}`).join("\n");
+        const provider = data.dnsProvider;
+        const providerLine = provider?.name
+            ? `Detected provider: ${provider.name} (${provider.confidence ?? "unknown"})\n`
+            : "";
+        const portalLine = provider?.portalUrl
+            ? `Provider console: ${provider.portalUrl}\n`
+            : "";
+        const guidedLine = provider?.assistantSetupUrl
+            ? `Guided setup: ${provider.assistantSetupUrl}\n`
+            : "";
+        return {
+            content: [{
+                    type: "text",
+                    text: `Domain ${params.domain} identity created in SES.\n\n${providerLine}${portalLine}${guidedLine}\nAdd these DNS records to your domain:\n${formatted}\n\nAfter adding the records, use email_check_domain_status to poll for verification.`,
+                }],
+        };
+    });
+    server.tool("email_get_dns_provider", "Detect DNS provider for a domain and return provider dashboard links", {
+        domain: z.string().optional().describe("Domain to detect; defaults to configured email domain"),
+    }, async (params) => {
+        const data = await email.getDnsProvider(client, params.domain);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("email_check_domain_status", "Poll SES verification status for your configured domain", {}, async () => {
+        const data = await email.checkDomainStatus(client);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("email_remove_domain", "Remove domain and reset to default AscendKit sender", {}, async () => {
+        const data = await email.removeDomain(client);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+}

package/dist/tools/journeys.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AscendKitClient } from "../api/client.js";
+export declare function registerJourneyTools(server: McpServer, client: AscendKitClient): void;

package/dist/tools/journeys.js

@@ -0,0 +1,302 @@
+import { z } from "zod";
+import * as journeys from "../commands/journeys.js";
+import { parseDelay } from "../utils/duration.js";
+import { formatJourneyAnalytics, formatJourneyList, formatJourneyWithGuidance, formatNodeList, formatSingleNode, formatTransitionList, formatSingleTransition, } from "../utils/journey-format.js";
+export function registerJourneyTools(server, client) {
+    server.tool("journey_create", "Create a new user lifecycle journey. Journeys start in 'draft' status. Minimal create: just name + entryEvent + entryNode (entry node auto-created as a 'none' action placeholder). Add nodes and transitions incrementally with journey_add_node and journey_add_transition. Lifecycle: create → add nodes/transitions → activate → users enroll on entryEvent.", {
+        name: z.string().describe("Journey name, e.g. 'Onboarding Flow'"),
+        entryEvent: z
+            .string()
+            .describe("Event that triggers enrollment, e.g. 'user.created'"),
+        entryNode: z
+            .string()
+            .describe("Name of the first node users enter"),
+        nodes: z
+            .record(z.record(z.unknown()))
+            .optional()
+            .describe("Map of node names to definitions. Each node has 'action' ({type, templateSlug?, surveySlug?, tagName?, stageName?}) and optional 'terminal' (boolean). If omitted, the entry node is auto-created as a 'none' action placeholder."),
+        transitions: z
+            .array(z.record(z.unknown()))
+            .optional()
+            .describe("List of transitions. Each has 'from', 'to', 'trigger' ({type: 'event'|'timer', event?, delay?}), optional 'priority'"),
+        description: z.string().optional().describe("Journey description"),
+        entryConditions: z
+            .record(z.unknown())
+            .optional()
+            .describe("Filter on the entry event payload, e.g. {provider: 'credentials'}"),
+        reEntryPolicy: z
+            .enum(["skip", "restart"])
+            .optional()
+            .describe("What happens if a user triggers the entry event again: 'skip' (ignore) or 'restart' (re-enroll)"),
+    }, async (params) => {
+        const data = await journeys.createJourney(client, params);
+        const formatted = formatJourneyWithGuidance(data);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+    server.tool("journey_list", "List all journeys for the current project. Optionally filter by status (draft, active, paused, archived).", {
+        status: z
+            .enum(["draft", "active", "paused", "archived"])
+            .optional()
+            .describe("Filter by journey status"),
+        limit: z.number().optional().describe("Max results (default 50)"),
+        offset: z.number().optional().describe("Pagination offset"),
+    }, async (params) => {
+        const data = await journeys.listJourneys(client, params);
+        const formatted = formatJourneyList(data);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+    server.tool("journey_get", "Get a journey by ID with full definition (nodes, transitions) and current stats (enrolled, active, completed).", {
+        journeyId: z.string().describe("Journey ID (jrn_ prefixed)"),
+    }, async (params) => {
+        const data = await journeys.getJourney(client, params.journeyId);
+        const formatted = formatJourneyWithGuidance(data);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+    server.tool("journey_update", "Update a journey definition. Only provided fields are changed. Re-validates the full definition after merge. Cannot update archived journeys.", {
+        journeyId: z.string().describe("Journey ID (jrn_ prefixed)"),
+        name: z.string().optional().describe("New journey name"),
+        description: z.string().optional().describe("New description"),
+        entryEvent: z.string().optional().describe("New entry event"),
+        entryNode: z.string().optional().describe("New entry node name"),
+        entryConditions: z
+            .record(z.unknown())
+            .optional()
+            .describe("New entry conditions filter"),
+        reEntryPolicy: z
+            .enum(["skip", "restart"])
+            .optional()
+            .describe("New re-entry policy"),
+        nodes: z
+            .record(z.record(z.unknown()))
+            .optional()
+            .describe("Updated node definitions"),
+        transitions: z
+            .array(z.record(z.unknown()))
+            .optional()
+            .describe("Updated transitions"),
+    }, async (params) => {
+        const { journeyId, ...rest } = params;
+        const data = await journeys.updateJourney(client, journeyId, rest);
+        const formatted = formatJourneyWithGuidance(data);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+    server.tool("journey_delete", "Delete a journey and all associated user states. This is permanent.", {
+        journeyId: z.string().describe("Journey ID (jrn_ prefixed)"),
+    }, async (params) => {
+        await journeys.deleteJourney(client, params.journeyId);
+        return {
+            content: [{ type: "text", text: `Deleted journey ${params.journeyId}.` }],
+        };
+    });
+    // --- Lifecycle tools ---
+    server.tool("journey_activate", "Activate a journey (draft → active). Once active, users are automatically enrolled when the entry event fires.", {
+        journeyId: z.string().describe("Journey ID (jrn_ prefixed)"),
+    }, async (params) => {
+        const data = await journeys.activateJourney(client, params.journeyId);
+        const formatted = formatJourneyWithGuidance(data);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+    server.tool("journey_pause", "Pause an active journey. Users stay at their current nodes but actions are queued instead of executed. Transitions still occur.", {
+        journeyId: z.string().describe("Journey ID (jrn_ prefixed)"),
+    }, async (params) => {
+        const data = await journeys.pauseJourney(client, params.journeyId);
+        const formatted = formatJourneyWithGuidance(data);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+    server.tool("journey_archive", "Archive a journey. All active users are exited. No further enrollment or transitions. This cannot be undone.", {
+        journeyId: z.string().describe("Journey ID (jrn_ prefixed)"),
+    }, async (params) => {
+        const data = await journeys.archiveJourney(client, params.journeyId);
+        const formatted = formatJourneyWithGuidance(data);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+    // --- Analytics tools ---
+    server.tool("journey_analytics", "Get journey analytics: user counts per node, conversion rates per transition, time-in-node metrics, terminal distribution, and totals (enrolled/active/completed/failed).", {
+        journeyId: z.string().describe("Journey ID (jrn_ prefixed)"),
+    }, async (params) => {
+        const data = await journeys.getJourneyAnalytics(client, params.journeyId);
+        const formatted = formatJourneyAnalytics(data);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+    // --- Granular node tools ---
+    server.tool("journey_list_nodes", "List all nodes in a journey with their actions, terminal status, and transition counts. Use this to inspect the journey graph before making changes.", {
+        journeyId: z.string().describe("Journey ID (jrn_ prefixed)"),
+    }, async (params) => {
+        const data = await journeys.listNodes(client, params.journeyId);
+        const formatted = formatNodeList(data);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+    server.tool("journey_add_node", "Add a node to a journey. Nodes define what happens at each step: send_email (with optional surveySlug), tag_user, advance_stage, or none (wait/branching). Node name is the stable identifier used in transitions.", {
+        journeyId: z.string().describe("Journey ID (jrn_ prefixed)"),
+        name: z
+            .string()
+            .describe("Node name (stable identifier, e.g. 'welcome_email', 'nudge_1')"),
+        action: z
+            .object({
+            type: z.enum(["send_email", "tag_user", "advance_stage", "none"]).describe("Action type"),
+            templateSlug: z.string().optional().describe("Email template slug (for send_email)"),
+            surveySlug: z.string().optional().describe("Survey slug to include in email (for send_email)"),
+            tagName: z.string().optional().describe("Tag to add (for tag_user)"),
+            stageName: z.string().optional().describe("Stage to set (for advance_stage)"),
+        })
+            .optional()
+            .describe("Action to execute when a user enters this node. Defaults to {type: 'none'}."),
+        terminal: z
+            .boolean()
+            .default(false)
+            .describe("Whether this is a terminal node (journey ends here for the user)"),
+    }, async (params) => {
+        const { journeyId, ...rest } = params;
+        const data = await journeys.addNode(client, journeyId, rest);
+        const formatted = formatSingleNode(data, "Added", params.name);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+    server.tool("journey_edit_node", "Update a node's action or terminal flag by name. Only provided fields are changed. To clear an action, set type to 'none'. Removing templateSlug also removes surveySlug (survey rides on email).", {
+        journeyId: z.string().describe("Journey ID (jrn_ prefixed)"),
+        nodeName: z.string().describe("Name of the node to edit"),
+        action: z
+            .object({
+            type: z.enum(["send_email", "tag_user", "advance_stage", "none"]).describe("Action type"),
+            templateSlug: z.string().optional().describe("Email template slug"),
+            surveySlug: z.string().optional().describe("Survey slug to include in email"),
+            tagName: z.string().optional().describe("Tag to add"),
+            stageName: z.string().optional().describe("Stage to set"),
+        })
+            .optional()
+            .describe("New action definition (replaces the entire action)"),
+        terminal: z
+            .boolean()
+            .optional()
+            .describe("Whether this is a terminal node"),
+    }, async (params) => {
+        const { journeyId, nodeName, ...rest } = params;
+        const data = await journeys.editNode(client, journeyId, nodeName, rest);
+        const formatted = formatSingleNode(data, "Updated", nodeName);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+    server.tool("journey_remove_node", "Remove a node from a journey by name. All transitions to/from this node are automatically deleted (cascade). Users currently at this node are exited. This is permanent.", {
+        journeyId: z.string().describe("Journey ID (jrn_ prefixed)"),
+        nodeName: z.string().describe("Name of the node to remove"),
+    }, async (params) => {
+        const data = await journeys.removeNode(client, params.journeyId, params.nodeName);
+        const formatted = formatSingleNode(data, "Removed", params.nodeName);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+    // --- Granular transition tools ---
+    server.tool("journey_list_transitions", "List all transitions in a journey. Shows 'from → to' with trigger type (on event / after delay). Filterable by source or target node.", {
+        journeyId: z.string().describe("Journey ID (jrn_ prefixed)"),
+        from_node: z.string().optional().describe("Filter by source node name"),
+        to_node: z.string().optional().describe("Filter by target node name"),
+    }, async (params) => {
+        const { journeyId, ...opts } = params;
+        const data = await journeys.listTransitions(client, journeyId, opts);
+        const formatted = formatTransitionList(data);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+    server.tool("journey_add_transition", "Add a transition between two nodes. Use 'on' for event triggers (e.g. on: 'user.login') or 'after' for delays (e.g. after: '3 day', '12 hr', '30 m', '2 week'). Bare numbers default to minutes. Also accepts the structured 'trigger' object. Transition name is auto-generated from '{from}-to-{to}' if not provided.", {
+        journeyId: z.string().describe("Journey ID (jrn_ prefixed)"),
+        from: z.string().describe("Source node name"),
+        to: z.string().describe("Target node name"),
+        on: z
+            .string()
+            .optional()
+            .describe("Event that triggers this transition, e.g. 'user.login'. Shorthand for trigger: {type: 'event', event: ...}"),
+        after: z
+            .string()
+            .optional()
+            .describe("Delay before transition fires, e.g. '3 day', '12 hr', '30 m', '2 week'. Bare number = minutes. Shorthand for trigger: {type: 'timer', delay: ...}"),
+        trigger: z
+            .object({
+            type: z.enum(["event", "timer"]).describe("Trigger type: 'event' for on-event, 'timer' for after-delay"),
+            event: z.string().optional().describe("Event name (for type 'event'), e.g. 'user.login'"),
+            delay: z.string().optional().describe("Delay duration (for type 'timer'), e.g. '3d', '12h'"),
+        })
+            .optional()
+            .describe("Structured trigger object (alternative to on/after shorthand)"),
+        priority: z
+            .number()
+            .optional()
+            .describe("Priority for ambiguous transitions (lower = higher priority)"),
+        name: z
+            .string()
+            .optional()
+            .describe("Transition name (auto-generated from '{from}-to-{to}' if omitted)"),
+    }, async (params) => {
+        const { journeyId, on: onEvent, after, trigger: rawTrigger, ...rest } = params;
+        // Resolve trigger: on/after shorthand takes precedence over structured trigger
+        let trigger;
+        if (onEvent) {
+            trigger = { type: "event", event: onEvent };
+        }
+        else if (after) {
+            trigger = { type: "timer", delay: parseDelay(after) };
+        }
+        else if (rawTrigger) {
+            trigger = rawTrigger;
+            if (trigger.type === "timer" && trigger.delay) {
+                trigger.delay = parseDelay(trigger.delay);
+            }
+        }
+        else {
+            return {
+                content: [{ type: "text", text: "Error: Provide 'on' (event name), 'after' (delay), or 'trigger' object." }],
+                isError: true,
+            };
+        }
+        const data = await journeys.addTransition(client, journeyId, { ...rest, trigger });
+        const transitionName = rest.name || `${rest.from}-to-${rest.to}`;
+        const formatted = formatSingleTransition(data, "Added", transitionName);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+    server.tool("journey_edit_transition", "Update a transition's trigger or priority by name. Use 'on' for event triggers or 'after' for delays (e.g. '3 day', '12 hr', '30 m'). Also accepts the structured 'trigger' object. Use journey_list_transitions to find transition names.", {
+        journeyId: z.string().describe("Journey ID (jrn_ prefixed)"),
+        transitionName: z.string().describe("Name of the transition to edit"),
+        on: z
+            .string()
+            .optional()
+            .describe("New event trigger, e.g. 'user.login'. Shorthand for trigger: {type: 'event', event: ...}"),
+        after: z
+            .string()
+            .optional()
+            .describe("New delay, e.g. '3 day', '12 hr'. Shorthand for trigger: {type: 'timer', delay: ...}"),
+        trigger: z
+            .object({
+            type: z.enum(["event", "timer"]).describe("Trigger type"),
+            event: z.string().optional().describe("Event name"),
+            delay: z.string().optional().describe("Delay duration"),
+        })
+            .optional()
+            .describe("Structured trigger object (alternative to on/after shorthand)"),
+        priority: z
+            .number()
+            .optional()
+            .describe("New priority value"),
+    }, async (params) => {
+        const { journeyId, transitionName, on: onEvent, after, trigger: rawTrigger, ...rest } = params;
+        // Resolve trigger from on/after shorthand or structured trigger
+        let trigger;
+        if (onEvent) {
+            trigger = { type: "event", event: onEvent };
+        }
+        else if (after) {
+            trigger = { type: "timer", delay: parseDelay(after) };
+        }
+        else if (rawTrigger) {
+            trigger = rawTrigger;
+            if (trigger.type === "timer" && trigger.delay) {
+                trigger.delay = parseDelay(trigger.delay);
+            }
+        }
+        const data = await journeys.editTransition(client, journeyId, transitionName, { ...rest, trigger });
+        const formatted = formatSingleTransition(data, "Updated", transitionName);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+    server.tool("journey_remove_transition", "Remove a transition from a journey by name. This is permanent. Use journey_list_transitions to find transition names.", {
+        journeyId: z.string().describe("Journey ID (jrn_ prefixed)"),
+        transitionName: z.string().describe("Name of the transition to remove"),
+    }, async (params) => {
+        const data = await journeys.removeTransition(client, params.journeyId, params.transitionName);
+        const formatted = formatSingleTransition(data, "Removed", params.transitionName);
+        return { content: [{ type: "text", text: formatted }] };
+    });
+}

package/dist/tools/platform.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AscendKitClient } from "../api/client.js";
+export declare function registerPlatformTools(server: McpServer, client: AscendKitClient): void;