Luce - AI Growth Marketing Platform

Workflows are the core of Luce AI. Each workflow runs a specialized marketing analysis or content generation task as a background job. You launch them with launch_workflow, poll status with get_workflow_status, and read results when they complete.

Lifecycle

Launch

Call launch_workflow(project_id, workflow_type) with optional parameters. Returns a workflow_run_id.

Poll

Call get_workflow_status(workflow_run_id) every 10--15 seconds. Status progresses through: PENDING then RUNNING then COMPLETED or FAILED. While running, the response includes step-by-step progress with a percentage and current step label.

Read results

When status is COMPLETED, the output content is included directly in the get_workflow_status response. For raw data files, use list_files and read_file.

Available Workflows

Research and Onboarding

Workflow Type	Description	Auto-runs
`onboarding`	Initial company and product research	Yes, on project creation

SEO

Workflow Type	Description	Prerequisites
`seo`	Full SEO audit analyzing 60+ on-page metrics	onboarding
`seo_blog_posts`	Generate SEO-optimized blog posts	Works best after `seo`
`seo_content_planning`	SILO architecture, keyword clusters, 90-day content plan, gap analysis, internal linking strategy	`seo` with keyword augmentation

Workflow Type	Description	Prerequisites
`reddit_scraper`	Find relevant subreddits for engagement	onboarding
`reddit_drafting`	Generate Reddit post drafts	`reddit_scraper`
`reddit_engagement`	Find Reddit engagement opportunities	onboarding

Workflow Type	Description	Prerequisites
`x_posts`	Generate X/Twitter posts	onboarding, founder name
`x_analysis`	Analyze X/Twitter performance	onboarding, founder name
`x_engagement`	Find X/Twitter engagement opportunities	onboarding

Workflow Type	Description	Prerequisites
`linkedin_posts`	Generate LinkedIn posts	onboarding, founder name
`linkedin_analysis`	Analyze LinkedIn performance	onboarding, founder name
`linkedin_engagement`	Find LinkedIn engagement opportunities	onboarding

Workflow Type	Description	Prerequisites
`social_media_posts`	Generate posts across multiple platforms	onboarding, founder name
`social_media_analysis`	Analyze social media performance	onboarding, founder name

GEO (Generative Engine Optimization)

Workflow Type	Description	Prerequisites
`geo_scanner`	Scan AI search engines for brand visibility	onboarding
`geo_directory_listings`	Find relevant directories for submissions	onboarding
`geo_auto_listing`	Auto-submit to selected directories	`geo_directory_listings`, `selected_platforms` param

Strategy and Growth

Workflow Type	Description	Prerequisites
`strategy_planner`	Create growth strategy with 12-week calendar	onboarding
`influencer_marketing`	Find influencers across platforms	onboarding

Advertising

Workflow Type	Description	Prerequisites
`ads_competitor_analysis`	Analyze competitor advertising	onboarding
`ads_creative_drafting`	Generate advertising creatives	onboarding

Parameters

Most workflows only require project_id and workflow_type. Some accept additional parameters:

Parameter	Type	Used by
`founder`	string	Social media workflows (`x_posts`, `linkedin_posts`, etc.)
`num_drafts`	integer	Content generation workflows (`reddit_drafting`, `seo_blog_posts`)
`num_queries`	integer	`geo_scanner` -- number of AI search queries to test
`include_news`	boolean	Social media workflows -- include recent news context
`reference_url`	string	`reddit_drafting` -- ground content in a specific source URL
`personal_angle`	string	`reddit_drafting` -- add a personal perspective to drafts
`selected_platforms`	list	`geo_auto_listing` -- platforms to submit directory listings to
`keyword`	string	`tiktok_influencer` (legacy)

Dependency Chain

Workflows build on each other. The recommended execution order for a new project:

onboarding (auto-runs)
    |
    +-- strategy_planner
    +-- seo --> seo_blog_posts
    |      \--> seo_content_planning
    +-- reddit_scraper --> reddit_drafting
    |                  \--> reddit_engagement
    +-- geo_scanner --> geo_directory_listings --> geo_auto_listing
    +-- x_posts / linkedin_posts (require founder name)
    +-- influencer_marketing
    +-- ads_competitor_analysis --> ads_creative_drafting

Onboarding must run first

All workflows depend on the onboarding data. For new projects, onboarding runs automatically when you call create_project. Wait for it to complete before launching other workflows.

Example Session

A typical workflow session using MCP tool calls:

1. list_projects
   --> Pick project_id = 5

2. get_project_overview(5)
   --> See completed workflows and recommended next steps

3. launch_workflow(5, "seo")
   --> Returns workflow_run_id = 42

4. get_workflow_status(42)
   --> { status: "RUNNING", progress: { percentage: 35, current_step: "Analyzing backlinks" } }

5. get_workflow_status(42)   (poll again after 10-15s)
   --> { status: "COMPLETED", output: { ... full results ... } }

6. get_seo_dashboard(5)
   --> Structured view of SEO metrics

7. launch_workflow(5, "seo_blog_posts", { num_drafts: 3 })
   --> Chain into content generation

Monitoring Active Workflows

Use list_running_workflows to see all currently executing workflows across your projects. This is useful when you have multiple workflows running in parallel and need to track their progress.

To cancel a workflow that is still running, call cancel_workflow(workflow_run_id).

Credit Costs

Each workflow consumes credits from your account. Use the luce://credit-costs MCP resource to see the current cost table, or call get_account_info to check your remaining balance.

Workflow Guide