KosmoKrator

media

Bannerbear MCP Integration for OpenAI Agents SDK

Connect Bannerbear to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

10 functions 7 read 3 write API key auth
Submit Bannerbear feedback View package source

Connect Bannerbear to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Bannerbear MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-bannerbear": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=bannerbear",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=bannerbear --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Bannerbear instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Bannerbear Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Bannerbear integration catalog.

MCP toolSource functionTypeDescription
integration__bannerbear__bannerbear_create_image bannerbear.bannerbear_create_image Write Generate an image from a Bannerbear template. Provide a template ID and an array of modifications to customize text, images, colors, and other layers. The image is generated asynchronously — use get_image to check status and retrieve the final URL.
integration__bannerbear__bannerbear_get_image bannerbear.bannerbear_get_image Read Retrieve the status and download URL of a previously created Bannerbear image. Images are generated asynchronously, so poll this endpoint until status is "completed".
integration__bannerbear__bannerbear_list_images bannerbear.bannerbear_list_images Read List previously created Bannerbear images. Returns image UIDs, statuses, and download URLs. Supports pagination via page and limit parameters.
integration__bannerbear__bannerbear_list_collections bannerbear.bannerbear_list_collections Read List Bannerbear collections. Collections are groups of images generated from a single template with different data. Supports pagination via page and limit parameters.
integration__bannerbear__bannerbear_create_video bannerbear.bannerbear_create_video Write Generate a video from a Bannerbear template. Provide a template ID and an array of modifications per scene. The video is generated asynchronously — use get_video to check status and retrieve the final URL.
integration__bannerbear__bannerbear_get_video bannerbear.bannerbear_get_video Read Retrieve the status and download URL of a previously created Bannerbear video. Videos are generated asynchronously, so poll this endpoint until status is "completed".
integration__bannerbear__bannerbear_list_templates bannerbear.bannerbear_list_templates Read List all available Bannerbear templates. Returns template UIDs, names, dimensions, and preview URLs. Use a template UID with create_image or create_video.
integration__bannerbear__bannerbear_get_template bannerbear.bannerbear_get_template Read Get details for a specific Bannerbear template, including all available modification layers (text, image, color, etc.). Use this to discover which layer names to use when calling create_image or create_video.
integration__bannerbear__bannerbear_create_animated_gif bannerbear.bannerbear_create_animated_gif Write Generate an animated GIF from a Bannerbear template. Provide a template ID and an array of modifications per frame. The GIF is generated asynchronously — use get_image with the returned ID to check status.
integration__bannerbear__bannerbear_get_current_user bannerbear.bannerbear_get_current_user Read Get the authenticated Bannerbear account details, including plan info and usage.

Related Bannerbear Pages

Bannerbear CLIUse direct JSON commands instead of MCP discovery. Bannerbear MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.