# Tools

## Brand & strategy

| Tool | Scope | Summary |
| --- | --- | --- |
| [`list_brands`](https://usedalea.ai/docs/mcp/tools/list_brands.md) | read | List the user's brands with niche and connected platforms, and which one is active. |
| [`get_brand_profile`](https://usedalea.ai/docs/mcp/tools/get_brand_profile.md) | read | Get a brand's full profile: basics (name, language, strategy summary), the onboarding brief (niche, audience, pain, promise, tone, pillars, taboo topics), connected social accounts with follower counts, business segment and subscription status. |
| [`get_brand_kit`](https://usedalea.ai/docs/mcp/tools/get_brand_kit.md) | read | Get the brand's visual identity kit (colors, fonts, logo, palette, voice description) used by the video editor and carousels. |
| [`update_brand_kit`](https://usedalea.ai/docs/mcp/tools/update_brand_kit.md) | write | Update the brand's visual identity kit: colors (primary, accent, background, foreground, palette), fonts (fontFamily, headingFont), logoUrl, voiceDescription. |
| [`update_strategy_brief`](https://usedalea.ai/docs/mcp/tools/update_strategy_brief.md) | write | Update the brand's strategy brief (onboarding brief). |
| [`get_voice_profile`](https://usedalea.ai/docs/mcp/tools/get_voice_profile.md) | read | Get the brand's AI-derived voice profile (status, confidence, profile, exemplars) and form profile (status, profile, stats). |

## Performance

| Tool | Scope | Summary |
| --- | --- | --- |
| [`get_account_overview`](https://usedalea.ai/docs/mcp/tools/get_account_overview.md) | read | Get the brand's connected accounts with followers, followersGained30d (null when there is no metric snapshot at least 30 days old), total videos, reach, and lastSyncedAt. |
| [`list_videos`](https://usedalea.ai/docs/mcp/tools/list_videos.md) | read | List the brand's published videos with metrics and classification (funnelStage, format, communicationStyle, mediaType). |
| [`get_video`](https://usedalea.ai/docs/mcp/tools/get_video.md) | read | Get one of the brand's videos by platformVideoId: full metrics (incl. averageWatchTime, reach, saves), plus the AI analysis and transcript when they exist (null otherwise). |
| [`get_performance_summary`](https://usedalea.ai/docs/mcp/tools/get_performance_summary.md) | read | Totals for videos published in the last N days (7\|30\|90, default 30): videoCount, views, likes, comments, shares, saves, averageEngagementPct; the same for the previous window; deltaPct per metric (null when the previous value is 0); and the topVideo by views. |
| [`get_top_performers`](https://usedalea.ai/docs/mcp/tools/get_top_performers.md) | read | Rank the brand's videos published in the last N days (default 30) by metric: views \| engagement \| saves \| shares \| likes. |
| [`get_metrics_daily`](https://usedalea.ai/docs/mcp/tools/get_metrics_daily.md) | read | Daily aggregated metrics per connected account between from and to (YYYY-MM-DD, inclusive; range capped to the last 180 days before `to`). |
| [`get_niche_benchmarks`](https://usedalea.ai/docs/mcp/tools/get_niche_benchmarks.md) | read | Get median/p75/p90 view and engagement benchmarks for the brand's niche. |
| [`set_video_classification`](https://usedalea.ai/docs/mcp/tools/set_video_classification.md) | write | Manually classify one of the brand's published videos (by platformVideoId): funnel (tofu \| mofu \| bofu), format (taxonomy slug, e.g. talking_head, tutorial, listicle) and/or communicationStyle (style slug). |
| [`sync_metrics`](https://usedalea.ai/docs/mcp/tools/sync_metrics.md) | write | Fetch fresh metrics from every connected TikTok/Instagram account. |

## Insights

| Tool | Scope | Summary |
| --- | --- | --- |
| [`list_insights`](https://usedalea.ai/docs/mcp/tools/list_insights.md) | read | List the brand's AI-generated insight tiles. |
| [`get_homepage_insights`](https://usedalea.ai/docs/mcp/tools/get_homepage_insights.md) | read | Get the latest homepage insight cards generated for the brand (insights array, how many videos they were based on, language). |
| [`generate_insights`](https://usedalea.ai/docs/mcp/tools/generate_insights.md) | write | Regenerate the brand's homepage insights from its synced videos (needs 10+ videos). |

## Content & calendar

| Tool | Scope | Summary |
| --- | --- | --- |
| [`list_contents`](https://usedalea.ai/docs/mcp/tools/list_contents.md) | read | List the brand's content cards (board + calendar) as summaries: id, title, idea, status, platforms, postedAt, mediaType, category, funnelStage, format, updatedAt. |
| [`get_content`](https://usedalea.ai/docs/mcp/tools/get_content.md) | read | Get one content card's full detail by id: the script (hook, body, cta, caption), planning fields (status, platforms, postedAt, mediaType, category, funnelStage, format, communicationStyle, targetDurationSeconds) and how many references and AI generations it has. |
| [`list_content_references`](https://usedalea.ai/docs/mcp/tools/list_content_references.md) | read | List the references (videos, links, files) attached to a content card, in order: id, referenceType, referenceUrl, position, title. |
| [`create_content`](https://usedalea.ai/docs/mcp/tools/create_content.md) | write | Create a new content card on the board/calendar (no AI). |
| [`bulk_create_contents`](https://usedalea.ai/docs/mcp/tools/bulk_create_contents.md) | write | Create 1-20 content cards in one call (no AI). |
| [`update_content`](https://usedalea.ai/docs/mcp/tools/update_content.md) | write | Edit a content card's editorial fields (no AI). |
| [`duplicate_content`](https://usedalea.ai/docs/mcp/tools/duplicate_content.md) | write | Create a copy of a content card (same title, idea, script, caption, platforms, mediaType, format, category, funnelStage, communicationStyle, targetDurationSeconds) at the bottom of the idea column, with no planned date. |
| [`move_content`](https://usedalea.ai/docs/mcp/tools/move_content.md) | write | Move a content card on the kanban board: change its column (status) and/or its order within a column. |
| [`reorder_contents`](https://usedalea.ai/docs/mcp/tools/reorder_contents.md) | write | Set the order of cards inside one kanban column (status: idea \| draft \| edited \| posted). |
| [`schedule_content`](https://usedalea.ai/docs/mcp/tools/schedule_content.md) | write | Set the planned calendar date for a content card (the day it should be posted). |
| [`unschedule_content`](https://usedalea.ai/docs/mcp/tools/unschedule_content.md) | write | Clear a content card's planned calendar date (sets posted_at to null). |
| [`delete_content`](https://usedalea.ai/docs/mcp/tools/delete_content.md) | write | Delete a content card from the board/calendar by id. |
| [`get_calendar`](https://usedalea.ai/docs/mcp/tools/get_calendar.md) | read | Get the brand's content calendar for a date range as one entry per day (empty days included), each with the cards planned for that day (id, title, status, platforms, mediaType, postedAt). |
| [`generate_title`](https://usedalea.ai/docs/mcp/tools/generate_title.md) | write | AI-generate a working title. |

## Scripts

| Tool | Scope | Summary |
| --- | --- | --- |
| [`generate_scripts`](https://usedalea.ai/docs/mcp/tools/generate_scripts.md) | write | Generate a full AI script (hook, CTA, body and caption options; carousel slides for carousels) for 1-5 content cards and save it to each card. |
| [`generate_hook_options`](https://usedalea.ai/docs/mcp/tools/generate_hook_options.md) | write | Generate up to 3 AI hook (opening line) suggestions for a content card, using the brand's context, memory and references. |
| [`generate_body_options`](https://usedalea.ai/docs/mcp/tools/generate_body_options.md) | write | Generate up to 3 AI body (script development) suggestions for a content card, using the brand's context, memory and references. |
| [`generate_cta_options`](https://usedalea.ai/docs/mcp/tools/generate_cta_options.md) | write | Generate up to 3 AI call-to-action suggestions for a content card, using the brand's context, memory and references. |
| [`generate_caption_options`](https://usedalea.ai/docs/mcp/tools/generate_caption_options.md) | write | Generate up to 3 AI caption suggestions for a content card, using the brand's context, memory and references. |
| [`list_content_generations`](https://usedalea.ai/docs/mcp/tools/list_content_generations.md) | read | List the AI script generations saved for a content card (newest first): title, hook, cta and the alternative body/caption options each run produced. |
| [`get_refine_chat`](https://usedalea.ai/docs/mcp/tools/get_refine_chat.md) | read | Get the last N messages (default 20, max 100) of the refine chat attached to a content card, as { role, content } pairs, plus the total message count. |

## Ideas & trends

| Tool | Scope | Summary |
| --- | --- | --- |
| [`list_brainstorm_suggestions`](https://usedalea.ai/docs/mcp/tools/list_brainstorm_suggestions.md) | read | List the brand's active brainstorm suggestions with reasons. |
| [`accept_brainstorm_suggestion`](https://usedalea.ai/docs/mcp/tools/accept_brainstorm_suggestion.md) | write | Accept a brainstorm suggestion: creates a content card in the idea column from its title, idea and funnel stage (no AI), then marks the suggestion as added with contentId. |
| [`dismiss_brainstorm_suggestion`](https://usedalea.ai/docs/mcp/tools/dismiss_brainstorm_suggestion.md) | write | Mark a brainstorm suggestion as dismissed so it leaves the pending list. |
| [`regenerate_brainstorm`](https://usedalea.ai/docs/mcp/tools/regenerate_brainstorm.md) | write | Replace the brand's active brainstorm set with freshly generated suggestions (optional manualContext steers them). |
| [`list_trend_feed`](https://usedalea.ai/docs/mcp/tools/list_trend_feed.md) | read | List trending topic clusters matched to the brand, best fit first: fit score and reasons, a suggested angle, and the cluster's title, description, category, platforms, momentum, tags, post count and average virality. |
| [`get_trend_cluster`](https://usedalea.ai/docs/mcp/tools/get_trend_cluster.md) | read | Get one trend cluster by clusterId, plus the brand's fit (score, reasons, suggested angle, content guide) when the cluster is in the brand's feed. |

## Saved references

| Tool | Scope | Summary |
| --- | --- | --- |
| [`list_saved_references`](https://usedalea.ai/docs/mcp/tools/list_saved_references.md) | read | List the brand's saved reference videos (with catalog videoId, note and whether an analysis exists, use get_catalog_video for the transcript) and creator inspirations (creatorId for get_creator / get_creator_analysis). |
| [`save_reference_by_url`](https://usedalea.ai/docs/mcp/tools/save_reference_by_url.md) | write | Save a TikTok/Instagram video or creator profile URL as a brand reference (scrapes it if unknown; video analysis runs in the background). |
| [`delete_saved_reference`](https://usedalea.ai/docs/mcp/tools/delete_saved_reference.md) | write | Permanently remove a saved reference video (id from list_saved_references). |
| [`get_creator_analysis`](https://usedalea.ai/docs/mcp/tools/get_creator_analysis.md) | read | Get the stored deep analysis for a saved creator by creatorId. |
| [`run_creator_deep_analysis`](https://usedalea.ai/docs/mcp/tools/run_creator_deep_analysis.md) | write | Run (or return the cached) AI deep analysis of a saved creator by creatorId. |
| [`hide_creator`](https://usedalea.ai/docs/mcp/tools/hide_creator.md) | write | Hide a creator (by handle, with or without @) from this brand's reference catalog searches. |
| [`unhide_creator`](https://usedalea.ai/docs/mcp/tools/unhide_creator.md) | write | Show a previously hidden creator (by handle) in this brand's reference catalog again. |

## Viral catalog

| Tool | Scope | Summary |
| --- | --- | --- |
| [`search_catalog_videos`](https://usedalea.ai/docs/mcp/tools/search_catalog_videos.md) | read | Search the shared reference catalog of top-performing creator videos. |
| [`get_catalog_video`](https://usedalea.ai/docs/mcp/tools/get_catalog_video.md) | read | Get one catalog video by id with its stored analysis (transcript and virality score) when one exists. |
| [`search_creators`](https://usedalea.ai/docs/mcp/tools/search_creators.md) | read | Search catalog creators by name or handle (min 2 chars). |
| [`get_creator`](https://usedalea.ai/docs/mcp/tools/get_creator.md) | read | Get a catalog creator by id: profile, AI summary, platform accounts and their 5 most-viewed catalog videos. |
| [`list_niche_patterns`](https://usedalea.ai/docs/mcp/tools/list_niche_patterns.md) | read | List the recurring script patterns detected in a niche's viral videos (name, description, structure, average virality, usage count). |

## Creator knowledge

| Tool | Scope | Summary |
| --- | --- | --- |
| [`list_creator_facts`](https://usedalea.ai/docs/mcp/tools/list_creator_facts.md) | read | List facts the app has learned about the creator (story, pillars, arguments, restrictions, preferences, products, milestones, voice, audience, goals). |
| [`add_creator_fact`](https://usedalea.ai/docs/mcp/tools/add_creator_fact.md) | write | Record a fact about the creator in the learning ledger (source manual, status active). |
| [`archive_creator_fact`](https://usedalea.ai/docs/mcp/tools/archive_creator_fact.md) | write | Archive a creator fact by id so it stops feeding generation. |
| [`get_creator_memory`](https://usedalea.ai/docs/mcp/tools/get_creator_memory.md) | read | Get the AI-maintained memory of who this creator is (free text plus structured fields). |
| [`get_creator_context`](https://usedalea.ai/docs/mcp/tools/get_creator_context.md) | read | Get the creator interview outcome: phase, origin story, 90-day goals, what content already works, struggles, themes and voice. |
| [`list_macro_topics`](https://usedalea.ai/docs/mcp/tools/list_macro_topics.md) | read | List the brand's macro content topics grouped from its creator facts, with usage counts and the fact ids behind each one. |
| [`list_restrictions`](https://usedalea.ai/docs/mcp/tools/list_restrictions.md) | read | List things the brand never wants in its content (restrictions), with where each one came from. |
| [`add_restriction`](https://usedalea.ai/docs/mcp/tools/add_restriction.md) | write | Add a restriction: something the brand never wants in its content. |
| [`remove_restriction`](https://usedalea.ai/docs/mcp/tools/remove_restriction.md) | write | Permanently delete one restriction by id (from list_restrictions). |
| [`get_script_preferences`](https://usedalea.ai/docs/mcp/tools/get_script_preferences.md) | read | Get the brand's script preferences: content pillars with weights, preferred formats, default duration, approved and banned hooks, standing instructions. |
| [`update_script_preferences`](https://usedalea.ai/docs/mcp/tools/update_script_preferences.md) | write | Update the brand's script preferences. |

## Studio

| Tool | Scope | Summary |
| --- | --- | --- |
| [`list_carousel_drafts`](https://usedalea.ai/docs/mcp/tools/list_carousel_drafts.md) | read | List the brand's carousel drafts from the Carousel Studio (title, slide count, last edit). |
| [`get_carousel_draft`](https://usedalea.ai/docs/mcp/tools/get_carousel_draft.md) | read | Get one carousel draft with its slides (role, image prompt, headline/body/CTA texts). |
| [`list_carousel_posts`](https://usedalea.ai/docs/mcp/tools/list_carousel_posts.md) | read | List carousel/video publish jobs sent to Instagram or TikTok: status, scheduled time, per-platform result (permalink or error). |
| [`list_video_projects`](https://usedalea.ai/docs/mcp/tools/list_video_projects.md) | read | List the brand's video editor projects (name, status queued\|processing\|preview_ready\|ready\|failed, language, enabled edits, durations). |
| [`get_video_job_status`](https://usedalea.ai/docs/mcp/tools/get_video_job_status.md) | read | Get the latest render job of a video editor project: status, stage, progress percent, error code, plus the url of the project in the Dalea video editor. |

## Search & fetch

| Tool | Scope | Summary |
| --- | --- | --- |
| [`search`](https://usedalea.ai/docs/mcp/tools/search.md) | read | Search the user's Dalea workspace: planned/written contents, the reference video catalog, and creators. |
| [`fetch`](https://usedalea.ai/docs/mcp/tools/fetch.md) | read | Fetch the full text of a search result by id (content:<id> = script with hook/body/cta/caption; catalog:<id> = reference video caption + transcript; creator:<id> = creator bio and summary). |