# Agent Brand Engineering

## Agent Brand Engineering

Build and run your entire brand with AI agents. This guide shows how to use Cuppa's MCP tools (or CLI/API) to engineer multi-channel brand visibility from Claude, Cursor, or any AI agent.

***

### What Is Agent Brand Engineering?

Brand Engineering is the practice of using AI agents to build and maintain brand visibility across every channel: organic search (SEO), AI search (ChatGPT, Perplexity), social media, email newsletters, visual content, and brand consistency. Instead of manually managing each channel, you configure your brand strategy once and let agents execute it.

Cuppa exposes 70+ tools that cover every step: research, content creation, optimization, publishing, social distribution, image/video generation, mood boards, performance analytics, newsletters, and feedback loops.

***

### The 6-Channel Framework

| Channel                  | What Agents Do                                                                      | Key Tools                                                                                                                                                                           |
| ------------------------ | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **SEO (Organic Search)** | Keyword research, content creation, grading, optimization, CMS publishing           | `research_keywords`, `create_content`, `grade_content`, `optimize_content`, `publish_content`                                                                                       |
| **AI Search**            | Knowledge base enrichment, brand context, structured content                        | `create_knowledge`, `update_brand_context`, AI search score in grading                                                                                                              |
| **Social Media**         | Post generation, multi-platform publishing, scheduling, draft management, analytics | `generate_social`, `publish_social`, `schedule_social`, `schedule_social_draft`, `publish_social_draft`, `bulk_schedule_social_drafts`, `generate_carousel`, `get_social_analytics` |
| **Email**                | Newsletter generation, strategy, content curation                                   | `generate_newsletter`, `list_newsletters`, `get_content_strategy`                                                                                                                   |
| **Creative**             | Images, videos, mood boards, carousels                                              | `generate_image`, `generate_images_bulk`, `generate_video_script`, `create_video`, `generate_mood_board`                                                                            |
| **Links**                | Internal linking, backlink acquisition, marketplace                                 | `list_link_sites`, `get_link_stats`, `get_backlinks`, Link Marketplace (UI)                                                                                                         |
| **Services**             | Expert human review of content                                                      | Expert Reviews (UI), requires Authorship subscription                                                                                                                               |
| **Brand Core**           | Brand DNA, visual style, voice consistency                                          | `get_brand`, `update_brand_context`, `update_brand_visual_style`, `generate_mood_board`                                                                                             |

#### Performance Hub Data Sources

The Performance Hub aggregates data from 7 external integrations into a unified analytics view:

| Source                    | What It Powers                                                                    |
| ------------------------- | --------------------------------------------------------------------------------- |
| **Google Search Console** | Organic clicks, impressions, CTR, position, top pages, content decay              |
| **Google Analytics 4**    | Sessions, pageviews, users, engagement metrics                                    |
| **Ahrefs**                | Domain rating, backlinks, referring domains, Brand Radar, competitor gap analysis |
| **Firehose**              | Web mentions and brand monitoring across the internet                             |
| **LLM Tracking**          | ChatGPT and Google AI Overview citations, top prompts, cited pages                |
| **DataForSEO**            | LLM cross-aggregated data, competitor LLM mentions, domain intersection           |
| **Late.dev**              | Social post analytics: impressions, engagements, clicks by platform               |

All data is accessible through the Performance Hub tools (`get_brand_performance`, `get_content_health`, `get_ai_visibility`, `get_backlinks`, `get_social_analytics`). No need to query each source individually.

***

### Workflow 1: Full Brand Audit

An agent can audit your entire brand status in one conversation:

```
1. list_sites                          → Get all brands
2. get_brand (site_id)                 → Check Brand DNA completeness
3. get_content_strategy (site_id)      → Review automation settings
4. get_content_calendar (site_id)      → See upcoming pipeline
5. get_social_analytics (site_id)      → Social performance
6. get_gsc_queries (site_id)           → Organic search performance
```

This gives the agent full context to recommend next steps.

