AdsumoDashboard

Available Tools

Reference for the 24 MCP tools Adsumo exposes — brand and product setup, image and video generation, editing, ad-library research, and account info.

Adsumo's MCP server exposes 24 tools. Read-only tools work on any plan; tools marked generate or write require an active paid plan. Generation tools cost credits from your team's balance.

Generation tools are asynchronous: they return a generation_id with status: "processing". In supported clients the result renders inline and updates automatically; otherwise poll with get_generation.

Account & status

get_credits

Return your team's credit balance. Read.

  • No parameters.
  • Returns: credits_used, credits_limit, credits_remaining.

get_generation

Check the status and result of a generation by ID. Read.

  • generation_id (required) — the ID returned by a generation tool.
  • Returns: status and, when complete, the output image/video URLs.

list_avatars

List platform and custom avatars. Read.

  • kind (optional) — filter by avatar type.

list_brands

List your team's brand profiles. Read.

  • Returns each brand plus has_logo, has_reference_image, and needs_setup flags so the AI can tell when a brand needs enriching before brand-aware generation.

list_products

List your team's products. Read.

  • Returns each product plus has_image / is_draft setup signals.

Brand & product setup

create_brand / update_brand

Create or update a brand profile. Write.

  • source_url (optional) — a website to scrape for name, description, audience, brand voice, colors, logo, and a reference image.
  • Or compose fields directly: name, description, industry (enum), website_url, brand_voice, target_audience, brand_color_primary / brand_color_accent (hex), logo_url, reference_image_url (the last two from upload_media).
  • set_primary (optional) — make it the default brand. update_brand also requires brand_id.
  • New brands are capped by your plan's brand limit. Renders a brand-preview card.

create_product / update_product

Create or update a product. Write.

  • source_url (optional) — a product page to scrape, or compose fields: name, description, category (enum), price, currency, link, brand_id, image_url (from upload_media).
  • update_product also requires product_id. Renders a product-preview card.
  • Products double as generation references — pass product_ids to the image and video tools to feature the real product.

Image generation

All image tools share model (gpt-2 | pro | fast), resolution (1k | 2k | 4k), and quantity (1–8). gpt-2 also accepts effort (low | medium | high). Aspect ratios: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 (edits also allow auto). Cost is roughly 1–7 credits per image depending on model, effort, and resolution.

generate_image

Generate image ads from a prompt. Generate.

  • prompt (required), model (required), aspect_ratio (required).
  • brand_id (optional) — generate on-brand. product_ids (optional, ≤3) — feature your products.

edit_image

Edit or remix images with a prompt. Generate.

  • prompt (required), model (required), aspect_ratio (required, supports auto).
  • Source images via reference_image_urls and/or source_generations ({ generation_id, image_index? }, ≤3) to iterate on earlier generations. Composes with brand_id / product_ids. Each edit returns a new generation_id, so edits chain.

generate_product_shots

Generate styled product photography. Generate.

  • product_id (required), style_id (required), model (required), aspect_ratio (required).
  • additional_prompt (optional), brand_id (optional).

localize_image

Translate the text inside images. Generate.

  • source_image_urls (required, 1–4), target_languages (required, 1–5 ISO codes).
  • note (optional) — translation tone/guidance. Supports 20 languages (en, es, fr, de, it, pt, nl, da, sv, no, fi, pl, ja, ko, zh, ar, tr, ru, hi, th).

change_image_aspect_ratio

Reframe images to new aspect ratios. Generate.

  • source_image_urls (required, 1–4), target_aspect_ratios (required, 1–4).
  • Recomposes the image to fit, rather than cropping or stretching.

Video generation

generate_ai_video

Generate an AI video ad. Generate. Parameters depend on the chosen model; invalid combinations are rejected by the schema. Cost ranges from ~1 to 60 credits depending on model, duration, and resolution.

  • seedance-2.0 (and -fast, -frames, -frames-fast) — prompt, aspect_ratio, duration (4–15s), resolution (480p/720p/1080p), optional generate_audio, reference / first- / last-frame images. Recommended. Supports brand & product image references via brand_id and product_ids.
  • sora-2 / sora-2-pro — prompt, aspect_ratio (16:9/9:16), duration (4/8/12/16/20), optional reference_image_url; hd on Pro.
  • veo-3.1 / veo-3.1-fast — prompt, aspect_ratio, duration (4/6/8), resolution (up to 4k), optional audio and frame references.
  • kling-2.6 — prompt, aspect_ratio, duration (5/10), optional audio and reference image.
  • kling-o3 — prompt, quality (standard/pro/4k, default pro), aspect_ratio (16:9/9:16/1:1), duration (3–15s), optional generate_audio (default true), reference_image_urls (≤4), first_frame_image_url / last_frame_image_url. Supports brand & product image references via brand_id and product_ids.

Media upload

upload_media

Open an in-chat uploader to add local images (product photos, logos). Generate scope.

  • No parameters — shows a multi-file picker widget. Returns public URLs to pass into create_brand, create_product, or the image tools.

create_upload_url

Mint a presigned upload URL for terminal clients. Generate scope.

  • content_type (required: image/png | image/jpeg | image/webp), filename (optional).
  • Returns an upload_url to PUT a local file to, plus the resulting public_url. Use this from Claude Code / Cursor instead of the widget.

store_upload is an internal tool the in-chat uploader calls to store picked bytes — you don't call it directly.

Display & plans

show_brands / show_products

Display up to 6 brands or products as a visual card grid. Read.

  • Pass the IDs to show (from list_brands / list_products); order is preserved.

show_plans

Show subscription tiers, your current plan, credit balance, and an upgrade link. Read.

  • No parameters.

Ad library research

search_ad_library_brands

Find brands in the ad library. Read.

  • query (optional), category (optional), limit (1–50), offset.

search_ad_library_ads

Search ads in the ad library. Read.

  • brand_id, category, search, media_type (image | video), limit (1–20), offset — all optional.
  • Returns ad metadata: title, body, media URL, start date, EU reach.

view_ad_library_ads

Deep-dive on specific ads. Read.

  • ad_ids (required, 1–3).
  • Returns full detail: CTA, link, platforms, display format, dates, reach, and the viewable media.