Ideation tools (scope: mcp:write, credits: ~1-5)
Create a script, caption, hook, or blog post tailored to a specific platform.
Create a script, caption, hook, or blog post tailored to a specific platform. Pass project_id to auto-load brand profile and performance context, or call get_ideation_context first for full context. Output is draft text ready for quality_check then schedule_post. Costs ~1-5 credits.
Request Body
promptstring · requiredDetailed content prompt. Include topic, angle, audience, and requirements. Example: "LinkedIn post about AI productivity for CTOs, 300 words, include 3 actionable tips, conversational tone." Richer prompts produce better results.
content_typestring · enum · requiredType of content to generate. "script" for video scripts, "caption" for ' + 'social media captions, "blog" for blog posts, "hook" for attention-grabbing hooks.
Enum values:scriptcaptionbloghook
platformstring · enumTarget social media platform. Helps tailor tone, length, and format.
Enum values:youtubetiktokinstagramtwitterlinkedinfacebookthreadsblueskybrand_voicestringTone directive (e.g. "direct, no jargon, second person" or "witty Gen-Z energy with emoji"). Leave blank to auto-load from project brand profile if project_id is set.
modelstring · enumAI model to use. Defaults to gemini-2.5-flash. Use gemini-2.5-pro for highest quality.
Enum values:gemini-2.0-flashgemini-2.5-flashgemini-2.5-proproject_idstring · uuidProject ID to auto-load brand profile and performance context for prompt enrichment.
Responses
contentobject[]
Get current trending topics for content inspiration.
Get current trending topics for content inspiration. Source youtube returns trending videos with view counts, google_trends returns rising search terms, rss/url extracts topics from any feed or page. Results cached 1 hour — set force_refresh=true for real-time. Feed results into generate_content or plan_content_week. Costs ~1-5 credits.
Request Body
sourcestring · enum · requiredData source. "youtube" fetches trending videos, "google_trends" fetches ' + 'daily search trends, "rss" fetches from a custom RSS feed URL, "url" ' + 'extracts trend data from a web page.
Enum values:youtubegoogle_trendsrssurl
categorystringCategory filter (for YouTube). Examples: general, entertainment, ' + 'education, tech, music, gaming, sports, news.
nichestringNiche keyword filter. Only return trends matching these keywords.
urlstringRequired when source is "rss" or "url". The feed or page URL to fetch.
force_refreshbooleanSkip the server-side cache and fetch fresh data.
Responses
contentobject[]
Rewrite existing content for a different platform — adjusts character limits, hashtag style, tone, and CTA format automatically.
Rewrite existing content for a different platform — adjusts character limits, hashtag style, tone, and CTA format automatically. Use after generate_content when you need the same message across multiple platforms. Pass project_id to apply platform-specific voice overrides from your brand profile. Costs ~1-5 credits.
Request Body
contentstring · requiredThe content to adapt. Can be a caption, script, blog excerpt, or any text.
target_platformstring · enum · requiredThe platform to adapt the content for.
Enum values:youtubetiktokinstagramtwitterlinkedinfacebookthreadsbluesky
source_platformstring · enumThe platform the content was originally written for. Helps preserve intent.
Enum values:youtubetiktokinstagramtwitterlinkedinfacebookthreadsblueskybrand_voicestringBrand voice guidelines to maintain during adaptation (e.g. "professional", "playful").
project_idstring · uuidOptional project ID to load platform voice overrides from brand profile.
Responses
contentobject[]