KosmoKrator

media

Bannerbear MCP Integration for Claude Agent SDK

Connect Bannerbear to Claude Agent 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 Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

Bannerbear MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "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 Claude Agent SDK

Claude Agent SDK 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 Claude Agent SDKClient-level gateway setup.