# GenerateBanners MCP MCP > GenerateBanners MCP automates visual marketing asset creation. Connect your AI agent to build professional ad banners and social media graphics using pre-set brand templates. You can dynamically change text, swap images, and render massive batches of assets without manual design work. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** automated-rendering, template-orchestration, dynamic-imaging, marketing-assets, brand-guidelines, graphic-design, api-first ## Description This connector lets you take full control of automated graphic production. Instead of opening a design suite and manually adjusting every banner, your AI agent handles the heavy lifting. It accesses stored template libraries and uses them to generate new visuals based on simple conversational instructions. You can tell it to create 10 versions of an ad for different products—and it does. If you need to check how many credits you have left or list all available project templates, your AI agent handles that too. Because this MCP is hosted on Vinkius, you connect once from any compatible client and get access to the entire catalog, making asset generation a simple chat command away. ## Tools ### check_gb_status Verifies your connection and checks if the service is operational. ### create_project Establishes a new, dedicated project container for organizing visual assets. ### delete_project Permanently removes an entire organized set of campaign assets. ### get_account Retrieves your current account details and usage metrics, like credit count. ### get_project Fetches the specific details of an existing project folder. ### get_template Retrieves all technical specifications and metadata for a chosen banner template. ### list_categories Lists the top-level groupings of available design templates. ### list_projects Displays all currently saved and organized campaign projects. ### list_templates Shows a complete list of every single usable banner design template. ### render_batch Generates multiple finished banners simultaneously, using the same template but different content inputs. ### render_template Creates a single new banner image by dynamically overriding text and assets within a chosen template. ### search_templates Finds specific templates quickly using keywords or filters instead of listing them all. ## 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 ### Check Account Status Verify your connection status and check your current credit balance. ### Manage Projects Create, read, and delete organized folders for related marketing campaigns. ### Discover Templates List available design templates or search specific ones by keyword. ### Generate Individual Banners Render a single, finished banner image using dynamic text and layered assets. ### Process Batch Renderings Create multiple banners at once for high-volume campaigns (e.g., end-of-season sales). ## Use Cases ### Handling a Flash Sale The e-commerce owner needs 30 banner variations for a flash sale across different categories. They use the agent to `search_templates` for 'sale promo' and then execute `render_batch`, providing the product list, discount code, and dates in one prompt. ### Rebranding Campaigns The marketing manager has a new company logo. They use the agent to access account details via `get_account` to confirm API permissions, then instruct it to update all current templates by calling `render_template`, ensuring brand consistency across every piece. ### Organizing Assets A content automator is starting a new quarterly push. They run `list_projects` to confirm no existing folders are in use, then call `create_project` before rendering any assets, keeping the work clean and auditable. ### Troubleshooting Render Failure The agent fails a render. The user first runs `check_gb_status` to confirm connectivity, diagnosing if the issue is account-related or template-specific before attempting any complex rendering tasks. ## Benefits - Stop manually tweaking images. Use `render_template` to override any text or image layer inside a template, making personalized banners instantly. - Scale up your output with the `render_batch` tool. Need 50 product variations? Specify them all at once instead of running 50 individual render commands. - Stay organized by using `list_projects` and `create_project`. Keep campaign assets separated so you never mix Q3 banners with Q4 designs. - Know your limits before starting. Run `get_account` to check remaining generation credits, ensuring your visual operations don't stop mid-campaign. - Find what you need fast. Use `search_templates` instead of scrolling through every option listed by `list_templates`; it cuts down time instantly. ## How It Works The bottom line is: you talk to your AI client like you're talking to an assistant, and the MCP executes complex visual tasks using pre-built templates. 1. First, connect your AI agent and use the `check_gb_status` tool to confirm account connectivity. 2. Next, tell your agent which project or template you want to work with. You can list all available projects using `list_projects`, then get specific details using `get_project`. 3. Finally, instruct your agent to render the banner—either by giving it text overrides for a single image (`render_template`) or by specifying a group of assets for batch processing (`render_batch`). ## Frequently Asked Questions **How do I check my credit balance using generatebanners MCP?** You use the `get_account` tool to retrieve account information, which includes your current generation credits and when the plan resets. This is always a good first step. **What's the difference between render_batch and render_template?** `render_template` makes one banner by overriding variables in an existing design; `render_batch` processes multiple unique banners at once, ideal for large-scale campaigns. **How do I find a template without listing them all with list_templates?** Use the `search_templates` tool instead. Just give it keywords like 'social' or 'e-commerce,' and it returns matching options much faster. **Do I need to use create_project before rendering anything?** While not mandatory, running `create_project` first keeps your work organized. It lets you group all related banners for a specific campaign into one dedicated folder. **How do I verify my API key status using the `get_account` tool?** The `get_account` function confirms your connection and provides crucial account metadata. It returns details like billing cycle dates, plan limits, and active user IDs without needing to run a render job. **What specific layer information can I retrieve using the `get_template` tool?** The `get_template` function returns detailed technical metadata about every element within a template. This includes dimension specs, layer names, and whether text fields are dynamic or static for advanced pre-flight checks. **If I no longer need a set of designs, how do I use `delete_project`?** The `delete_project` tool permanently removes the entire project structure and all associated assets from your account. Always confirm the Project ID before executing this command to prevent data loss. **What should I do if my render job fails using `render_template`?** If a render job fails, first check your account status via `get_account`. Errors often relate to exceeding the current generation limit or invalid template IDs. Re-run the command after verifying your remaining credits. **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.