Media Management

Upload images, videos, and other media assets. Amba handles signed upload URLs, folder organization, and metadata.

How it works

Request an upload URL with filename and MIME type
Upload the file to the returned signed URL
The asset is registered with metadata, folder, and alt text
Use the CDN URL in content items, user avatars, etc.

MCP tools

Tool	Description
`amba_upload_media`	Register a media asset and get a signed upload URL
`amba_list_media`	List media assets with pagination and folder filtering

Example

Agent: "Upload a hero banner image"

amba_upload_media({
  project_id: "proj_xxx",
  filename: "hero-banner.png",
  mime_type: "image/png",
  size_bytes: 245000,
  alt_text: "App hero banner showing workout progress"
})

Returns:

{
  "data": {
    "id": "media_xxx",
    "upload_url": "https://storage.googleapis.com/...",
    "cdn_url": "https://cdn.amba.dev/media_xxx/hero-banner.png"
  }
}

Database tables

Table	Purpose
`media_assets`	Asset records with filename, MIME type, URLs, metadata
`media_folders`	Folder organization for assets

How it works

MCP tools

Example

Database tables

On this page