KosmoKrator

media

Bannerbear MCP Integration for Codex

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

10 functions 7 read 3 write API key auth

Connect Bannerbear to Codex

Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy.

Register kosmo mcp:serve as a local stdio server and choose the integration allowlist. The gateway is local, scoped to this integration, and starts with --write=deny so Codex can inspect read-capable tools without receiving write access by default.

Bannerbear MCP Config for Codex

Keep write access denied or ask-based unless the workspace is trusted.

{
  "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 Codex

Codex 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