# GenerateBanners MCP

> GenerateBanners MCP Server. Automatically creates professional ad banners and social media graphics. Connect your AI agent to manage templates, render dynamic visuals, and maintain brand consistency without manual design work. Use natural conversation to list templates, override text, and get real-time URLs for immediate deployment.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** automated-rendering, template-orchestration, dynamic-imaging, marketing-assets, brand-guidelines, graphic-design, api-first

## Description

You connect your AI agent to the **GenerateBanners MCP Server** to build professional ad banners and social media graphics on the fly. You use natural conversation with your agent to manage templates, render dynamic visuals, and keep your brand looking consistent without ever touching a design program. You'll get real-time URLs for immediate deployment across any platform.

**Search and List Templates**

You can find existing design templates by running `search_templates` using keywords or by calling `list_templates` to see all designs within a specific project. For the full technical breakdown of a single template, you've got `get_template`. Before you start, you can get a rundown of all available design categories by using `list_categories`.

**Create and Manage Projects**

You can set up and organize all your visual assets by first running `create_project` to start a new, named project. You'll keep tabs on your workspace list of all user-created projects using `list_projects`, and you can check the full details of any project you've set up by calling `get_project`. If a project is done, you can permanently wipe it with `delete_project`.

**Automate Banner Rendering**

To generate a single banner, you'll use `render_template`, which lets your agent override content layers and fill in text or images. If you need a bunch of banners at once, you can run `render_batch` using a set of templates and specific data points. Your agent handles the rendering process, generating new images and banners for you.

**Check Account Status**

Before you start a big rendering job, you should check your connection status with `check_gb_status` or see what you've got left by calling `get_account` to check your remaining credits.

**Retrieve Project Details**

To get specific info on an existing project, just use `get_project`.


## Tools

### check_gb_status
Verifies the connection status to the GenerateBanners service.

### create_project
Creates a new, named project within the GenerateBanners platform.

### delete_project
Permanently removes an existing project.

### get_account
Retrieves current account information, including plan details and credits.

### get_project
Fetches detailed information about a specific project ID.

### get_template
Retrieves the full technical details for a single design template.

### list_categories
Lists all available design categories in the system.

### list_projects
Retrieves a list of all user-created projects.

### list_templates
Lists all available design templates for a specified project.

### render_batch
Generates multiple banners at once using a specified set of templates and data points.

### render_template
Generates a single banner instance using a specific template and overriding content layers.

### search_templates
Finds design templates matching specific keywords or criteria.

## Prompt Examples

**Prompt:** 
```
List all my image templates in GenerateBanners.
```

**Response:** 
```
I've retrieved your templates. You have 5 designs available, including 'Social Media Promo' (ID: 123) and 'Email Header' (ID: 456). Which one would you like to use for a new render?
```

**Prompt:** 
```
Render a banner using template '123' with text '20% OFF' and a new background image.
```

**Response:** 
```
Banner rendered! I've applied the '20% OFF' override and updated the background image as requested. You can view your new asset here: [link].
```

**Prompt:** 
```
Check my GenerateBanners credit balance.
```

**Response:** 
```
You currently have 850 generation credits remaining on your account. Your plan resets on the 1st of next month.
```

## Capabilities

### Search and List Templates
Find existing design templates using `search_templates` or list all available designs using `list_templates`.

### Create and Manage Projects
Set up and organize visual assets by creating new projects with `create_project` and managing existing ones via `get_project` and `delete_project`.

### Automate Banner Rendering
Generate new images and banners by dynamically calling `render_template` or `render_batch`, allowing you to override text and images.

### Check Account Status
Verify connectivity with `check_gb_status` or monitor usage with `get_account` to see remaining credits.

### Retrieve Project Details
Get specific information about an existing project using `get_project`.

### Handle Categories
List available design categories using `list_categories`.

## Use Cases

### Scaling Product Launches
A brand manager needs 50 different product banners for a sale. Instead of designing them individually, the manager asks their agent to use `search_templates` to find the right style, then executes `render_batch` with the product SKUs and sale prices. The agent returns 50 unique, ready-to-use images.

