Add a component dependency to an existing sketch. Resolves the component and any transitive dependencies from the registry, validates renderer compatibility, and writes the resolved form to the sketch file.

Import an image as a reference for inspiration. Copies the image to the workspace references/ directory and attaches it to a series or sketch.

Add an existing .genart sketch file to the active workspace

Return a structured analysis framework for a reference image, with the image for visual inspection. The agent fills in the analysis using the framework prompts.

Move specific sketches to explicit positions on the canvas

Automatically lay out all or selected sketches using a configurable layout algorithm

Capture screenshots of multiple sketches in parallel. Returns inline JPEG images + per-sketch metadata. In local mode, writes full-res PNGs to snapshots/.

Capture a screenshot of a sketch. Returns an inline JPEG image + metadata as text. In local mode, also writes a full-res PNG to snapshots/--preview.png (path in savedPreviewTo). When a previewUrl is present in the metadata, the full-res image is available at that URL for sharing (30-min TTL). In MCP Apps-capable clients, the captured image renders inline in the conversation.

IMPORTANT TIMING: The capture waits only 500ms after page load. For animated p5 sketches that accumulate particles/lines over many frames, the screenshot may appear mostly empty. This is NORMAL — it does NOT mean the algorithm is broken. To verify animated sketches, use preview_sketch to open in the browser instead. Only use capture_screenshot for single-frame renderers (canvas2d) or after confirming the sketch works in the browser preview.

Side-by-side capture of 2-4 sketches with a structured comparison framework across specified aspects.

Create a new curated series of sketches with narrative, intent, and studio workflow stages

Create a new .genart sketch file from metadata, parameters, and algorithm. Saves to disk, auto-creates an in-memory workspace, and opens an interactive browser preview with sliders/pickers/seed controls. Save sketches to ~/.genart/sketches/.genart (directory auto-created). Do NOT present the .genart file to the user — it has no OS file association. IMPORTANT: Do not embed common utilities (PRNG, noise, easing, color math, vector ops) inline in the algorithm. Instead, declare them as components: { "prng": "^1.0.0", "noise-2d": "^1.0.0" }. Then use the exported functions directly in your algorithm (e.g., mulberry32, fbm2D). Use list_components to see all available components for the current renderer.

Create a new .genart-workspace file with optional initial sketches

Capture a sketch screenshot and return a structured self-critique framework (questions, principles, pitfalls) per aspect. Severity calibrates to compositionLevel.

Delete a sketch file from disk and remove it from the workspace

Add an atmospheric perspective post-process layer. Applies depth-aware value compression, saturation reduction, and color temperature shift. Place near the top of the layer stack. Presets: hazy, clear, golden-hour, overcast.

Add a boat or ship silhouette layer on water. Renders sailboats, rowboats, fishing boats, or cargo ships. Presets: sailboat, rowboat, fishing-boat, cargo-ship.

Add a bridge silhouette layer spanning between terrain elements. Supports arch, suspension, footbridge, and flat crossing styles. Presets: stone-arch, wooden-footbridge, suspension-bridge, flat-crossing.

Add a bristle-dab layer — impressionist short dabs grid-placed over a vector field. Creates stippled, hatched, and painterly impasto effects.

Add a bristle-stroke layer — oil-paint long strokes following a vector field. Creates expressive brushed paint and impasto effects.

Add a simple architectural silhouette layer. Renders farmhouses, churches, towers, or village clusters as filled shapes. Buildings are intentionally simple — silhouette impressions, not detailed architecture. Presets: farmhouse, church-steeple, tower-ruin, village-cluster, temple, lighthouse.

Add a woven canvas/linen texture layer.

Add a celestial body layer (sun, moon, or star) with glow and optional light path on water. Renders a radial gradient glow, a body disk, and an optional vertical shimmer band below. Presets: noon-sun, golden-hour-sun, harvest-moon, crescent-moon, blood-moon, polar-star.

Add a vertical cliff face/rock wall layer. Renders a textured cliff silhouette with ledge shadows. Supports 4 texture modes (sandstone, granite, basalt, limestone). Presets: granite-cliff, sandstone-wall, basalt-columns, limestone-face, shale-cliff.

Add a cloud layer to the sketch. Choose from presets: fair-weather, overcast, wispy-high, storm-clouds, scattered. Renders noise-driven cloud formations via ImageData buffer.

Add a composition guide layer. Types: golden-spiral, golden-triangle, armature, rabatment, safe-margins, flow-path, musical-ratios, dynamic-symmetry, phi-grid, diagonal-grid.

Add a concrete/stone surface texture with coarse aggregate, pitting, and mineral flecks.

Add a 3D construction form guide layer. Form types: box, cylinder, sphere, cone, wedge, egg.