***

### Workflow 2: Content Pipeline (SEO + Social + Visuals)

Generate an article with images and distribute across channels:

```
1. research_keywords (seed terms)      → Find high-value keywords
2. create_content (keyword, site_id)   → Generate article
3. get_content_status (id)             → Wait for completion
4. grade_content (id)                  → SEO + AI search grading
5. optimize_content (id)               → Auto-optimize based on SERP
6. generate_images_bulk ([id],         → Brand-consistent article images
   use_brand_colors: true)
7. publish_content (id, platform)      → Push to CMS
8. generate_social_multi               → Create posts for LinkedIn, X, etc.
   (article_title, article_summary,
    platforms: ["linkedin", "twitter"])
9. generate_carousel (site_id, topic,  → LinkedIn deep-dive
   generate_images: true)
10. publish_social / schedule_social   → Distribute to social
```

***

### Workflow 3: Standalone Social Campaign

Generate social posts from a topic without creating an article first:

```
1. generate_social                     → Standalone topic-based generation
   (site_id, topic: "AI agents are changing content marketing",
    platform: "linkedin", tone: "professional",
    hook_type: "contrarian")
2. generate_social_multi               → Same topic, multiple platforms
   (site_id, topic: "...",
    platforms: ["twitter", "linkedin", "threads"])
3. schedule_social                     → Schedule for optimal times
4. get_social_analytics                → Track performance later
```

***

### Workflow 4: Visual Content Production

Generate brand-consistent images, videos, and mood boards:

```
1. generate_image                       → Single image generation
   (prompt: "hero image for Q2 launch",
    model: "gpt-image-1",
    aspect_ratio: "16:9",
    site_id)                            → Uses brand colors automatically

2. generate_images_bulk                 → Batch article images
   (article_ids: [...],
    use_brand_colors: true)

3. generate_video_script                → AI-optimized video brief
   (brief: "product showcase",
    format: "product_showcase",
    platform: "instagram", site_id)

4. create_video                         → Generate from script
   (prompt: <from step 3>,
    model: "sora-2",
    duration_seconds: 15,
    use_brand_context: true)

5. get_video_status (id)                → Poll until complete

6. create_mood_board + generate_mood_board
   → Auto-generate visual direction from Brand DNA

7. generate_carousel                    → LinkedIn slide deck
   (topic, slide_count: 8,
    generate_images: true)
```

Video formats: `product_showcase`, `lifestyle_aesthetic`, `ugc_style`, `before_after`, `cinematic_broll`, `logo_brand_reveal`, `tutorial_howto`, `testimonial_talking_head`, `seasonal_campaign`, `abstract_mood`

***

### Workflow 5: Content Strategy Configuration

Let an agent configure your entire content strategy programmatically:

```
1. get_content_strategy (site_id)      → Read current settings
2. update_content_strategy (site_id,
   {
     social_publishing: {
       enabled: true,
       auto_post_on_publish: true,
       default_platforms: ["twitter", "linkedin"],
       default_tone: "professional",
       include_hashtags: true,
       max_hashtags: 5,
       generate_images: true
     },
     automation: {
       default_posts_per_week: 5,
       preferred_publish_days: ["monday", "wednesday", "friday"],
       auto_generate_social_on_publish: true
     },
     newsletter: {
       enabled: true,
       cadence: "weekly",
       send_day: "friday",
       send_hour: 9
     }
   })
```

***

### Workflow 6: Performance Feedback Loop (via Performance Hub)

An agent can pull the full brand performance picture and adjust strategy:

```
1. get_brand_performance (site_id)     → KPIs, visibility score, quick wins
2. get_content_health (site_id)        → Pages losing traffic, striking distance
3. get_ai_visibility (site_id)         → LLM citations, prompts, gaps
4. get_backlinks (site_id)             → DR, referring domains
5. get_social_analytics (site_id)      → Social reach, top posts
6. Based on performance data:
   - Target striking distance keywords with new content
   - Refresh decaying pages
   - Fill citation gaps for AI search
   - Double down on top social platforms
   - Adjust content_strategy defaults
```

