posterly-mcp-server 0.19.4 → 0.19.6

package/src/tools/start-signup.ts

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+import type { PosterlyClient, PublicSignupResponse, PublicSignupTier } from '../lib/api-client.js';
+
+const DEFAULT_RETURN_PATH = '/dashboard/api?api_signup=success';
+
+export const startSignupTool = {
+  name: 'start_signup',
+  description:
+    'Start the public Posterly paid signup flow for a user before Posterly API access exists. Returns a Posterly checkout handoff URL and signup poll URL. The user must handle payment and password setup in the browser.',
+  inputSchema: z.object({
+    email: z
+      .string()
+      .email()
+      .describe('User email address to sign up. Confirm this with the user before calling.'),
+    name: z
+      .string()
+      .optional()
+      .describe('Optional user or workspace name to pass into Posterly signup.'),
+    tier: z
+      .enum(['starter', 'pro', 'power_user', 'agency'])
+      .default('starter')
+      .describe('Posterly plan to start. Use starter unless the user explicitly chooses another plan.'),
+    interval: z
+      .enum(['month'])
+      .default('month')
+      .describe('Billing interval. Public agent signup currently supports monthly billing.'),
+    api_addon: z
+      .boolean()
+      .default(true)
+      .describe('Always true for AI agent setup because MCP/API access requires the API add-on.'),
+    return_path: z
+      .string()
+      .default(DEFAULT_RETURN_PATH)
+      .describe('Where Posterly should continue after checkout and password setup.'),
+    source: z
+      .string()
+      .default('posterly_mcp_pre_auth_signup')
+      .describe('Source label for analytics and support diagnostics.'),
+  }),
+
+  async execute(
+    client: PosterlyClient,
+    input: {
+      email: string;
+      name?: string;
+      tier?: PublicSignupTier;
+      interval?: 'month';
+      api_addon?: boolean;
+      return_path?: string;
+      source?: string;
+    },
+  ) {
+    const response = await client.startSignup({
+      email: input.email,
+      name: input.name,
+      tier: input.tier ?? 'starter',
+      interval: input.interval ?? 'month',
+      api_addon: input.api_addon ?? true,
+      return_path: input.return_path ?? DEFAULT_RETURN_PATH,
+      source: input.source ?? 'posterly_mcp_pre_auth_signup',
+    });
+
+    return formatSignupStart(response);
+  },
+};
+
+function valueFromLinks(response: PublicSignupResponse, key: string): string | null {
+  const links = response.signup_session?.links ?? response.links;
+  const value = links?.[key];
+  return typeof value === 'string' ? value : null;
+}
+
+function formatSignupStart(response: PublicSignupResponse): string {
+  const session = response.signup_session;
+  const sessionId = session?.id || response.checkout_session_id;
+  const checkoutUrl = response.checkout_url || valueFromLinks(response, 'checkout_url');
+  const checkoutRedirectUrl = response.checkout_redirect_url || session?.checkout_redirect_url || valueFromLinks(response, 'checkout_redirect_url');
+  const pollUrl = response.poll_url || valueFromLinks(response, 'poll_url');
+  const completeUrl = response.complete_url || valueFromLinks(response, 'complete_url');
+  const status = session?.status || response.status || 'checkout_pending';
+  const message = session?.status_message || response.status_message;
+
+  const lines = [
+    'Posterly signup started.',
+    sessionId ? `Signup session: ${sessionId}` : '',
+    `Status: ${status}`,
+    message ? `Message: ${message}` : '',
+    checkoutRedirectUrl ? `Checkout handoff URL: ${checkoutRedirectUrl}` : '',
+    checkoutUrl ? `Checkout URL: ${checkoutUrl}` : '',
+    pollUrl ? `Poll URL: ${pollUrl}` : '',
+    completeUrl ? `Completion URL: ${completeUrl}` : '',
+    '',
+    'Next steps for the AI agent:',
+    '1. Send the Checkout handoff URL to the user so they can pay securely in their browser. Use the raw Stripe checkout URL only if you preserve the full URL including any fragment.',
+    '2. Call get_signup_session with the signup session ID until the status changes.',
+    '3. Tell the user when Posterly sends the password setup email.',
+    '4. If status becomes agent_access_required, ask the user to install or paste the Posterly MCP/API setup instructions into this trusted AI chat.',
+    '5. Do not ask for card details, the Posterly password, social passwords, or OAuth codes.',
+    '',
+    `Raw signup response:\n${JSON.stringify(response, null, 2)}`,
+  ];
+
+  return lines.filter(Boolean).join('\n');
+}