# How to integrate Bannerbear MCP with Atomic Agent ```json { "title": "How to integrate Bannerbear MCP with Atomic Agent", "toolkit": "Bannerbear", "toolkit_slug": "bannerbear", "framework": "Atomic Agent", "framework_slug": "atomic-agent", "url": "https://composio.dev/toolkits/bannerbear/framework/atomic-agent", "markdown_url": "https://composio.dev/toolkits/bannerbear/framework/atomic-agent.md", "updated_at": "2026-08-11T13:06:35.209Z" } ``` ## Introduction Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Bannerbear. This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Bannerbear account. See the [Atomic Agent documentation](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions. ## Also integrate Bannerbear with - [OpenAI Agents SDK](https://composio.dev/toolkits/bannerbear/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/bannerbear/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/bannerbear/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/bannerbear/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/bannerbear/framework/codex) - [OpenClaw](https://composio.dev/toolkits/bannerbear/framework/openclaw) - [Hermes](https://composio.dev/toolkits/bannerbear/framework/hermes-agent) - [Google ADK](https://composio.dev/toolkits/bannerbear/framework/google-adk) - [LangChain](https://composio.dev/toolkits/bannerbear/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/bannerbear/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/bannerbear/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/bannerbear/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/bannerbear/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/bannerbear/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/bannerbear/framework/autogen) ## TL;DR ### How Atomic Agent connects to Bannerbear Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication. Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account. ## Connect Bannerbear to Atomic Agent ### Connect Bannerbear to Atomic Agent - Sign up or sign in to the [Composio dashboard](https://dashboard.composio.dev/?cta_placement=atomic-agent-api-key). Copy your API key. - In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart. - Ask Atomic Agent to do something in Bannerbear. It searches Composio for the right tool. - On first use, open the sign-in link returned in the chat. Connect your Bannerbear account, then return to Atomic Agent to continue. ### Headless setup Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file. ```bash COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY ``` ## What is the Bannerbear MCP server, and what's possible with it? The Bannerbear MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Bannerbear account. It provides structured and secure access to your Bannerbear workspace, so your agent can generate images, create videos, manage templates, merge PDFs, and retrieve creative assets on your behalf. - Automated image and video generation: Enable your agent to create customized graphics or videos at scale using your Bannerbear templates and project assets. - Template browsing and management: Let your agent list, inspect, and select templates or template sets for creative projects, making it easy to automate content workflows. - Font and asset discovery: Have your agent retrieve available fonts and signed bases, ensuring the right design elements are used for every creative output. - PDF merging automation: Direct your agent to combine multiple PDFs into a single document, streamlining report or collateral creation. - Account and usage monitoring: Allow your agent to fetch current account status, API usage, and quota information to keep your creative operations running smoothly. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `BANNERBEAR_CREATE_PROJECT` | Create Project | Creates a new Bannerbear project with the specified name and optional settings. Use this tool to create new projects for organizing templates and API resources. Note: This action requires a Master API Key. Project-specific API keys cannot create new projects. | | `BANNERBEAR_CREATE_SIGNED_BASE` | Create Signed Base | Tool to create a signed URL base for a template. Used for generating images via signed URLs. Signed bases enable on-demand image generation using encrypted URL parameters without requiring API calls for each image. Use when you need to create dynamic images through URL manipulation. | | `BANNERBEAR_CREATE_TEMPLATE` | Create Template | Create a new blank template in a Bannerbear project. Use when you need to programmatically create templates via API. Note: Templates can only be created via API if you have a Master API Key. | | `BANNERBEAR_CREATE_TEMPLATE_SET` | Create Template Set | Tool to create a new template set by grouping multiple templates together. Use when you need to organize related templates into a single set for batch image generation. Template sets allow you to apply the same modifications to multiple templates simultaneously via a single API call. | | `BANNERBEAR_CREATE_VIDEO_TEMPLATE` | Create Video Template | Tool to create a new video template for video generation in Bannerbear. Video templates are based on existing image templates and hold additional rendering instructions for creating videos. Use when you need to set up a reusable template for generating videos with overlays, transcriptions, or multi-layer video compositions. | | `BANNERBEAR_CREATE_WEBHOOK` | Create Webhook | Create a project-level webhook that fires for all events of a specific type. Use this tool to register a URL that will receive POST requests when events occur in your Bannerbear project. Note: When using a Master API Key, you must provide a project_id parameter. Project API Keys do not require project_id. | | `BANNERBEAR_DELETE_TEMPLATE` | Delete Template | Tool to delete a template referenced by its unique ID. Use when you need to permanently remove a template from a Bannerbear project. Note: This action requires a project_id when using a Master API Key. | | `BANNERBEAR_DELETE_WEBHOOK` | Delete Webhook | Tool to delete a webhook referenced by its unique ID. Use when you need to remove a webhook that is no longer needed. Requires the webhook UID and project ID (when using Master API Key). | | `BANNERBEAR_GET_ACCOUNT_INFO` | Get Account Info | Retrieves Bannerbear account information including subscription plan, API usage, and quota limits. Use this tool to: - Check current API usage and remaining quota (resets monthly) - Verify the subscription plan - Get details about the current project Note: When using a Master API Key, you must provide a project_id parameter. Project API Keys do not require project_id. | | `BANNERBEAR_GET_ANIMATED_GIF` | Get Animated GIF | Tool to retrieve a single Animated Gif object by its unique identifier (UID). Use when you need to check the status of a specific animated GIF, get its rendered URL, or retrieve detailed information about its configuration. The status field indicates the rendering progress: 'pending' (still processing), 'completed' (ready with image_url populated), or 'failed'. Poll this endpoint to monitor rendering progress, or use webhook_url for automatic notifications. | | `BANNERBEAR_GET_AUTH` | Get Auth Status | Verify API authentication and check which project the API key is scoped to. Use this to validate credentials before making other API calls or to confirm the project context. | | `BANNERBEAR_GET_FONTS` | Get Available Fonts | This tool retrieves a list of all available fonts in Bannerbear. The fonts are categorized into Serif, Sans Serif, Novelty, International, and Custom, and can be used to verify font availability prior to creating or modifying images. | | `BANNERBEAR_GET_IMAGE` | Get Image | Retrieves a single Image object by its unique identifier (UID). Use this to check the status of an image generation request, retrieve the final image URL, or poll for completion. When using a Master API Key, you must provide the project_id parameter. | | `BANNERBEAR_GET_PROJECT` | Get Project | Retrieves detailed information about a specific Bannerbear project by its unique identifier (UID). Use this tool to get project details including name, creation date, template count, and feature settings. | | `BANNERBEAR_GET_SCREENSHOT` | Get Screenshot | Retrieve a single Screenshot object referenced by its unique ID. Use when you need to check the status or get the final screenshot URL for a previously created screenshot. | | `BANNERBEAR_GET_SIGNED_BASES` | Get Signed Bases | This tool retrieves a list of signed bases for a specific template. Signed bases are used to generate on-demand images using encrypted URL parameters. The endpoint returns a list of base URLs that can be used with the Signed URL feature. | | `BANNERBEAR_GET_TEMPLATE` | Get Template | Tool to retrieve a single template by its unique ID with layer defaults. Use when you need to get detailed information about a specific template including its dimensions, available modifications, and layer structure. | | `BANNERBEAR_GET_TEMPLATE_SET` | Get Template Set Details | This tool retrieves detailed information about a specific template set using its unique identifier (UID). Template Sets are sets of Templates that you group together in the Bannerbear dashboard. It provides comprehensive details about the template set including its name, available modifications, and the list of templates inside the set. | | `BANNERBEAR_GET_WEBHOOK` | Get Webhook | Retrieves a single Webhook object by its unique ID. Use this to get details about a specific webhook including its URL, event type, and creation timestamp. | | `BANNERBEAR_HYDRATE_PROJECT` | Hydrate Project | Hydrate a project by copying templates from another project. Useful for white-label setups where you need to duplicate templates across multiple projects. Both the source and destination projects must be under the same account. | | `BANNERBEAR_IMPORT_TEMPLATE` | Import Template | Tool to import templates from the Bannerbear template library or from other projects. Use when you need to add publicly-available templates to your project. Note: Only publication IDs (public templates) can be imported, not private template IDs. | | `BANNERBEAR_JOIN_PDFS` | Join PDFs | Merges multiple PDF files into a single combined PDF document. This tool accepts an array of publicly accessible PDF URLs and combines them in order into one merged PDF file. The operation is asynchronous - the response will initially have status 'pending' and you should poll the 'self' endpoint or use a webhook to get the final 'joined_pdf_url' when status becomes 'completed'. Note: When using a Master API Key (account-level key), you must provide the project_id parameter. | | `BANNERBEAR_LIST_ANIMATED_GIFS` | List Animated GIFs | Lists all animated GIFs in a Bannerbear project. Retrieves a paginated list of all animated GIFs that have been created in your Bannerbear project. When using a Master API Key, you must provide the project_id parameter. Returns up to 25 animated GIFs per page by default, configurable up to 100 using the limit parameter. | | `BANNERBEAR_LIST_COLLECTIONS` | List Collections | Lists all collections in a Bannerbear project. Retrieves a paginated list of all collections that have been created in your Bannerbear project. When using a Master API Key, you must provide the project_id parameter. Returns up to 25 collections per page by default, configurable up to 100 using the limit parameter. | | `BANNERBEAR_LIST_EFFECTS` | List Effects | Tool to list all available image effects in Bannerbear. Use when you need to discover which effects can be applied to images or templates in the Bannerbear API. | | `BANNERBEAR_LIST_IMAGES` | List Images | Lists all images in a Bannerbear project. Retrieves a paginated list of all images that have been created in your Bannerbear project. When using a Master API Key, you must provide the project_id parameter. Returns up to 25 images per page by default, configurable up to 100 using the limit parameter. | | `BANNERBEAR_LIST_PROJECTS` | List Projects | Lists all projects in a Bannerbear account. This action retrieves a paginated list of all projects in your Bannerbear account. Use when you need to discover available projects or obtain project UIDs for other actions. Requires a Master API Key (not a project-specific API key). | | `BANNERBEAR_LIST_SCREENSHOTS` | List Screenshots | Lists all screenshots in a Bannerbear project. Retrieves a paginated list of all screenshots that have been created in your Bannerbear project. When using a Master API Key, you must provide the project_id parameter. Returns up to 25 screenshots per page by default, configurable up to 100 using the limit parameter. | | `BANNERBEAR_LIST_TEMPLATES` | List Templates | This action retrieves a list of all templates available in your Bannerbear project. It returns an array of template objects including properties like uid, name, dimensions, creation and update timestamps, template type, preview URL, and modifications. The tool is used for listing templates, retrieving template UIDs for subsequent actions such as image or video creation, and managing project templates. | | `BANNERBEAR_LIST_TEMPLATE_SETS` | List Template Sets | Tool to list all template sets inside a project with pagination support. Template Sets are groups of Templates that you organize in the Bannerbear dashboard. Use when you need to retrieve all template sets or paginate through them. | | `BANNERBEAR_LIST_VIDEOS` | List Videos | This action retrieves a list of all videos created in your Bannerbear account. It returns an array of video objects including properties like uid, status, timestamps, video and preview URLs, as well as template and modification details. The tool is used for listing videos, monitoring video status, and managing project videos. | | `BANNERBEAR_LIST_VIDEO_TEMPLATES` | List Video Templates | This action retrieves a list of all video templates available in your Bannerbear project. It returns an array of video template objects including properties like uid, name, dimensions, and creation timestamps. The tool is used for listing video templates and retrieving template UIDs for subsequent video creation actions. | | `BANNERBEAR_UPDATE_TEMPLATE_SET` | Update Template Set | Tool to update a template set by modifying its list of templates. The template set will be cleared first and the new list applied. Use when you need to change which templates are included in a template set. Template Sets are sets of Templates that you group together in the Bannerbear dashboard. | ## Supported Triggers None listed. ## Troubleshooting ### Why is my API key rejected? Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying. ### Why are Composio tools unavailable after saving a key? Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk. ### Does Composio have a free plan? The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See [Composio pricing](/pricing) for the current limits that apply to your connection. ## Complete Code None listed. ## Conclusion ### Use Bannerbear from Atomic Agent With your account connected, ask Atomic Agent to work with Bannerbear in natural language. You can connect more apps through the same Composio integration as you need them. Visit the [Atomic Agent website](https://atomicagent.io/?cta_placement=atomic-agent-site) or inspect the [Atomic Agent source code](https://github.com/AtomicBot-ai/atomic-agent?cta_placement=atomic-agent-repo). ## How to build Bannerbear MCP Agent with another framework - [OpenAI Agents SDK](https://composio.dev/toolkits/bannerbear/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/bannerbear/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/bannerbear/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/bannerbear/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/bannerbear/framework/codex) - [OpenClaw](https://composio.dev/toolkits/bannerbear/framework/openclaw) - [Hermes](https://composio.dev/toolkits/bannerbear/framework/hermes-agent) - [Google ADK](https://composio.dev/toolkits/bannerbear/framework/google-adk) - [LangChain](https://composio.dev/toolkits/bannerbear/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/bannerbear/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/bannerbear/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/bannerbear/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/bannerbear/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/bannerbear/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/bannerbear/framework/autogen) ## Related Toolkits - [Figma](https://composio.dev/toolkits/figma) - Figma is a collaborative interface design tool for teams and individuals. It streamlines design workflows with real-time collaboration and easy sharing. - [Abyssale](https://composio.dev/toolkits/abyssale) - Abyssale is a creative automation platform for generating images, videos, GIFs, PDFs, and HTML5 content programmatically. It streamlines and scales visual content production for marketing, design, and operations teams. - [Alttext ai](https://composio.dev/toolkits/alttext_ai) - AltText.ai is a service that generates alt text for images automatically. It helps boost accessibility and SEO for your visual content. - [Are.na](https://composio.dev/toolkits/arena) - Are.na is a creative research platform for collecting images, links, notes, and ideas in channels. Use it to organize inspiration, build knowledge maps, and connect research across projects. - [Bannerbite](https://composio.dev/toolkits/bannerbite) - Bannerbite is a creative automation platform for generating images and videos from reusable projects and templates. It helps teams produce on-brand visual assets faster without rebuilding designs from scratch. - [Builder.io](https://composio.dev/toolkits/builder_io) - Builder.io is a visual development platform for managing content, models, assets, and Space configuration. Use it to ship editable digital experiences faster without waiting on every code change. - [Canva](https://composio.dev/toolkits/canva) - Canva is a drag-and-drop design suite for creating professional graphics, presentations, and marketing materials. It makes it easy for anyone to design with beautiful templates and a vast library of elements. - [Canva MCP](https://composio.dev/toolkits/canva_mcp) - Canva MCP is Canva's remote MCP server for accessing designs and content. It centralizes design assets and enables programmatic design workflows. - [Claid ai](https://composio.dev/toolkits/claid_ai) - Claid.ai delivers AI-driven image editing APIs for tasks like background removal, upscaling, and color correction. It helps automate and enhance image workflows with powerful, developer-friendly tools. - [Cloudinary](https://composio.dev/toolkits/cloudinary) - Cloudinary is a cloud-based platform for managing, uploading, and transforming images and videos. It streamlines media workflows and delivers optimized assets globally. - [Contentdrips](https://composio.dev/toolkits/contentdrips) - Contentdrips is an asynchronous rendering API for branded graphics and carousels. It turns reusable templates into on-brand social visuals at scale. - [Creatomate](https://composio.dev/toolkits/creatomate) - Creatomate is an API for generating automated videos, images, GIFs, and reusable media templates. Use it to turn structured data into polished visual content at scale. - [Cults](https://composio.dev/toolkits/cults) - Cults is a digital marketplace for 3D printing models, connecting designers and makers. It lets creators share, sell, and discover a huge variety of printable designs easily. - [DeepImage](https://composio.dev/toolkits/deepimage) - DeepImage is an AI-powered image enhancer and upscaler. Get higher-quality images with just a few clicks. - [Dreamstudio](https://composio.dev/toolkits/dreamstudio) - DreamStudio is Stability AI’s platform for generating and editing images with AI. It lets you easily turn ideas into stunning visuals, fast. - [Dynamic Mockups](https://composio.dev/toolkits/dynamic_mockups) - Dynamic Mockups is an API platform for generating product mockups, rendering templates, and managing visual asset catalogs. Use it to automate high-quality product visuals, AI images, and motion assets at scale. - [Dynapictures](https://composio.dev/toolkits/dynapictures) - Dynapictures is a cloud-based platform for generating personalized images at scale. Instantly create hundreds of custom visuals using your data sources, like Google Sheets. - [Eraser MCP](https://composio.dev/toolkits/eraser_mcp) - Eraser MCP is a workspace for creating and managing technical diagrams and structured documents. It helps teams organize, version, and export diagrams with collaboration-focused tooling. - [Excalidraw MCP](https://composio.dev/toolkits/excalidraw_mcp) - Excalidraw MCP is a no-auth MCP server for creating hand-drawn style diagrams in Excalidraw. Use it to generate visual sketches with viewport camera control and fullscreen editing. - [Fal.ai](https://composio.dev/toolkits/fal_ai) - Fal.ai is a generative media platform offering 600+ AI models for images, video, voice, and audio. Developers use Fal.ai for fast, scalable access to cutting-edge generative AI tools. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Bannerbear MCP? With a standalone Bannerbear MCP server, the agents and LLMs can only access a fixed set of Bannerbear tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Bannerbear and many other apps based on the task at hand, all through a single MCP endpoint. ### Can I use Tool Router MCP with Atomic Agent? Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Bannerbear tools. ### Can I manage the permissions and scopes for Bannerbear while using Tool Router? Yes, absolutely. You can configure which Bannerbear scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do. ### How safe is my data with Composio Tool Router? All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Bannerbear data and credentials are handled as safely as possible. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)