***

### Workflow 7: Newsletter Automation

Generate and manage weekly newsletters from published content:

```
1. list_newsletters (site_id)          → See existing newsletters
2. generate_newsletter (site_id)       → Generate from this week's articles
3. get_newsletter (id)                 → Review content + HTML
4. update_content_strategy (site_id,   → Configure newsletter automation
   { newsletter: {
       enabled: true,
       cadence: "weekly",
       send_day: "friday"
   }})
```

***

### Tool Reference by Workflow Stage

#### Research & Planning

| Tool                   | Purpose                    |
| ---------------------- | -------------------------- |
| `research_keywords`    | Keyword discovery          |
| `research_serp`        | Competitor SERP analysis   |
| `research_competitors` | Content gap analysis       |
| `generate_cluster`     | Topic cluster generation   |
| `list_clusters`        | Review existing clusters   |
| `get_content_calendar` | View full content pipeline |
| `get_content_strategy` | Review automation settings |

#### Content Creation

| Tool                    | Purpose                                            |
| ----------------------- | -------------------------------------------------- |
| `create_content`        | Generate SEO article                               |
| `generate_social`       | Generate social post (article-based or standalone) |
| `generate_social_multi` | Multi-platform generation                          |
| `generate_carousel`     | LinkedIn carousel with slides + images             |

#### Creative (Images, Video, Mood Boards)

| Tool                    | Purpose                                                  |
| ----------------------- | -------------------------------------------------------- |
| `generate_image`        | Single AI image (multi-model, brand-aware with site\_id) |
| `generate_images_bulk`  | Batch image generation for articles                      |
| `list_image_models`     | Available image models (GPT Image 1, Flux, Imagen, etc.) |
| `generate_video_script` | AI video script with shot breakdown (10 format types)    |
| `create_video`          | Generate video (Sora 2, Kling, Replicate models)         |
| `get_video_status`      | Poll video generation progress                           |
| `delete_video`          | Remove a generated video                                 |
| `list_mood_boards`      | List mood boards for a brand                             |
| `create_mood_board`     | Create a new mood board                                  |
| `get_mood_board`        | View mood board items (images, colors, fonts)            |
| `generate_mood_board`   | Auto-generate visual direction from Brand DNA            |
| `delete_mood_board`     | Remove a mood board                                      |

#### Optimization & Grading

| Tool                | Purpose                 |
| ------------------- | ----------------------- |
| `grade_content`     | SEO + AI search grading |
| `get_content_grade` | Retrieve grade results  |
| `optimize_content`  | AI-powered optimization |
| `fetch_serp_data`   | SERP competitor data    |

#### Publishing & Distribution

| Tool                          | Purpose                                       |
| ----------------------------- | --------------------------------------------- |
| `publish_content`             | Push to CMS (Ghost, WordPress, Webflow, etc.) |
| `publish_social`              | Immediate social publish (new post)           |
| `schedule_social`             | Scheduled social publish (new post)           |
| `schedule_social_draft`       | Schedule an existing draft post               |
| `publish_social_draft`        | Publish an existing draft post immediately    |
| `bulk_schedule_social_drafts` | Bulk schedule/publish drafts                  |
| `publish_carousel`            | LinkedIn carousel publish                     |

#### Performance & Analytics (via Performance Hub)

| Tool                    | Purpose                                                                                                                    |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `get_brand_performance` | Full KPIs, visibility score, quick wins                                                                                    |
| `get_content_health`    | Top pages, content decay, striking distance, cannibalization                                                               |
| `get_ai_visibility`     | LLM mentions, prompts, cited pages, citation gaps                                                                          |
| `get_backlinks`         | Domain rating, backlink stats, referring domains                                                                           |
| `get_social_analytics`  | Live social analytics: impressions, engagements, reach, followers, best posting times, content decay, top posts with links |
| `get_gsc_queries`       | Google Search Console raw data                                                                                             |
| `get_content_calendar`  | Pipeline overview                                                                                                          |
| `list_social_posts`     | Social post history with analytics                                                                                         |

