MCP Tools

The genart.dev MCP server exposes 298 tools for creating, manipulating, and exporting generative art sketches. These tools are available through any MCP-compatible client — Claude Desktop, Claude Code, or the Claude API.

Spec Format

Each tool spec defines:

1. Purpose — one sentence
2. Input Schema — parameters with types and constraints
3. Output Shape — what the tool returns on success
4. Side Effects — file writes, state mutations, renderer actions
5. Error Cases — what can go wrong and the error message
6. Golden Path Example — one complete request and response

Tool Index

Workspace Management

• create_workspace
• open_workspace
• add_sketch_to_workspace
• remove_sketch_from_workspace
• list_workspace_sketches

Sketch Lifecycle

• create_sketch
• open_sketch
• update_sketch
• update_algorithm
• save_sketch
• fork_sketch
• delete_sketch

Spatial Arrangement

• arrange_sketches
• auto_arrange
• group_sketches

Selection & Context

• get_selection
• select_sketch
• get_editor_state

Parameters

• set_parameters
• set_colors
• set_seed
• set_canvas_size
• randomize_parameters

Gallery

• list_sketches
• search_sketches

Capture & Layout

• capture_screenshot
• capture_batch
• snapshot_layout

Export

• export_sketch

Merging

• merge_sketches

Design Knowledge

• list_skills
• load_skill
• get_guidelines

Design Layers

• design_add_layer
• design_get_layer
• design_list_layers
• design_update_layer
• design_duplicate_layer
• design_remove_layer
• design_reorder_layers
• design_lock_layer
• design_toggle_visibility
• design_set_blend
• design_set_transform
• design_capture_composite

Artist & Critique

• critique_sketch
• compare_sketches
• suggest_skills
• develop_concept
• create_series
• series_summary
• promote_sketch
• add_reference
• analyze_reference
• update_reference_analysis
• extract_palette

Components

• list_components
• add_component
• remove_component

Plugin Tools

Each of the 26 design plugins contributes additional MCP tools (203 total). Individual tool pages are organized by plugin category below:

• Animation — 8 tools (timelines, keyframes, export)
• Architecture — 6 tools (buildings, styles, construction states)
• Atmosphere — 7 tools (clouds, fog, haze, mist, lighting)
• Color Adjustment — 5 tools (curves, HSL, levels, duotone)
• Compositing — 6 tools (gradients, groups, masks, images)
• Construction — 8 tools (forms, envelopes, cross-contours)
• Distribution — 8 tools (points, packing, tiling)
• Figure — 8 tools (mannequin, gesture, landmarks, head)
• Filters — 5 tools (blur, grain, vignette, aberration)
• Identity — 10 tools (lockups, swatches, contrast, scoring)
• Layout Composition — 4 tools (guides, focal points, flow)
• Layout Guides — 4 tools (guides, custom guides, toggle)
• Painting — 15 tools (media, brushes, fills, fields, bristle)
• Particles — 8 tools (particles, presets, motion, depth)
• Patterns — 7 tools (patterns, presets, regions, shading)
• Perspective — 4 tools (grids, floors, vanishing points)
• Plants — 12 tools (plants, gardens, grammars, growth)
• Poses — 8 tools (skeletons, keypoints, analysis, practice)
• Shapes — 6 tools (shapes, lines, paths, polygons)
• Styles — 8 tools (styles, recipes, palettes, timelines)
• Symbols — 7 tools (icons, search, placement, SVG)
• Terrain — 21 tools (landscapes, terrain, water, sky, buildings)
• Textures — 4 tools (canvas, noise, paper, washi)
• Trace — 7 tools (contours, edges, lines, regions, shapes)
• Typography — 9 tools (text, fonts, shadows, paths)
• Water — 8 tools (surface, reflection, foam, caustics, ice)

Resources

See MCP Resources for the full list of read-only data endpoints.

Prompts

See MCP Prompts for the full list of structured prompt templates, including: