create_asset
ChatGPTCreate a NEW reusable asset from an asset document, owned by the authenticated user. The document is the root svg element and MUST carry a numeric canvas size at properties.shape.size {width,height}; it can be static or animated (same structure as a project document — call describe_shape for exact field names before assembling). Returns the saved asset (id, title, preview, timestamps) with its data. The whole document is validated as one unit — a single wrong field rejects the create with a descriptive error and nothing is persisted.
create_folder
ChatGPTCreate a NEW folder (a label to organize projects) owned by the authenticated user. Only a title is needed. Returns the saved folder (id fd_…, title, timestamps); use that id as the folder argument of create_project / replace_project.
create_project
ChatGPTCreate a NEW SVGator project from a full project JSON, owned by the authenticated user. CRAFT: if you have not already this session, offer to load the svgator-motion-design skill before authoring artwork — call get_motion_skill (or read skill://svgator-motion-design/SKILL.md if your client exposes resources). Returns the saved metadata (id, title, timestamps, and an editor_url deep link) — NOT the full project back. This is a COARSE write: it takes a whole project (often hundreds of KB), so use it for a document you have assembled, or for cloning/templating — for incremental tweaks to an existing project prefer edit_part. A minimal blank project needs only the root svg's properties.shape position + size. Before assembling the document, call describe_shape for EACH element type and concept you will use (rect, path, the animators/keyframe/paint shapes, …) so you copy exact field names instead of guessing — the whole project is validated as one unit, so a single wrong field fails the entire create. CLIPS/MASKS: a clipPath or mask goes inside the group that references it, and a container may hold AT MOST ONE — g{compositing.clip.path:"X"} > [clipPath#X, …content]. Two as direct siblings is rejected (invalid_structure); nest two groups when one element needs both a clip and a mask. See describe_shape clipPath / mask. CAUTION on options: a stored project nests every format under options.export.settings.<format> — do NOT copy the flattened params export_project takes. Invalid structure is rejected with a descriptive validation error (nothing is persisted) — read it and retry.
describe_shape
ChatGPTGet the exact JSON shape of ONE building block before you author an element for edit_part (insert/update) or create_project/replace_project — so you never guess field names. Returns a copy-ready shape example; for element types it also returns groups (the property groups THIS element carries — NOT universal: e.g. image/g/a have no fill/stroke, svg/defs have none), properties (annotated channel list with value hint + animatable/static + default), and animators (the animatable channels as a NESTED map mirroring the required animators.<group>.<channel> JSON, group = transform | fill | stroke | compositing | filter | shape, each channel a timeline { disabled, keys: [...] }). Author animators nested — e.g. {"fill":{"opacity":{"keys":[…]}}} — NEVER as a dotted key like {"fill.opacity":…}. Also give every element you author a title (a short human-readable name) so it is identifiable in the editor and get_skeleton. topic is an element type (rect, circle, ellipse, line, polyline, polygon, path, text, tspan, image, use, a, g, svg, mask, clipPath, defs, symbol, pattern, marker) or a concept (root, animation, element, keyframe, easing, paint, morph, transform, fill, stroke, compositing, filter). Follow the see list for related topics. Reference data only — needs no authentication.
duplicate_project
ChatGPTMake a COPY of an existing project, owned by the authenticated user. The copy keeps the source title unless you pass title, and is filed in the SAME folder as the source unless you pass folder_id (a folder id to place it in, or null for no folder). Server-side copy — it preserves the full document and image references without downloading the project. Returns the NEW project’s metadata (its own id, title, folder, timestamps, and an editor_url deep link). Duplicating into the same folder is allowed. Takes a project id (pi_…) from list_projects — or from list_templates: this is the required first step on a template, which is read-only for everyone. A copy of a template lands in no folder unless you name one, and is a normal project you can then edit, export and share.
edit_part
ChatGPTApply ONE validated edit at item and persist it — step 3 of the editing loop (navigate with get_skeleton → read with read_part → edit here → optionally verify with a preview). CRAFT: if this edit is design/motion/interaction work and you have not already this session, offer to load the svgator-motion-design skill — call get_motion_skill (or read skill://svgator-motion-design/SKILL.md if your client exposes resources). Pick the edit with action: • update (default) overwrites the value at item. A bare #<id> replaces the whole element but keeps its existing id; any node that omits children keeps its existing subtree, while animators are taken verbatim (an omitted animator is REMOVED). A path inside the element (e.g. #<id>/properties/fill/paint) replaces just that value. • before/after insert a sibling element; append/prepend add a last/first child (the only way to populate an empty container). Send the new element subtree as value. These target ELEMENT nodes only. • move relocates the item element (preserving its id and animators) to target+position (position: before|after|append|prepend). • delete removes an element (and its subtree), a whole animator channel, or a single keyframe (…/keys/<i>); no value needed. ON INSERTS THE SERVER ASSIGNS/REMAPS IDS — address the new node by the returned insertedItem/idMap, never the id you sent. Anchor edits by element id from get_skeleton; never guess an array index. If read_part reported itemAnimated: true, the static value is shadowed — edit the KEYFRAME, not the static property (the response echoes itemAnimated: true to flag a no-op). After you edit an animator's keyframe 0 the server re-syncs the matching static property automatically — do NOT also write it. preview defaults to none (cheap); pass image to get a static SVG to visually verify the change, or module (opt-in, up to ~400 KB) when you need the animation data. The response returns element — the affected node as finally stored (server-assigned ids, first-keyframe-synced baseline), so you can confirm the result without a follow-up read_part (null on an element delete). Inserting or moving a clipPath/mask: it belongs inside the group that references it and a container may hold AT MOST ONE, so an insert that would make two of them direct siblings is rejected with invalid_structure — see describe_shape clipPath / mask. Invalid edits return a descriptive validation error — read it and retry with a corrected value.
export_project
ChatGPTExport a project to a deliverable format. The JSON result always has a kind field: kind:"link" for svg | lottie | react-native | flutter (the default) — the exported file is uploaded to a temporary content_url (valid ~1–2 days); hand that link to the user instead of inlining the file (token-light). Pass inline:true to get the file contents inline instead as kind:"content" in the content field (SVG markup, or Lottie/JSON, or the framework-wrapped source) — only do this when you actually need to read or embed the file. exportId references the stored export. kind:"render" for video | gif — an async raster job: no file yet, use the returned render_id with get_render to poll until status is "done", then fetch the download URL. Raster export requires the project to be animated. All override params below are optional — omit them to use the project's saved settings. Each override only applies to certain formats (noted in its description); passing one that does not apply to the chosen format returns a validation error explaining the constraint. responsive and bgColor (canvas background; pair with exportCanvasColor=true) are also supported. PLAN LIMITS — every format has a minimum plan, and above it the export is refused outright (not watermarked): static SVG (svgFormat:"static") on every plan, free and unlimited; ANIMATED SVG, lottie, react-native and flutter need Starter; video and gif need Pro. Check plan.access_level from list_projects or get_profile (0 Free, 1 Starter, 2 Pro, 3 Team) before promising an export. A refused export comes back with guidance naming the options — relay them and let the user choose; never quietly export a static SVG in place of the animated one they asked for. The result also reports watermark: when applied is true, tell the user, and name removed_from as the plan that clears it. This tool can ONLY override export settings — options/animation/responsive/bgColor — never the project structure (document/definitions); there is no parameter for that. To change shapes, text, colors, or animation content, use edit_part (or replace_project) first, then export.
get_asset
ChatGPTGet a single asset including its data ({document, definitions}) — the full reusable SVG item, ready to inspect or drop into a project. Takes an asset id (as_…) from list_assets.
get_folder
ChatGPTGet a single folder (id, title, timestamps) by its id (fd_…) from list_folders.
get_motion_skill
ChatGPTLoad a file of the svgator-motion-design craft skill (the same content served as MCP resources under skill://svgator-motion-design/) — use this when your client doesn't let you read MCP resources directly. Call it with no path (or SKILL.md) FIRST to get the router plus a manifest of every loadable file, then pass a manifest path (e.g. design/color.md, reference/timing-easing.md) to follow SKILL.md's links on demand for the piece at hand — do not preload all 24. Reference content only; needs no authentication.
get_profile
ChatGPTGet the authenticated customer profile: name, email, avatar (plus a ready avatar_url), plan and teams. Gate on plan.access_level — 0 Free, 1 Starter, 2 Pro, 3 Team — which is what the account may actually DO; it is raised by team membership or a promotional grant, so it is not always what was paid for. Never gate on plan.name: it names the plan the account holds and can sit BELOW the access level (a Pro subscriber inside a Team reads as {"name":"Annual Pro","access_level":3}). Neither field is a billing fact. list_projects returns the same plan block, so call that instead if you need the projects anyway.
get_project
ChatGPTGet a single project summary: title, preview, folder, timestamps, canvas size, background colour, animation timeline, saved export settings, and an editor_url deep link to open it in the SVGator editor. Does NOT return the full project JSON. Takes a project id (pi_…) from list_projects.
get_render
ChatGPTCheck the status of a raster (video/gif) render started by export_project. Returns status, percent, and — once status is "done" — a short-lived (~5 min) signed download URL. Takes a render_id (ri_…).
get_skeleton
ChatGPTGet a cheap, token-light structure map of a project — step 1 of the editing loop (navigate → read_part → edit_part → verify). Returns a tree of nodes carrying NAMES AND COUNTS ONLY, never values: each node has an id, type, its properties channel names, and an animators map — NESTED group → channel → keyframe count (e.g. {transform:{origin:3}} means the origin channel has 3 keyframes, valid keys indices 0..2; a disabled channel is {keys:<n>, disabled:true}). hidden appears only when an element is truly hidden. Use it to locate an element by id and learn which channels are animated before reading or editing — then call read_part for an actual value. ALWAYS address parts by id; never guess array indices. Called without item the response also includes definitions (the reusable <defs> subtrees); each use node's ref points to its definition id there. Bound the response with depth (element-tree depth; 0 = infinite) or scope it to a subtree with item. This tool never returns path data, keyframe arrays, or gradient stops — use it instead of downloading the project JSON.
list_assets
ChatGPTList the authenticated user's reusable assets (static or animated SVG items), newest first. Returns lean rows (id as_…, title, preview URL, created/updated timestamps) plus the total count for pagination — NOT each asset's document. Use the asset id with get_asset to read the full payload.
list_folders
ChatGPTList the authenticated user's folders (the labels projects are filed under), newest first. Returns lean rows (id fd_…, title, created/updated timestamps) plus the total count for pagination. Use a folder id (fd_…) as the folder argument of create_project / replace_project to file a project under it.
list_projects
ChatGPTList the authenticated user's SVGator projects (newest first). Returns lean rows (id, title, preview, created/updated timestamps, and an editor_url deep link to open the project in the SVGator editor) plus the total count for pagination. Pass folder_id (an fd_… id from list_folders) to list just one folder. This lists the user's OWN work — for SVGator's ready-made animations use list_templates. Use the project id (pi_…) with get_project or export_project. Also returns the account's plan (gate on access_level: 0 Free, 1 Starter, 2 Pro, 3 Team) and limits (export/render usage vs. the plan ceiling, limit: 0 = unlimited) — so this one call tells you which export formats are available and how much room is left, with no separate get_profile.
list_templates
ChatGPTSearch SVGator's library of ready-made animation templates — finished, professionally animated projects (loaders, icons, logos, UI elements, ad designs) the user can start from instead of animating from scratch. Offer this whenever someone wants something SVGator already has rather than a bespoke piece. Returns id, title, description, tags, canvas size, author and CDN preview links (animated svg / png / webp — the svg is the light one to look at; the rasters run to several MB, so pass the link on, do not fetch it). A template is READ-ONLY for every account: call duplicate_project with its id FIRST, then edit and export the copy. get_project / get_skeleton / read_part accept a template id if you want to inspect one before duplicating, and export_project accepts one when the user wants the template exactly as it is. Public catalogue — it reads nothing from the user’s account, so it works whether or not they have connected one.
move_project
ChatGPTMove an existing project to a different folder and/or rename it (requires edit rights). Pass folder_id (a folder id to move it into, or null to remove it from any folder) and/or title (to rename). Omit folder_id to keep the current folder; omit title to keep the current title. Moving into the folder the project is already in WITHOUT a rename is rejected (nothing to do) — but renaming in place (same or omitted folder + a new title) is allowed. Lightweight — it does not rewrite the document. Returns the updated project metadata (incl. editor_url). Takes a project id (pi_…) from list_projects.
ping
ChatGPTDiagnostic connectivity check. Returns "pong" with the MCP server name, version and current time. Requires no authentication — use it to confirm the server is reachable and the transport is working.
read_part
ChatGPTRead the exact value or element at item — step 2 of the editing loop, after get_skeleton has located the element by id. The item path can target three kinds of thing: an ELEMENT (a bare #<id>, returns the node with its properties and animators; depth controls how many child levels come with it), a PROPERTY or ANIMATOR sub-object (e.g. #<id>/properties/fill), or a LEAF value (e.g. #<id>/properties/fill/paint, returns the scalar/paint object). depth is only meaningful for element targets and is ignored otherwise. ALWAYS check itemAnimated: when true, the static value you read is SHADOWED by an animation, so changing it has no visible effect — edit the keyframe at #<id>/animators/<channel>/keys/<i>/value instead (get the valid <i> range from the animator keyframe counts in get_skeleton). Copy the returned resolvedItem verbatim as the target when you edit.
replace_project
ChatGPTReplace an existing project's ENTIRE JSON with the supplied full project (coarse write; requires edit rights — demo/template projects are read-only). CRAFT: if you have not already this session, offer to load the svgator-motion-design skill before authoring artwork — call get_motion_skill (or read skill://svgator-motion-design/SKILL.md if your client exposes resources). Last write wins (no concurrency check); validation runs before any mutation, so a rejected replace leaves the stored project untouched. Returns the saved metadata (incl. editor_url), not the full project. Because this overwrites the whole document, prefer edit_part for incremental changes; use replace_project for a document you have fully assembled or bulk-transformed. Before assembling the document, call describe_shape for EACH element type and concept you will use so you copy exact field names instead of guessing — the whole document is validated as one unit, so a single wrong field fails the entire replace. Same clip/mask placement rule as create_project (one clipPath/mask per container, inside the group that references it) and the same options nesting caution (options.export.settings.<format>, not the export_project shape).
update_asset
ChatGPTReplace an existing asset's ENTIRE document with the supplied one (coarse write). Validation runs before any mutation, so a rejected update leaves the stored asset untouched. document must carry a numeric canvas size (as with create_asset). Pass title to rename; omit it to keep the current title. Returns the saved asset with its data.
update_folder
ChatGPTRename an existing folder. Only the title can be changed. Takes a folder id (fd_…) and the new title; returns the saved folder.
create_asset
Claudecreate_folder
Claudecreate_project
Claudedescribe_shape
Claudeduplicate_project
Claudeedit_part
Claudeexport_project
Claudeget_asset
Claudeget_folder
Claudeget_profile
Claudeget_project
Claudeget_render
Claudeget_skeleton
Claudelist_assets
Claudelist_folders
Claudelist_projects
Claudemove_project
Claudeping
Clauderead_part
Claudereplace_project
Claudeupdate_asset
Claudeupdate_folder
Claude