Add multiple 3D construction forms arranged as a scene.

Add cross-contour lines over an outline + axis path, revealing surface direction on any organic shape.

Add a custom horizontal or vertical guide line at a specific position.

Add a drop shadow effect layer.

Add a straight-line envelope block-in with angle and measurement annotations.

Add a fence or wall silhouette layer. Renders picket fences, stone walls, ranch rails, or wire fences as foreground elements. Presets: white-picket, stone-wall, ranch-rail, wire-fence.

Add a vegetation field layer with depth-receding marks. Renders grass, wheat, or wildflower marks that diminish in size toward the horizon. Supports wind direction and seasonal tinting. Presets: meadow-grass, wheat-field, wildflower-meadow, lavender-rows, dry-savanna, rice-paddy, autumn-stubble, snow-covered.

Add anatomical landmark annotations. Provide keypoints directly or reference a mannequin layer.

Add a figure mannequin layer. Methods: stick, bean, blocks, loomis, anatomy. Optional preset pose: standing, seated, t-pose, walking.

Add a flow-lines layer — thousands of streamlines traced through a vector field. Creates engraving, topographic, and Schwere See-style effects.

Add a fog layer to the design. Ground-level fog with terrain masking support. Types: radiation (calm morning), advection (sea fog), upslope (mountain), valley. Presets: morning-valley-fog, sea-fog, mountain-fog, dense-fog, patchy-fog. v0.2.0: fogLayers (1-5) for depth stacking, wispDensity (0-1) for edge tendrils.

Add an occluding fog layer for depth separation (shan-shui 'three distances' effect). Fog layers cover elements behind them, unlike mist particles which are additive. Renders a noise-modulated horizontal band with soft edges and wisps. Presets: morning-mist, mountain-veil, valley-fog, shan-shui-cloud-band, coastal-haar.

Add intersection lines between two or more overlapping 3D forms.

Add a gesture line (line of action + optional Reilly rhythm curves). Points are normalized 0–1.

Add a gradient fill layer (linear, radial, angular, or diamond).

Add a layout guide layer. Available types: grid, thirds, golden-ratio, diagonal.

Add a subtle atmospheric haze layer. Lighter and more additive than fog-layer — haze softens distant elements without fully obscuring them. Supports directional gradients and noise modulation. Presets: light-haze, golden-haze, cool-mist, heat-haze.

Add a head construction overlay (Loomis ball+plane method with tilt/rotation controls).

Add an inner glow effect layer.

Add a new design layer of a given type to the active sketch. Layer types come from registered plugins (e.g. 'typography:text', 'filter:grain', 'shapes:rect', 'guides:thirds').

Painting layers with algorithm stroke paths: Type 'painting:stroke' can render algorithm-published paths when properties include:

• pathSource: 'algorithm:' — binds to a path channel (e.g. 'algorithm:strokePaths')

• pathBrushId: brush preset ('flat', 'round-hard', 'round-soft', 'pencil', 'ink-pen', 'splatter')

• pathColor: hex color for strokes (e.g. '#5a4a2a')

• depthMapping: JSON string mapping path depth to brush params, e.g. '{"maxDepth":5,"width":[60,4],"pressure":[1.0,0.15],"paintLoad":[0.9,0.3],"opacity":[1.0,0.6]}' Values interpolate linearly from depth=0 to maxDepth. Paths beyond maxDepth clamp. Multiple layers can read the same or different channels for multi-pass rendering (shadow, base, highlight, leaves).

Add a line layer from (x1, y1) to (x2, y2).

Add a fine linen/fabric weave texture layer with regular thread structure.

Add a mark-field layer — fills regions with short directional marks following a vector field. Creates hatching/cross-hatching effects that follow flow direction.

Add a mist layer to the design. Mid-level haze bands with parallax stacking. Multiple semi-transparent noise layers create depth separation between terrain ridges. Presets: morning-mist, mountain-haze, thick-mist, layered-mist. v0.2.0: skyColor + colorShift for atmospheric color tint on back layers.

Add a procedural noise texture layer (value, fractal, or ridged).

Add a watercolor paper texture layer (cold-press, rough, smooth, hot-press). Place at the bottom of the stack under painting layers.

Add an aged parchment/vellum texture with foxing spots, staining, and edge darkening.

Add a particle layer by preset name. Auto-resolves to the correct layer type (falling, floating, scatter, mist, trailing, flow, mark-field) from the preset category. 46 presets available across all categories.

Add a custom path shape layer using SVG path data (M, L, C, Q, Z commands).

Add a pattern layer to the sketch. Specify a layer type and either a preset name or manual properties. Layer types: patterns:fill, patterns:stripe, patterns:dot, patterns:checker, patterns:wave, patterns:crosshatch-geo, patterns:herringbone, patterns:tile, patterns:custom.

