Tools provided
Tools the agent exposes — your AI client calls them automatically when it needs them.
- generate_illustration — Generate professional, editable SVG artwork from a text prompt: illustrations, icons, stickers and mascot scenes. The result is real vector paths with a transparent background, not an embedded bitmap. Returns a task that processes asynchronously, so call wait_for_task with the returned id to get the result. Pass mascot_id (from list_mascots) to keep a consistent character across scenes. Costs 4 credits.write
- generate_logo — Generate a professional vector logo as editable SVG, delivered as a brand kit: the original mark, black and white variants, transparent PNG exports and a color palette measured from the finished artwork. An optional reference can refine an existing identity or provide loose inspiration. Runs asynchronously, so call wait_for_task with the returned id, then download_logo_kit. Costs 8 credits.write
- vectorize_image — Convert a raster image (PNG/JPG/WebP, max 5 MB) into a clean, editable SVG. Provide image_url or image_base64. no_background defaults to true and isolates the subject (4 credits). Set no_background false with mode 'direct' to trace as-is (1 credit); mode 'enhance' redraws with AI first (4 credits). Runs async, so poll with wait_for_task.write
- get_task — Fetch the current status of a task. Status is one of queued, processing, succeeded, failed. A succeeded task includes the result with download URLs.write
- wait_for_task — Block until a task settles (succeeded/failed) or the timeout passes. Preferred over polling get_task in a loop. Generation typically takes 10-60 seconds.write
- list_tasks — List the user's most recent tasks, newest first.write
- list_mascots — List the user's ready-to-use mascots (consistent characters). Pass a mascot id to generate_illustration to place that character in a new scene. Mascots are created in the CleanVector dashboard.write
- download_png — Return the finished artwork as a PNG image (free on all plans). Use after a task succeeded. For larger exports up to 8192px, use the png_url from the task result with the same Bearer key.write
- download_svg — Return the finished artwork as SVG markup. Use after a task succeeded.write
- download_logo_kit — Return a completed logo kit as an embedded ZIP resource. Includes three SVGs, three PNGs and palette.json. MCP output is capped at 2048px; use zip_url from the task result for larger files.write
- get_account — Current plan and credit balance. Costs: vectorize 1, generate/enhance 4, logo 8 credits. PNG and SVG downloads are free on every plan.write
