apply_clip_settings
ChatGPTSave caption style, hook text preset, and video layout settings for a clip before exporting. Must be called before export_clip if the clip has no saved settings. When the user wants default settings, pass useDefaults: true — the correct style and hook for the clip's layout are applied automatically. Caption style options (pass id or name): 1: vintage, 2: Haas Grotesk, 19: Garamond, 20: maya, 21: maya 2, 22: Tom, 23: Abril, 24: cove, 25: invert, 26: chill, 3: zumme, 4: Grotesk, 5: komika, 6: Ali, 622: Ali dark, 6222: yellow, 7: Grold, 8: cool, 9: Morl, 10: Emotional, 11: Jaspal, 12: fraunces, 13: The Bold, 14: oblex, 15: Podcast, 16: Iman, 17: Dan, 18: Tayo Hook preset options (pass id or name, or 'none' to skip hook): bold-white: Bold White, Coolvetica: Coolvetica, garmond: garmond, yellow-pop: Yellow Bold, yellow-light: Yellow light, dark-pill: Dark Pill, Yellow-pill: Yellow Pill, white-box: White Box, subtle-gray: bold Anton, garamod: Garamond-yellow
cancel_post
ChatGPTCancel a pending scheduled post before it publishes. Only works on 'pending' posts — already published posts cannot be undone. Get the post ID from list_scheduled_posts.
export_clip
ChatGPTRender a clip into a final MP4 with captions and hook text. Always pass the clip UUID from get_clips structuredContent.clips[].id. If you only have the display number (1, 2, 3…), also pass projectId and this tool resolves the correct UUID automatically. Self-sufficient: if the clip has no saved settings, layout-matched defaults are applied automatically. No need to call apply_clip_settings first unless the user explicitly wants a different style. Free plan → blocked. Already exported → returns existing URL immediately. Rendering is async (1-3 min). Call again when user asks 'is it ready?'.
generate_clips
ChatGPTStart AI clip generation from a YouTube video. IMPORTANT: Before calling this tool you must (1) call get_user_plan to check credits, (2) ask the user for all settings (URL, process range, clip duration, aspect ratio, frame layout, moment prompt), (3) show a settings summary and get confirmation. This tool checks credits against video duration and blocks if insufficient. 1 credit = 1 minute of video. Returns projectId — call get_clips to poll for results.
get_clips
ChatGPTRetrieve AI-generated clips for a project. Returns a compact table with clip number, title, duration, and virality score. Full details (description, tags, export status, app links) are available in structured data — use them if the user asks about a specific clip. After showing the table ask the user what they want to do next.
get_connected_accounts
ChatGPTList all social media accounts the user has connected in NextClip (TikTok, Instagram, YouTube Shorts, LinkedIn, Facebook). Call this before schedule_clip so the user can pick which account(s) to publish to. Returns account IDs needed for schedule_clip.
get_user_plan
ChatGPTReturns the user's current subscription plan, available credits, and which features are available to them. Call this at the start of each session and before generate_clips, export_clip, or schedule_clip. 1 credit = 1 minute of video processed.
list_projects
ChatGPTFetch all the user's video projects with status, clip count, and creation date. Returns data formatted as a markdown table. After showing the table, ask which project the user wants to view clips for.
list_scheduled_posts
ChatGPTShow all scheduled, published, and failed social posts for the user. Use to check the publishing queue, confirm posts went live, or find post IDs to edit or cancel.
reschedule_post
ChatGPTMove a pending scheduled post to a new datetime. Only works on posts with 'pending' status — already published posts cannot be rescheduled. Get the post ID from list_scheduled_posts.
schedule_clip
ChatGPTPublish a clip immediately or schedule it for a specific time on social platforms. The clip must be exported first — call export_clip if exportedVideoUrl is missing. Requires a clipId (from get_clips) and socialAccountIds (from get_connected_accounts). Set scheduledFor to 'now' to publish immediately, or an ISO-8601 datetime to schedule. Optionally override the default title and description with custom values before publishing.