Add a perspective floor plane (shape layer, included in exports).

Add a perspective grid guide layer. Types: one-point, two-point, three-point, isometric.

Add a plant layer to the sketch. Choose from 110 botanical presets across 9 categories. Use list_plant_presets or search_plants to discover available presets. Each preset encodes species-accurate branching angles, contraction ratios, and growth patterns from botanical references.

Add a pose skeleton overlay. Use a preset ID, category name for a random pose from that category, or custom keypoints.

Add a proportion grid with head-height divisions and anatomical landmark labels.

Add a water surface reflection layer. Renders a simplified mirror of sky/terrain colors below the waterline with darkening and ripple distortion. Not an actual scene mirror — uses solid color bands that simulate reflected sky and terrain tones. Presets: calm-lake, rippled-reflection, dark-water, golden-reflection.

Add a perspective river/stream layer. The river flows from background toward foreground with width narrowing toward the horizon. Choose a preset or customize path shape, bank style, and ripple intensity. Presets: gentle-stream, wide-river, mountain-creek, lazy-oxbow, forest-brook, delta-channels, waterfall-stream, tidal-estuary.

Add a natural rock form layer. Renders a depth-aware rock with silhouette, shadow, and texture. Supports 4 rock types (boulder, outcrop, pinnacle, shelf) and 4 texture modes (speckled, striated, cun-fa for Chinese ink style, cracked). Presets: granite-boulder, sandstone-outcrop, shan-shui-rock, mossy-rock, slate-shelf, volcanic-basalt.

Add a shape layer (rect, ellipse, polygon, star, or arc) to the canvas.

Add a shore/coastline transition layer between water and land. Renders the strip where water meets ground with foam lines, debris, and wet/dry gradients. Position it at the same waterline as your water layer. Presets: sandy-beach, rocky-shore, muddy-riverbank, grassy-bank, tidal-flat, cliff-base.

Add a sky gradient layer to the sketch. Choose a time-of-day preset (dawn, noon, golden-hour, dusk, night) or set custom zenith/horizon/haze colors. Sky layers should be at the bottom of the layer stack.

Add a snow-covered ground layer with drift patterns, shadow tinting, and sparkle highlights. Presets: fresh-powder, wind-swept, sun-crust, deep-snow.

Add a solid color fill layer to the canvas.

Add a star field layer for night sky scenes. Renders magnitude-based stars with optional Milky Way band and constellation hint lines. Stars vary in size, brightness, and color temperature. Presets: clear-night, dense-starfield, milky-way, sparse-stars, twilight-stars.

Add a symbol from the registry to a sketch. Resolves the symbol's SVG path data and caches it in the sketch file. Automatically adds the symbol-draw component if not already present.

Add terrain ridgeline silhouettes to the sketch. Choose from presets: alpine-range, rolling-hills, mesa-plateau, coastal-cliffs, sand-dunes, foothills. Renders back-to-front layered noise ridges with depth-aware coloring.

Add a treeline silhouette band layer. Renders a dense canopy mass (not individual trees) with an irregular top edge profile. Treelines are visual impressions of forest edges, distinct from plugin-plants which renders individual specimens. Supports deciduous, conifer, palm, and bare winter styles. Presets: deciduous-canopy, conifer-ridge, autumn-treeline, misty-forest, palm-fringe, winter-bare.

Add a light/shadow value study overlay with terminator, cast shadow, and value zones.

Add a Japanese washi (rice paper) texture layer with visible fibers.

Add a water surface layer to the sketch. Choose from presets: still-lake, choppy-sea, mountain-stream, river, pond. Renders gradient fill with wave lines and shimmer highlights.

Create a color balance adjustment layer with shadow/midtone/highlight tinting.

Create or update a curves adjustment layer.

Create or update an HSL adjustment layer.

Create or update a levels adjustment layer.

Advance a plant layer's growth time by a step amount. Useful for creating growth animation frames — call repeatedly with capture_screenshot between each step to produce a time-lapse.

Move to the next pose in a practice session.

Analyze phyllotaxis patterns: compute parastichy numbers (Fibonacci spiral families), divergence angle, and packing efficiency for a preset or custom config.

Analyze a pose skeleton — returns joint angles, proportions, center of gravity, symmetry score.

Analyze kerning quality of a text layer. Reports per-pair spacing, flags problem pairs, and suggests adjustments.

Add study annotations to a pose skeleton (landmarks, angles, distances, action lines).

Add a Gaussian blur filter layer.

Add a chromatic aberration (RGB split) filter layer.

Add a dither filter layer (Floyd-Steinberg, ordered/Bayer, or random).

Add a duotone color mapping filter layer.

Create a gradient map layer that remaps luminance to a color gradient.

Add a film grain filter layer over the canvas.

Add a halftone filter layer (dot, line, or diamond pattern).

Add a posterize filter layer that reduces the number of color levels.

Add an unsharp mask sharpening filter layer.

Apply a style recipe by adding a styles:reference guide layer to the current sketch with palette and guidance.

Apply styling to an existing text layer: font, size, weight (100–900), color, stroke, shadow, letter-spacing, tracking, kerning mode, optical alignment, and render mode.

Add a threshold filter layer that converts to binary black/white (or custom colors).

Add a vignette filter layer that darkens the edges of the canvas.

Automatically normalize the tonal range of the current composite by computing and applying histogram-based levels.

Create a shape blend layer: two shapes interpolated along a spine (color transitions, shape morphing, contour shading, neon glows).

Create brush strokes on a painting:stroke layer. If layerId is provided, appends strokes to that layer; otherwise creates a new painting:stroke layer. Supports all 11 built-in brush presets or inline custom brushes.

Get info about the design layer composite for a sketch. For full visual capture use capture_screenshot.

Check WCAG contrast ratio between two colors. Returns ratio, AA/AAA pass status, and suggestions if failing.

Check all pairwise contrasts in a color palette. Flags pairs below threshold.

Remove all composition guide layers from the layer stack.

Remove all construction:* layers from the layer stack.

Remove distribution:preview or distribution:voronoi guide layers from the document.

Remove all figure:* layers from the layer stack.

Remove all guide layers from the layer stack.

Remove all keyframes from a layer property (or all properties if property omitted).

Remove the mask from a design layer, restoring full unmasked rendering.

Remove all perspective:* layers from the layer stack.

Remove all poses:* layers from the layer stack.

Convert a text layer to SVG path data for font-independent rendering. Returns the path data without modifying the layer.

Create an alpine lake scene: noon sky + alpine range + snow field + calm water + lake reflection + granite cliff + cool mist.

Create a multi-layer atmospheric scene from a named recipe. Recipes: winter-storm (snow + fog + haze), autumn-forest (leaves falling + ground + mist), misty-morning (mist + dust), firefly-night (fireflies + fog), spring-meadow (petals + pollen + wildflowers), dusty-ruins (dust + pebbles + steam).

Add a custom brush definition to a painting:stroke layer's brushes array. The brush can then be referenced by its id in brush_stroke calls.

Create a moonlit coastal scene: night sky + starfield + moon + water + rocky shore + dark reflection.

Create a desert expanse scene: noon sky + mesa plateau + sandstone cliff + dry scrub field + heat haze + wind erosion.

Create an ecosystem scene with multiple plants arranged in depth, atmospheric perspective, and optional ground plane. Plants render back-to-front with depth-based scaling and color shifting. Use arrangement presets (scatter/row/grove/border/terraced) for auto-layout or specify explicit positions.

Create a forest clearing scene: overcast sky + treeline + overhanging branches + fern carpet + ground fog + woodland trail.

Compose a garden by adding multiple plant layers at once. Each plant gets a random position, seed, and optional scale.

Add a construction grid overlay to the canvas for identity mark design.

Create a group layer, optionally moving existing layers into it.

Create a flower cluster composition by combining multiple flower presets in arrangements like bouquets, wreaths, or scattered meadows.

Create a Japanese garden scene: misty sky + calm water + stone bridge + decorative rock + treeline + lake reflection + light haze.

Create a complete landscape scene by adding sky + terrain profile + optional clouds + optional water in correct layer order. Each layer is auto-assigned an appropriate depth lane. Set atmosphericMode to 'western' or 'ink-wash' for automatic atmospheric perspective on terrain ridges. Returns all created layer IDs.

Create an identity lockup layer composing a mark (SVG icon) and wordmark (text). Generates a horizontal lockup by default.

Create a motion path guide layer that animates a target layer along a series of points.

Create a mountain valley scene: sky + alpine ridges + valley fog + treeline + meadow field + haze.

Create a park riverside scene: overcast sky + gentle hills + river + path + treeline + meadow + building.

Create a pastoral countryside scene: golden-hour sky + rolling hills + wheat field + country lane + picket fence + farmhouse + golden haze.

Create a custom repeating pattern from drawing commands. The pattern is stored in the sketch and can be used by a patterns:custom layer via its patternId. Commands: line, circle, rect, arc, path, polygon. Max 200 commands, 10KB limit. Coordinates are in unit-cell space (0 to width/height).

Create a timed pose practice session. Creates both a timer layer and a skeleton layer.

Create a river scene: sky + rolling hills + river + shore + treeline + reflection.

Create a Chinese shan-shui (mountain-water) landscape: misty sky + sharp peaks + mountain mist + rock + calm water + haze.