### Updating Campaign Headers
The marketing team needs to update a global email banner with a new promotion code. They ask their agent to `list_templates` to find the 'Email Header' design, then run `render_template`, passing the new code and background image. This is done in seconds, not hours of design work.

### Organizing Visual Assets
A content creator has hundreds of disparate banner files. They ask their agent to use `create_project` to group them logically, then use `list_projects` to keep a single, organized record of all visual work done for the quarter.

### Checking API Limits
A developer needs to ensure the automated pipeline won't fail. They first run `check_gb_status` to verify the connection, then use `get_account` to verify remaining generation credits before starting any large rendering job.

## Benefits

- Instantly generate personalized social media assets. Instead of manually editing banners for every campaign, use `render_template` to override text and images based on data inputs.
- Maintain perfect brand adherence across all materials. Your AI client manages the template structure, ensuring the final output respects your established brand guidelines every time.
- Scale product visuals instantly. For e-commerce, use the tools to run `render_batch`, generating hundreds of product images with dynamic pricing and sale overlays in minutes.
- Keep track of your assets easily. Use `list_projects` and `get_project` to keep a structured, organized library of all your banner work, never losing track of a campaign's assets.
- Monitor usage without delay. Before starting a big render, check your credits and plan details using `get_account` to avoid running out of generation capacity.
- Deploy assets immediately. The tools return real-time URLs for rendered banners, meaning you can drop the image into your CMS or email system right away.

## How It Works

The bottom line is: your AI client uses the tools to manage assets and render banners, giving you real-time URLs without touching the design software.

1. First, subscribe to the GenerateBanners service and retrieve your API Key from your account settings.
2. Next, prompt your AI client to list the templates or projects you need to work with (e.g., 'List all templates for Project X').
3. Finally, tell your AI client to render the banner, specifying the template ID and any dynamic content overrides (e.g., 'Use template 123, change the text to 20% off').

## Frequently Asked Questions

**How do I check my remaining credits using the GenerateBanners MCP Server?**
Run the `get_account` tool. This returns your current generation credit count and tells you when your plan resets.

**Can I use the GenerateBanners MCP Server to render a single banner?**
Yes, use the `render_template` tool. This lets you target one specific template ID and override only the needed content layers.

**What is the difference between `list_templates` and `search_templates`?**
Use `list_templates` to get a comprehensive list of every template ID. Use `search_templates` when you know keywords (like 'social media') and need the server to narrow down the options for you.

**How do I manage multiple campaigns at once with GenerateBanners MCP Server?**
Run `render_batch`. This tool is designed for volume. You provide the template and a list of data points, and it returns multiple rendered assets at once.

**Do I need to manage a project first with GenerateBanners MCP Server?**
It's best practice to run `create_project` first. This ensures that all your rendered assets are grouped under a specific, traceable project ID.

**How do I use the `get_account` tool to check my billing status on the GenerateBanners MCP Server?**
The `get_account` tool retrieves your current billing details and usage tier. It shows your plan's reset date and remaining credits, letting you plan for large rendering jobs.

**What happens if I use the `render_template` tool with invalid project data on the GenerateBanners MCP Server?**
The server returns a specific error code and detailed message. This tells you exactly what parameter—like a missing layer ID or bad text format—needs fixing before you can render the banner.

**Can I use `list_projects` to see all my saved work in the GenerateBanners MCP Server?**
Yes, `list_projects` fetches a list of all your existing project IDs. You can then use `get_project` with one of those IDs to see the specific details of a saved campaign.

**How do I find my API Key?**
Log in to your GenerateBanners.com account, navigate to your **Account Settings** or **API** section, and copy your unique key.

**Can I override multiple layers at once?**
Yes! The `render_template` tool accepts a JSON string in `overrides_json` where you can provide multiple key-value pairs for different layers.

**How do I track my remaining credits?**
Use the `get_account_info` tool to retrieve your current credit balance and plan limitations directly through your agent.