genart agent
MCP server and agent configuration
Start the MCP (Model Context Protocol) server in various modes or configure it for use with AI agent clients. The agent server exposes genart tools for creating, editing, and rendering sketches.
Usage
genart agent <subcommand> [options]Subcommands
stdio
Start the MCP server using stdio transport. Used when the agent client launches the process directly.
genart agent stdio [options]| Flag | Type | Default | Description |
|---|---|---|---|
--base-path | path | Base directory for sketch file operations |
http
Start the MCP server as an HTTP endpoint. Used for remote or browser-based agent connections.
genart agent http [options]| Flag | Type | Default | Description |
|---|---|---|---|
--port | number | 3333 | Port to listen on |
--host | string | 127.0.0.1 | Host to bind to |
--base-path | path | Base directory for sketch file operations | |
--cors | boolean | Enable CORS headers |
sidecar
Start the MCP server as a sidecar process, communicating over stdio with managed lifecycle.
genart agent sidecar [options]| Flag | Type | Default | Description |
|---|---|---|---|
--base-path | path | Base directory for sketch file operations |
install
Install the MCP server configuration into an agent client.
genart agent install [client] [options]| Argument | Required | Description |
|---|---|---|
[client] | No | Target client (e.g. claude, vscode, cursor) |
| Flag | Type | Default | Description |
|---|---|---|---|
--all | boolean | Install for all detected clients | |
--remove | boolean | Remove the configuration instead of installing | |
--dry-run | boolean | Show what would be written without making changes | |
--npx | boolean | Configure using npx instead of a global install |
doctor
Check the MCP server configuration and diagnose common issues.
genart agent doctorExamples
Start the MCP server over stdio:
genart agent stdio --base-path ~/sketchesStart an HTTP server on a custom port:
genart agent http --port 8080 --corsInstall configuration for Claude Code:
genart agent install claudeInstall for all detected clients using npx:
genart agent install --all --npxPreview installation changes:
genart agent install claude --dry-runRemove installed configuration:
genart agent install claude --removeCheck configuration health:
genart agent doctor