Create a color swatch layer showing a palette of colors with labels.

Create a custom AI-generated symbol with SVG path data. Validates path syntax and enforces a 10KB size limit. Caches it in the sketch file for use with drawSymbol().

Add an animation timeline to the sketch (sets global duration, fps, and loop).

Create a tropical coast scene: golden-hour sky + calm sea + sandy beach + sailboat + golden reflection + leaf frame vignette + golden haze.

Create a winter woodland scene: overcast sky + gentle hills + deep snow + conifer treeline + pine canopy vignette + morning mist.

Add underwater caustic light patterns. Visible only in clear water (clarity > 0.3). 3 presets: shallow-caustics, deep-pool-caustics, tropical-caustics.

Add a foam and whitecaps layer. Renders whitecap patches on wave crests, foam trails, Langmuir circulation streaks, and bubble rafts. 4 presets: ocean-whitecaps, surf-foam, gentle-foam, storm-foam.

Add a frozen water surface layer with ice texture, cracks, frost patterns, and optional snow cover. 4 presets: frozen-lake, thin-ice, pack-ice, frost-glass.

Add a water reflection layer that mirrors terrain and sky below the waterline. Features Fresnel-based strength (stronger at glancing angles). 4 presets: calm-lake-reflection, rippled-reflection, dark-water-reflection, golden-reflection.

Add a shoreline interaction layer. Renders the water-land transition with foam lines, wave break styles (spilling/plunging/surging), and debris. 7 presets: sandy-beach, rocky-shore, muddy-riverbank, grassy-bank, tidal-flat, cliff-base, marsh-edge.

Add a water surface layer. Supports 3 algorithms: calm (stripe compositing for lakes/ponds), ocean (Gerstner waves for seas), flow (flow-field ripples for rivers/streams). 11 presets: still-lake, pond, misty-lake, moonlit-water, choppy-sea, ocean-swell, stormy-ocean, tropical-shallows, coastal-surf, mountain-stream, river.

Set coordinated water conditions across multiple water layers. Creates a complete water scene with surface + reflection + optional foam/shoreline. Conditions: calm (still-lake + calm-lake-reflection), choppy (choppy-sea + rippled-reflection + ocean-whitecaps), stormy (stormy-ocean + dark-water-reflection + storm-foam), frozen (frozen-lake ice).

Distribute points along a polyline using arc-length parameterization.

Generate a spatial distribution of points using a named algorithm (poisson-disk, phyllotaxis, hex-grid, jittered-grid, and more). Returns the point array and count.

Move the camera forward or backward along its look direction. Positive = toward target, negative = away. Requires an existing camera layer.

Clone a design layer with a new ID, inserted directly above the source

Remove strokes from a painting:stroke layer by index range. Indices are 0-based. If 'end' is omitted, removes only the stroke at 'start'.

Get a human-readable explanation of a plant preset's L-system grammar: axiom, productions, turtle interpretation, and growth behavior.

Export individual frames as PNG/JPEG. Returns frame metadata.

Export the animation as a GIF. Returns metadata about the export.

Export a plant preset as ADR 072 AlgorithmStrokePath[] for consumption by plugin-painting brush layers. Segments become stroke paths with width/depth/pressure, leaves/flowers/polygons become closed filled-region paths with group tags. Returns JSON array of path objects.

Search Iconify for professional icons (275k+ from Phosphor, Lucide, Tabler, MDI, etc.) or embed one into a sketch. Two modes: (1) Search — provide query to get a list of iconifyIds; (2) Embed — provide iconifyId (e.g. 'ph:cat') to fetch SVG, parse paths, and embed as a SketchSymbolDef. Approved prefixes: ph, lucide, tabler, heroicons, bi, mdi, ri, carbon, fluent.

Create a painting:fill layer that procedurally generates marks (hatch, crosshatch, stipple, scumble, or contour) within a bounded region, with optional spatial shading. Use preset names as shorthand: hatch-light, hatch-medium, hatch-dense, crosshatch-light, crosshatch-dense, stipple-light, stipple-dense, scumble, contour.

Generate full, reversed, grayscale, and mono color variants of a lockup layer. Creates 4 separate layers arranged on the canvas.

Generate a random construction exercise with forms at varying difficulty.

Generate a VectorField from agent-specified control points using RBF interpolation. Each control point defines a flow direction and magnitude at a canvas position. Returns the VectorField as a JSON string suitable for use as a painting layer's 'field' property.

Generate mannequin keypoints from a text description (e.g., 'standing with arms raised', 'seated cross-legged'). Uses template matching with pose presets.

Return detailed metrics for a registered font: ascender, descender, xHeight, capHeight, available weights, and kerning pair count.

Get full details of a single design layer including all properties and transform

Return the VectorField JSON for a painting layer, for inspection or editing.

Get full details for a specific style recipe including layers, palette, and agent guidance.

Get full details for a specific art movement, artist, or media type by ID.

Get the color palette(s) for a style movement or specific recipe.

Get a chronological timeline of art movements, optionally filtered by year range.

Run a growth algorithm (DLA, differential-growth, substrate) and return the resulting point set and/or paths.

Step the growth of an L-system plant by changing its iteration count. Use to simulate growth from sapling to mature tree.

Import a base64-encoded image into the sketch and create a composite:image layer.

List all registered construction element types (columns, arches, windows, roofs, etc.).

List all available architectural styles with their character descriptions.

List all image assets embedded in the current sketch.

List available atmosphere presets. Filter by category (fog, mist, clouds, haze) or search by keyword.

List all available blend modes with descriptions and usage guidance.

List all available brush presets and any custom brushes defined on a specific painting:stroke layer.

List all built-in fill presets with their strategy parameters.

List all available filter types and their configurable properties.

List all available fonts (built-in system fonts and registered custom fonts) with their weights, categories, and metrics when available.

List all keyframes on a layer.

List all design layers in the active sketch with their types, visibility, and key properties

List all 46 particle presets, optionally filtered by category (falling, floating, scatter, mist, trailing, flow, mark-field).

List all available pattern presets grouped by category, with descriptions. Use this to discover presets before adding a pattern layer.

List all 110 plant presets, optionally filtered by category, tags, complexity, or engine type.

List available style recipes, optionally filtered by movement/artist/media or tags.

List all available shape types and their properties.

List all symbol categories with symbol counts. Use this to browse the symbol library before searching.

List all 114 terrain presets, optionally filtered by category (sky, profile, clouds, water, river, path, shore, field, rock, treeline, celestial, fog, starfield, cliff-face, snowfield, building, bridge, reflection, haze, fence, boat).

List available threshold presets for image tracing. Each preset configures edge detection, contour extraction, and spline fitting for a specific source material type.

List available water presets, optionally filtered by category (surface, reflection, foam, shoreline, caustics, ice).

Load a custom font from a sketch asset (OTF/TTF/WOFF2). Registers it for use in text layers and MCP tools.

Lock or unlock a design layer to prevent accidental edits

Orbit the camera around a center point by a horizontal and/or vertical angle. Requires an existing camera layer.

Pack non-overlapping circles within a region using trial-and-reject sampling. Returns (x, y, radius) tuples and coverage percentage.

Pack rectangles into a bin using the guillotine algorithm. Returns placements with x, y, width, height, and rotated flag.

Add a painting layer driven by a 2D vector field. Supports watercolor, oil, gouache, ink, pastel, and charcoal media.

Shift the camera left/right and up/down without changing the look direction. Requires an existing camera layer.

Place a symbol as a design layer on the canvas. Creates a symbols:symbol layer with embedded SVG path data for visual composition.

Set the current animation time for preview. Returns the time that was set.

Generate a distribution and add a distribution:preview guide layer to visualize it non-destructively.

Add a random particle layer, optionally constrained by category (falling, floating, scatter, mist, trailing, flow, mark-field).

Add a random plant layer. Optionally constrain by category or engine type.

Generate a random anatomically-plausible pose or pick a random preset.

Remove a specific keyframe from a layer property.

Remove a design layer from the active sketch

Remove a symbol from a sketch. Warns if the algorithm references the symbol ID.

Move a design layer to a new position in the z-order stack

Run quality scoring on the current identity work. Checks contrast, variants, color count, scalability, simplicity, fonts, vector-only, and color independence. Returns structured score report.

Full-text search across plant preset names, scientific names, descriptions, and tags.

Search art movements, artist profiles, and media types by keyword, era, region, or tags.

Search the symbol registry by keyword, category, and/or style. Returns symbols with their IDs, tags, and available styles.

Set sun angle and elevation across all atmosphere:clouds layers in the design for consistent lighting.

Set blend mode and/or opacity on a design layer

Set the blend mode of an existing layer.

Change the architectural style of an existing building layer. Available styles: classical, roman, romanesque, gothic, islamic, chinese, japanese, tudor, renaissance, baroque, georgian, art-nouveau, art-deco, vernacular, modernist, brutalist, high-tech, deconstructivist, parametric, futuristic, sculptural, metabolist, organic, fantasy.

Set the scene camera position, target, and field of view. Creates a perspective:camera layer if none exists. Position and target are in world units (1 unit = 1 meter). +X = right, +Y = up, +Z = into the scene.

Apply a named camera preset. Creates a camera layer if none exists. Presets: landscape (standing eye-height, 60° FOV), aerial (200m altitude, 45° down, 50° FOV), street (eye-height, natural 55° FOV), worm-eye (low position, 75° dramatic FOV), isometric (orthographic, 30° angle).

Set the construction state of a building: 0 = foundation only, 0.25 = structure, 0.5 = complete, 0.75 = aged, 1.0 = ruin. Intermediate values produce partial states.

Set the depth lane on any terrain layer. Depth lanes define named depth slots that all plugins understand: sky, far-background, background, midground, foreground, ground-plane, overlay. Append -1 (back), -2 (mid), or -3 (front) for sub-level control within a lane (e.g. 'background-1'). Optionally set the atmospheric depth mode on terrain:profile layers.

Update joint positions and tilt/twist on an existing mannequin layer.

Add or replace a keyframe on a layer property.

Switch a lockup layer between horizontal, stacked, icon-only, or wordmark-only variants.

Apply a mask to a design layer. The mask source layer clips the target layer. Modifier-path layers (painting:, adjust:, filter:*) cannot be masked.

Configure mist band properties: bandTop, bandBottom, edgeSoftness, density, noiseScale, layerCount.

Configure depth properties on a particle layer: horizonY, depthEasing, depthDistribution, depthBandMin/Max.

Configure motion properties on a particle layer: windAngle, windStrength, fallProgress, driftRange, driftPhase, driftX.

Configure visual style on a particle layer: color, colorVariation, opacity, glow, glowColor, sizeMin, sizeMax.

Set the clip region for a pattern layer. Supports bounds (full layer), rect, ellipse, and polygon regions.

Set value-based shading on a patterns:fill layer. Shading varies opacity/density/weight spatially using uniform, linear, radial, noise, or algorithm-driven functions.

Edit L-system grammar on a plant layer. Change axiom, productions, or iterations to create custom growth patterns.

Set continuous growth time and 3D camera angle on a plant layer. growthTime 0 = seed, 1 = full maturity (smooth interpolation, not discrete steps). elevation/azimuth enable 3D turtle projection for volumetric canopy rendering.

Switch a plant layer's color palette to a seasonal variant. Affects leaf, branch, and flower colors.

Set drawing style and detail level on a plant layer. Styles: precise (clean vectors), ink-sketch (gestural), silhouette (filled outline). Detail levels: minimal, sketch, standard, detailed, botanical-plate.

Configure tropism forces on a plant layer. Positive gravity = upward growth (phototropism), negative = drooping (gravitropism). Wind adds lateral bias.

Configure wind dynamics on a plant layer. Wind bends branches in a direction with optional gusts and spatial turbulence. Works with all plant layer types. Use windTime with capture_screenshot for animation frames.

Update polygon-specific properties (sides, rotation).

Update keypoints on an existing pose skeleton layer.

Set the illustration render mode of a building layer. Modes: filled (classic solid), pencil (graphite sketch), ink (confident lines), technical (precise architectural), engraving (crosshatch), woodcut (bold gouged).

Update fill and stroke styles of an existing shape layer.

Adjust depth properties on a terrain profile layer: ridge count, depth easing, elevation range, and color shift.

Add a text layer or update the text content of an existing text layer. If layerId is provided, updates that layer; otherwise creates a new text layer.

Enable or configure a drop shadow on a text layer.

Update an existing sky layer to a time-of-day preset, changing zenith, horizon, and haze colors.

Set the position, size, rotation, and scale of a design layer

Generate a modular type scale and optionally apply sizes to text layers. Given a base size and ratio, computes a harmonious progression of font sizes.

Update a vanishing point on an existing perspective layer. Coordinates are normalized (0-1 is canvas bounds, values outside are allowed).

Suggest a foreground color that meets WCAG contrast against a given background, preserving target hue.

Return flow path waypoints and suggested element placement for the current canvas.

Return focal point coordinates for the current canvas based on a composition system.

Get ranked drawing style recommendations for a plant preset. Returns the top styles with reasons based on what works well visually for each species/category.

Given a natural language description of desired aesthetic, suggest matching art styles and recipes.

Create a scale test layer showing an SVG at multiple sizes. Returns observations about legibility at each size.

Configure seamless tiling for a patterns:tile layer — set tile shape, size, gap, rotation, and colors.

Tile a region using Wave Function Collapse. Returns a 2D grid of tile IDs.

Toggle visibility of all guide layers.

Show or hide a design layer

Extract simplified contour paths from edges using Ramer-Douglas-Peucker simplification.

Detect edges in the current canvas or a reference image using Canny edge detection. Returns edge map statistics and optionally creates a trace:reference layer.

Detect straight line segments using Hough transform. Runs edge detection first, then finds lines.

Segment the image into color regions using k-means clustering. Returns dominant colors and region masks.

