# BannerBite MCP MCP

> BannerBite. Generate high-quality images and videos instantly from pre-designed templates using only natural conversation. This MCP lets your AI client act as a full-time creative production manager for your brand, handling everything from generating social media assets to auditing complex video renders without you ever opening graphic design software.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** media-generation, dynamic-templates, visual-content, automated-design, rendering

## Description

BannerBite takes the headache out of visual content creation. You don't need to jump between Photoshop, Premiere Pro, and dozens of templates just to run a campaign or post an update. This connector lets your AI client talk directly to the media engine. Tell it: 'I need 5 versions of our new product ad for Instagram Stories.' The agent handles connecting to your stored templates, making the necessary text changes—like swapping out dates or price points—and rendering all five videos and images. You can ask it to list recent renders so you know if they finished processing, or even check a project's structure before generating anything. It turns complex visual workflows into simple chat commands. To manage these capabilities, connecting BannerBite through the Vinkius catalog lets your agent access this entire suite of tools across all your preferred AI clients.

## Tools

### generate_image
Creates a finished static image file from a specified project template.

### generate_media
Generates either an image or video by applying dynamic text and layer changes to a template.

### generate_video
Renders and outputs a final, complete video file from a designated project.

### get_account_check
Verifies the connection status of your BannerBite account credentials.

### get_project
Retrieves all details for a specific project by its ID or name.

### get_render
Checks the status and retrieves information about one specific media render job.

### list_bites
Lists all individual scenes ('bites') that make up a single project template.

### list_projects
Retrieves a list of all active and archived media projects associated with your account.

### list_renders
Fetches a comprehensive list of all recent rendering jobs, showing their status and completion details.

## Prompt Examples

**Prompt:** 
```
List all my BannerBite projects.
```

**Response:** 
```
I've retrieved your BannerBite projects. You have 3 active projects: 'Summer Sale', 'New Feature Announcement', and 'Event Invite'. Which one would you like to use for generation?
```

**Prompt:** 
```
Generate an image for project 'Summer Sale' with text '50% OFF' on layer 'headline'.
```

**Response:** 
```
I'm starting the render for your 'Summer Sale' image with the requested headline. Your static image will be ready in a few seconds. Render ID: `rend_12345`.
```

**Prompt:** 
```
Show me the status of my recent renders.
```

**Response:** 
```
I've found 5 recent renders. The last one (`rend_12345`) is 'Completed' and available at this URL: https://bannerbite.com/r/abc.png. The others are also finished.
```

## Capabilities

### Generate dynamic media assets
Create finished images or videos by modifying text and layers within stored templates using natural language prompts.

### Manage creative projects
View all existing content campaigns, letting you map out every visual asset your brand has created.

### Audit media rendering status
Check the status and retrieve the final URL for any media file that is currently being processed or was recently completed.

### Inspect project components
Browse a project's individual scenes, called 'bites,' to see exactly what elements make up the overall creative piece.

### Verify account connection
Confirm that your BannerBite API credentials are connected and ready for use with your agent.

## Use Cases

### The weekly social media blast
A Marketing Manager has 12 product shots needed for a sale. Instead of manually changing headlines in twelve different templates, the agent uses `list_projects` to find the correct template, then runs `generate_media` repeatedly, changing only the headline and date each time.

### Checking campaign readiness
An Ops Lead needs to confirm if a critical ad video has finished processing. They ask their agent, which uses `list_renders`, instantly providing the status and final download URL for the most recent job.

### Debugging template issues
A Content Creator thinks a specific advertisement looks off. They use `get_project` to pull up all details, then use `list_bites` to check if the background layer is correctly linked before trying another render.

### Automated ad variations
A developer builds a marketing flow that needs 5 different versions of an image. The agent uses `generate_image`, passing five different color codes and copy texts, making the process repeatable without human intervention.

## Benefits

- You don't need to open a design program. Just tell your agent the changes you want, and it handles running `generate_media` against your stored templates for immediate results.
- Audit large campaigns easily. Use `list_renders` to see every job that ran recently, checking if they finished or where they failed without logging into a separate dashboard.
- Keep track of everything using `list_projects`. You get an overview of all campaign assets and project IDs needed for subsequent generation steps.
- Pinpoint issues with templates. If the output looks wrong, use `get_project` or `list_bites` to inspect the template structure before trying another render.
- Build automated content flows. Integrate media creation directly into your AI workflows; your agent manages the full lifecycle from idea to final PNG/MP4 delivery.

## How It Works

The bottom line is that your AI client handles all the API complexity, allowing you to manage dynamic content creation through simple conversation.

1. Subscribe to this MCP and input your unique BannerBite API key into your preferred AI client.
2. Tell your agent exactly what you need; for instance, 'Generate a video for the Summer Sale using project ID 456.'
3. The agent executes the required calls, sends you updates on rendering status, and returns the final media file or link.

## Frequently Asked Questions

**How do I know if BannerBite is connected correctly?**
Run the `get_account_check` tool first. This verifies your connection status, confirming that all credentials are active and ready for use with your agent.

**Can I generate a video without knowing the project ID?**
No. You must first run `list_projects` to get an accurate list of IDs. Then, you can pass that ID to `generate_media` or use `get_project` for details.

**What is the difference between generating media and generating a video?**
Using `generate_media` allows dynamic changes (like text swaps) on an image or video template. Use `generate_video` when you want to finalize and output the full, completed MP4 file from a known project.

**How many types of assets can BannerBite handle?**
It handles both static images (PNG) and video files (MP4), letting you manage everything from simple social media graphics to complex animated ads.

**If I use `get_render` and my media generation fails, how do I check the specific error code?**
The response will include a detailed failure object. This object contains an error message and a unique diagnostics ID that helps our support team pinpoint why the render failed. You'll need to pass this ID for accurate troubleshooting.

**When running `generate_media`, what format must my dynamic layer modifications take?**
You must provide key-value pairs specifying the exact layer name and the desired content type (text, image URL, color hex). The system needs this precise mapping to apply changes correctly during rendering.

**Are there any rate limits when I run `list_projects` followed by multiple generations?**
Yes, usage is governed by a tiered request limit. If you exceed the current project's cap, your agent will receive a specific 429 error code indicating how long to wait before retrying.

**If I use `get_project` on an archived template, what metadata can I still retrieve?**
You can still retrieve the core project metadata, including its last modified date and a full list of available layers. However, any content that has been deleted or deprecated will show as null data.

**How do I specify which text to change in a template?**
When using the `generate_media` tool, provide a JSON string in the `modifications_json` parameter. Use the layer names from your BannerBite project as keys (e.g., `{"text_1": "New Headline"}`). Your agent can help you identify these layers by listing project bites.

**Can I generate static images instead of videos?**
Yes. Use the `generate_image` tool for static PNG files or `generate_video` for MP4 files. Both tools allow for the same dynamic layer modifications through natural language commands.

**Where do I find the final generated media file?**
The generation tools return a Render object containing a public URL. You can also use the `get_render` tool with a Render ID to retrieve the status and download link for any recent production.