Yolando

Delete a brand voice from this workspace.

delete_brand_voice

Soft-delete a chat suggestion (employee only).

delete_chat_suggestion

Remove a competitor from this workspace.

delete_competitor

Delete a content item Soft-deletes the content item and cascades to its pieces.

delete_content_item

Delete prompts from this workspace by ID.

delete_prompts

Soft-delete a skill from the catalog (employee only). The slug is freed for reuse; usage history keeps referring to the deleted row.

delete_skill

Delete a bundled skill resource file (employee only).

delete_skill_resource

Delete a topic and all its prompts from this workspace. Soft-deletes the topic and cascade-soft-deletes its prompts.

delete_topic

Aggregated citation analytics for the workspace brand. Returns overall citation share plus the top domains that cite the brand in AI-generated responses. Use this for "where is my brand being cited?" and "top N citations" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it (e.g. "last 90 days"). Use ``limit`` for "top N" requests (e.g. limit=10).

get_citation_insights

Citation share time-series for the workspace brand and all tracked competitors. Shows how each brand's share of AI citations is trending over time. Use for "who is winning citations in my space?" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

get_competitor_citation_trends

Discoverability time-series for the workspace brand and all tracked competitors. Returns week-by-week (or day-by-day) discoverability scores so you can answer "is my brand gaining or losing ground vs competitors in AI search?" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

get_competitor_discoverability_trends

Reputation score time-series for the workspace brand and all tracked competitors. Shows how each brand's AI reputation score is trending. Use for "how does my brand's reputation compare to competitors?" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

get_competitor_reputation_trends

Search clicks/impressions earned by Yolando-generated content. Returns one row per content item that has been matched to a live page on the brand's site, with Google Search Console clicks/impressions and GA4 sessions/engaged sessions summed across all of the item's linked pages (including pages it was published on before a republish). Items whose pages have no metrics yet appear with zeros; unpublished items don't appear at all. Ordered by clicks, most-earning first. Use this for "how is our published content performing in search?" questions. Defaults to all-time totals; pass start_date/end_date to scope the window.

get_content_attribution

Day-by-day clicks/impressions and traffic for one content item. Returns a daily time series of Google Search Console clicks/impressions and GA4 sessions/engaged sessions attributed to the content item across all of its linked pages. Use after ``get_content_attribution`` to drill into how a specific piece is trending. Days with no data in either source are omitted; an item with no linked pages returns an empty series. Defaults to all available history; pass start_date/end_date to scope the window.

get_content_attribution_daily

Full detail for a single content item, including the generated body. Returns the content item's metadata, current status, and the complete generated text in markdown format. Use after ``list_content`` to read or evaluate a specific piece — pass the ``id`` field from that list.

get_content_item

Brand-insights snapshot for the target workspace. Returns discoverability, share of voice, citation share, and reputation score. Ask this first for "how is my brand doing in AI search?" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it (e.g. "last 90 days").

get_insights_overview

Discoverability, share of voice, citation share, and reputation score broken down by AI platform (ChatGPT, Perplexity, Gemini, etc.). Returns four datasets in one tool call so you can answer "which platforms is my brand strongest / weakest on?" without making separate tool calls. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

get_platform_insights

Platform discoverability broken down by brand (workspace + competitors). Returns each tracked brand's discoverability score per AI platform, enabling side-by-side competitor comparisons across platforms. Use after ``get_platform_insights`` to drill into "which brands are winning on each platform?" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

get_platform_insights_by_brand

Platform discoverability broken down by topic. Returns each tracked topic's discoverability score per AI platform, showing which topics the brand appears in most on each platform. Use after ``get_platform_insights`` to drill into "which topics drive visibility on each platform?" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

get_platform_insights_by_topic

Full detail for a single radar feed item. Returns the complete radar item including strategic summary, diff sections (for site-change items), news sources (for market-news items), and topic associations. Use after ``list_radar_feed`` to drill into a specific signal — pass the ``id`` field from any item in that list.

get_radar_item

Full detail for a single optimization recommendation. Returns the complete recommendation including the signal that triggered it, suggested actions, and supporting data. Use after ``list_recommendations`` to drill into a specific recommendation — pass the ``id`` field from any item in that list.

get_recommendation

Get a full skill registry entry, including SKILL.md body (employee only).

get_registry_skill

Get a full skill resource row, including inline content (employee only).

get_registry_skill_resource

Brand reputation overview with theme-based score and theme breakdown. Returns the overall reputation score (percentage of positive themes), a positive/negative breakdown, and a summary of the recurring themes AI models associate with the brand. Use this for "what is AI saying about my brand's reputation?" questions. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

get_reputation_overview

Latest website vitals report for the workspace's brand domain. Returns the most recent crawl results including technical SEO health checks, robots.txt status, llms.txt status, and sitemap-related issues. Use for "what technical issues does my site have that affect AI discoverability?" questions.

get_website_vitals

Brand voice profiles defined for the target workspace. Returns the list of brand voices available in the workspace, each representing a writing style, tone, and messaging guidelines. Use to discover which brand voice IDs can be passed to ``create_content_piece``.

list_brand_voices

List all competitors tracked by the target workspace. Returns each competitor's name, domain, and tracking status. Call this first to get competitor IDs needed by other tools.

list_competitors

Content items created in this workspace. Returns AI-generated content pieces (articles, video scripts, social posts) with their current status. Use to browse what content has been produced or to get content item IDs for ``get_content_item``.

list_content

Raw AI model responses for the tracked prompts in this workspace. Returns the actual responses generated by AI platforms (ChatGPT, Perplexity, Gemini, etc.) along with brand mention positions and citation data. Use to inspect exactly what AI models are saying about topics in the workspace's tracked prompt set.

list_prompt_executions

Per-prompt insights for the target workspace. Use this to answer "which of my tracked prompts are doing best / worst?" — returns prompt-level discoverability and mention metrics. Defaults to the last 30 calendar days (UTC unless `timezone` is given) when no time window is given; pass start/end or lookback_days to scope it.

list_prompt_insights

Prompts (tracked questions) for this workspace. Returns each prompt's text, topic, funnel tag, and enabled state. Use to audit which questions are being tracked or to get prompt IDs before making changes.

list_prompts

Competitive intelligence feed — news, competitor changes, and market signals. Returns paginated radar items surfaced by Yolando's monitoring system. Optionally filter by full-text search or limit to unread items. Use for "what's changed with my competitors recently?" questions.

list_radar_feed

Surfaced optimization recommendations for the target workspace. Returns AI-generated recommendations for the workspace's discoverability, citation, and reputation metrics. Each recommendation includes a type, priority, and the signals that triggered it. Use to list recommendations or to get a recommendation ID for ``get_recommendation``.

list_recommendations

List skills in the authoring registry (employee only).

list_registry_skills

Topics (thematic categories) defined in this workspace. Returns each topic's name, ID, and prompt count. Use this to discover topic IDs before creating prompts or to understand how the workspace's tracked questions are organized.

list_topics

List every workspace this token's user can currently access, with the scopes usable on each and an explicit `writable` flag. Call this first whenever you are unsure which workspace to target, then pass the chosen id as `workspace_id` to the other tools and reuse it across calls in a session. Results are keyset-paginated: pass `next_cursor` back as `cursor` to continue, keeping `search` unchanged (changing the search restarts iteration without a cursor).

list_workspaces

Promote a workspace suggestion to global (employee only). Clears the suggestion's workspace scope so every workspace sees it.

promote_chat_suggestion_to_global

Promote a workspace skill to the global catalog (employee only). Clears the skill's workspace scope so every workspace sees it. Fails when a global skill already uses the slug.

promote_skill_to_global

Update fields on an existing brand voice. At least one field must be provided.

update_brand_voice

Update a chat suggestion (employee only).

update_chat_suggestion