# Bannerbite — how to use (mcp.ai)

Connect your Bannerbite account and use 6 tools for images and design straight from your AI agent. Connect with your own API key. Bannerbite is a creative automation platform for generating images and videos from reusable projects and templates.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_bannerbite?ms=1787295840000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `bannerbite_generate_media`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/bannerbite`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/bannerbite/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/bannerbite/generate/media` — Queue one asynchronous image, video, or overlay render from a Bannerbite bite. WARNING: a valid call consumes render credits and queues external asynchronous work; it may also send completion updates 
  - body: { audio?: object, scene?: integer, media_type?: string, scene_data: object[], webhook_url?: string, notification_email?: string, bite_id_or_access_token: string|integer }
- `POST https://api.mcp.ai/api/bannerbite/get/bite` — Return one Bannerbite bite by its numeric bite ID, including template and output-size details; fail explicitly when the bite does not exist.
  - body: { bite_id: integer }
- `POST https://api.mcp.ai/api/bannerbite/get/project` — Return one Bannerbite project by its numeric project ID; fail explicitly when the project does not exist.
  - body: { project_id: integer }
- `POST https://api.mcp.ai/api/bannerbite/get/scene/data` — Return the editable scene fields for a Bannerbite bite so their names and current values can be used in a render request.
  - body: { bite_id: integer }
- `POST https://api.mcp.ai/api/bannerbite/list/bites` — Return one provider page of Bannerbite bites in a project, up to 100 bites; the API exposes no verified way to request another page.
  - body: { limit?: integer, project_id: integer }
- `POST https://api.mcp.ai/api/bannerbite/list/projects` — Return one provider page of projects owned by the connected Bannerbite account, up to 100 projects; the API exposes no verified way to request another page.
  - body: { limit?: integer }

## Example prompts
- "What can I do in Bannerbite?"
- "Show me a summary of my Bannerbite account"

## More
- Page: https://mcp.ai/bannerbite
- Agent spec (llms.txt): https://mcp.ai/bannerbite/llms.txt
- Postman collection: https://mcp.ai/bannerbite/postman.json