#### Newsletters

| Tool                  | Purpose                                            |
| --------------------- | -------------------------------------------------- |
| `generate_newsletter` | Generate weekly newsletter from published articles |
| `list_newsletters`    | List generated newsletters                         |
| `get_newsletter`      | Get newsletter content + HTML                      |

#### Link Engine

| Tool                     | Purpose                                    |
| ------------------------ | ------------------------------------------ |
| `list_link_sites`        | List sites with Link Engine status + stats |
| `get_link_stats`         | Dashboard overview (total, active, URLs)   |
| `update_link_site`       | Update site Link Engine settings           |
| `bulk_update_link_sites` | Bulk update status/category                |
| `refresh_link_sitemaps`  | Re-index sitemaps after publishing         |
| `get_link_categories`    | List link categories                       |
| `create_link_category`   | Create a category for organizing sites     |
| `delete_link_category`   | Remove a link category                     |

#### Configuration

| Tool                        | Purpose                                                      |
| --------------------------- | ------------------------------------------------------------ |
| `update_content_strategy`   | Set article defaults, social automation, newsletter settings |
| `update_brand_context`      | Update Brand DNA                                             |
| `update_brand_visual_style` | Update visual identity                                       |
| `create_knowledge`          | Add knowledge base documents                                 |

#### UI-Only Features (Not Yet in API/MCP)

| Feature              | What It Does                                                                                                                    | Access                                              |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| **Link Marketplace** | Browse 1000s of guest post/link insertion opportunities from publishers. Filter by DR, traffic, price, language, region, niche. | `/link-marketplace`                                 |
| **Expert Reviews**   | Request human expert reviews from industry specialists matched to your brand. Track pending and completed reviews.              | `/author-reviews`, requires Authorship subscription |

***

### Tips for AI Agent Developers

1. **Start with `list_sites` + `get_brand`** to get full brand context before any operation
2. **Use `get_content_strategy`** to understand the current automation setup before making changes
3. **Use `topic` instead of `article_title`/`article_summary`** for standalone social posts that don't reference an article
4. **Chain `grade_content` + `optimize_content`** for articles: this is what differentiates Cuppa from simple generation
5. **Use `get_brand_performance`** as the starting point for feedback loops: it shows KPIs, visibility score, and quick wins in one call
6. **`get_content_health`** identifies your biggest optimization opportunities: decaying pages, striking distance keywords, cannibalization
7. **`get_ai_visibility`** tracks how your brand appears in ChatGPT and Google AI Overviews
8. **The content calendar** (`get_content_calendar`) shows everything across articles, local pages, and social posts in one view
9. **Use `generate_newsletter`** to create weekly roundups from published articles: pair with `update_content_strategy` to enable automated weekly newsletters
10. **Partial updates work** with `update_content_strategy`: only send the sections you want to change
11. **Pass `site_id` to `generate_image`** for automatic brand color injection: this makes every generated image on-brand
12. **Always use `generate_video_script` before `create_video`**: the script tool generates optimized prompts, shot breakdowns, and suggested settings
13. **Use mood boards as creative briefs**: `generate_mood_board` auto-creates visual direction from Brand DNA, which you can reference when generating campaign images/videos
14. **`generate_images_bulk`** is the fastest way to add brand-consistent images across multiple articles at once
15. **Video is async**: `create_video` returns an ID, poll `get_video_status` until complete to get the final URL
16. **After publishing new content, refresh link sitemaps**: call `refresh_link_sitemaps` so the Link Engine can discover and interlink your new pages
17. **The Performance Hub aggregates 7 data sources** (GSC, GA4, Ahrefs, Firehose, LLM Tracking, DataForSEO, Late.dev) so agents don't need to query each integration separately

***

***