Detect geometric shapes (circles, rectangles, triangles, polygons) from contours.

Fit smooth cubic Bezier splines to traced contours. Produces vector-quality curves from edge data. Supports threshold presets (sketch, photograph, line-art, watercolor, detail) and vectorization quality controls.

Convert image to stipple dots or hatching lines based on value (darkness). Stipple mode places dots of varying size/density; hatching draws parallel lines of varying weight.

Run full image analysis and create multiple trace layers (edges, contours, regions, values). Combines multiple trace types into a layered reference structure.

Generate a value (lightness) map from the image. Useful for tonal studies.

Modify properties on an existing shapes:blend layer.

Modify individual properties on an existing painting:fill layer without replacing everything. Partial strategy updates are merged with the existing strategy.

Update properties on a design layer (e.g. text content, filter intensity, shape fill color). For painting:stroke layers, updatable properties include: pathSource, pathBrushId, pathColor, depthMapping (JSON string).

Replace the vector field on an existing painting layer. Accepts shorthand strings, VectorField JSON, or "algorithm:channelName" to read from the algorithm data bridge.

Update properties of an existing pattern layer by layer ID.

Generate a structured concept development plan with mood, palette, composition, skills, and series structure recommendations

Export a sketch as standalone HTML, PNG, SVG, raw algorithm, or bundled ZIP

Return a reference image for color palette extraction, with guidelines for identifying dominant colors. The agent extracts hex colors visually.

Create a variant of an existing sketch with a new ID and optional modifications

Return a full snapshot of the MCP server's current state

Return design guidelines and best practices for a topic (Phase 5)

Return full context for the currently selected sketch(es) on the canvas

Get full sketch definition for rendering in the preview app

Create or update a named group of sketches in the workspace

List available reusable components from the registry, filtered by renderer and/or category. Components provide common utilities (PRNG, noise, easing, color math, etc.) that can be declared as dependencies instead of inlining code in the algorithm.

List all curated external library presets available for use with create_sketch. Each entry shows the library name, version, compatible renderers, license, and description. Pass a library name in the libraries array of create_sketch to include it.

Scan the workspace directory for all .genart files with metadata summaries

List all available design knowledge skills (Phase 5)

List all sketches in the active workspace with metadata

Load a specific design knowledge skill with full content (Phase 5)

Combine parameters, colors, and algorithm from 2+ source sketches into a new sketch

Open a sketch by ID to view and edit it (sets selection)

Open an existing .genart-workspace file and load all referenced sketches

Open an interactive HTML preview of a sketch in the browser with parameter sliders, color pickers, and seed controls. Call this after update_algorithm to let the user explore changes interactively. Preview already opens automatically on create_sketch — only call this for re-previewing after updates. In MCP Apps-capable clients (Claude Desktop, claude.ai), the preview renders inline in the conversation.

Promote a sketch to the next studio workflow stage — fork, upscale canvas, update compositionLevel, and add to series

Generate random values for all or specific parameters within their defined ranges

Remove a component dependency from a sketch. Checks for dependent components and warns if the algorithm references the component's exports.

Remove a sketch from the active workspace (optionally delete the file)

Persist the current in-memory state of a sketch to disk

Search loaded sketches by title, renderer, parameters, canvas size, or skills

Set the canvas selection to one or more sketches by ID

Capture all sketches in a series with narrative context for holistic evaluation

Change the canvas dimensions of a sketch using a preset or explicit width/height

Update the runtime color palette values of a sketch's current state

Update the runtime parameter values of a sketch's current state

Set the random seed of a sketch, optionally generating a random value

Set the working directory for file operations. All paths are resolved relative to this directory. Supports ~ for home directory. Creates the directory if it doesn't exist.

Return a structural summary of the workspace layout for AI spatial reasoning

Recommend relevant design skills based on sketch context and/or free-text description

Replace the algorithm source code of a sketch. If adding/changing components, pass them in the components field alongside the algorithm. After updating, use preview_sketch to open an interactive preview in the browser.

Algorithm data bridge: Algorithms can publish data for design layers by setting window.__genart_data properties:

• Stroke paths: Set window.__genart_data.strokePaths = [{points:[{x,y},...], depth, width, pressure:[...], group}, ...]

• Multiple channels: Publish separate arrays (e.g. strokePaths for all paths, leafPaths for depth-filtered subset)

• Grid data: Set window.__genart_data.flowField/valueMap/mask as Float32Arrays for spatial algorithms Painting layers bind to these channels via pathSource: 'algorithm:'. Declare channels in the sketch's dataChannels field via update_sketch.

Save a structured analysis (composition, palette, rhythm, mood, technique) back to a reference after studying it with analyze_reference.

Update metadata, parameters, colors, or canvas of an existing sketch