MCP Tools Reference

Generate a single (or multi-aspect-ratio batch) ad creative from a director-style prompt, with optional brand kit + logo composite.

Apply a natural-language instruction to an existing image — swap headlines, change colors, remove text, replace backgrounds — without regenerating the whole composition.

Upload a reference creative, get N variant concepts back that keep the structural framing but vary the vehicle / background / headline / CTA / colors.

Push a base64 image you already have on disk (cropped, resized, brand-overlayed) into your Claivra media library — usable in create_share, revise_share, edit_image.

Return every brand kit the authenticated user owns.

Fetch a single brand kit's full payload including logo data.

Create a new brand kit. Counts toward your plan's maxBrandKits limit.

Patch one or more fields on an existing brand. Only provided fields are written.

Permanently delete a brand kit by ID. Cannot be undone.

Return every niche profile (default + custom) plus the user's active profile ID.

Fetch full details of a single niche profile by ID.

Create a new niche profile. Counts toward your plan's maxProfiles limit.

Patch fields on a custom niche profile. Default profiles cannot be edited.

Delete a custom profile. Default profiles cannot be deleted.

Choose which profile is the default for new generations.

List every share link you've created, newest first. Includes status, current round, image count, and the public URL.

Fetch full details of a share including round history, client selections, comments, and image URLs.

Bundle images for a brand into a public share link clients can review without logging in. 30-day TTL.

Replace one or more images in a share, archive the current round, reset status to 'pending' for re-review.

Permanently delete a share link.

Run Perplexity sonar research on any URL — extracts business name, location, services, USPs, audience, hooks.

Fetch a website, extract colors / fonts / logo / favicon / industry / voice / aesthetic. Does not auto-create the brand.

Just the 'creative directions' phase — returns 10 short {title, description} pairs to feed into generate_concepts_from_research.

Full pipeline: research a URL with Perplexity, then generate ad concepts with image prompts, headlines, body copy, hashtags.

Skip the research step — pass research text directly. Useful when you've already called research_url or have your own context.

List images saved to the media library, most recent first. Default filter is bookmarked only.

List the user's most recent generation runs (last 50 by default), most recent first.

Fetch full details of a single generation — all concepts, image prompts, research, raw output.

Show recent edit history (last 50, last 7 days). Each entry has the label + original + edited image URLs.

Return the authenticated Claivra user's plan, monthly usage, remaining credits, and add-on credit balance.