Skip to main content
Glama

nakkaş significa pintor/artista en turco (antiguo).

"make a neon terminal logo with animated binary digits"
  → AI constructs JSON config
  → nakkas renders to animated SVG
  → clean animated SVG output

Por qué

  • Una herramienta, diseños infinitos. render_svg toma una configuración JSON. La IA completa todo.

  • Esquema nativo para IA. Cada campo tiene anotaciones .describe() para que el modelo sepa qué hacer.

  • SVG declarativo puro. CSS @keyframes + animaciones SMIL, sin JavaScript.

  • Cero dependencias externas. Sin API en la nube, sin claves API. Se ejecuta localmente.

Related MCP server: inkscape_mcp

Instalación

Claude Desktop

Añade a tu archivo de configuración:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "nakkas": {
      "command": "npx",
      "args": ["-y", "nakkas@latest"]
    }
  }
}

Claude Code (CLI)

claude mcp add nakkas npx nakkas@latest

Cursor / Zed / Otros clientes MCP

{
  "mcpServers": {
    "nakkas": {
      "command": "npx",
      "args": ["-y", "nakkas@latest"]
    }
  }
}

Desarrollo local

git clone https://github.com/arikusi/nakkas
cd nakkas
npm install && npm run build
# Use dist/index.js as the command

Inicio rápido

Pide a tu IA (con Nakkas conectado):

"Haz un SVG animado: marco de terminal oscuro (800×200), texto cian brillante 'NAKKAS', filtro de neón, desvanecimiento al cargar."

"Crea un spinner de carga: un círculo con una animación de trazo que se repite cada 1.5 segundos."

"Visualización de datos: gráfico de barras animado, 5 barras, cada una desvaneciéndose con un retraso escalonado, rellenos degradados."

"Insignia de perfil (400×120): degradado de azul a morado, texto de nombre de usuario en blanco, sombra paralela, animación de pulso sutil."

Herramientas

Nakkas proporciona tres herramientas:

Herramienta

Propósito

render_svg

Toma JSON de SVGConfig, devuelve cadena SVG + advertencias de análisis de diseño

preview

Toma contenido renderizado, devuelve una imagen PNG para inspección visual

save

Toma contenido renderizado, guarda en disco como SVG (texto) o PNG (ráster)

El flujo de trabajo previsto: renderizar → previsualizar → iterar → guardar. La herramienta save está separada de render_svg para fomentar la previsualización y el refinamiento antes de guardar.

La herramienta save

{ "content": "<svg ...>...</svg>", "outputPath": "./design.svg", "format": "auto" }

Formatos: auto (deducido de la extensión), svg (archivo de texto), png (renderiza a ráster primero). Si el archivo existe, se añade un contador numérico para evitar sobrescribir. Se devuelve la ruta guardada real.

La herramienta render_svg

Entrada: Objeto JSON SVGConfig Salida: Cadena XML SVG completa más notas opcionales de análisis de diseño

Después de renderizar, la respuesta puede incluir advertencias de diseño sobre problemas comunes como demasiadas animaciones simultáneas, falta de transformBox o transformaciones de escala a nivel de grupo.

Estructura de SVGConfig

{
  canvas: {
    width: number | string,   // e.g. 800 or "100%"
    height: number | string,
    viewBox?: string,          // "0 0 800 400"
    background?: string        // hex "#111111" or "transparent"
  },

  defs?: {
    gradients?: Gradient[],   // linearGradient | radialGradient
    filters?: Filter[],        // preset or raw primitives
    clipPaths?: ClipPath[],
    masks?: Mask[],
    symbols?: Symbol[],
    paths?: { id, d }[]       // for textPath elements
  },

  elements: Element[],         // shapes, text, groups, use instances

  animations?: CSSAnimation[]  // CSS @keyframes definitions
}

Tipos de elementos

Tipo

Campos requeridos

Notas

rect

width, height

x, y por defecto 0; rx/ry para esquinas redondeadas

circle

r

cx, cy por defecto 0

ellipse

rx, ry

Radios horizontal/vertical independientes

line

x1, y1, x2, y2

polyline

points

Ruta abierta: "10,20 50,80 90,20"

polygon

points

Forma cerrada automáticamente

path

d

Comandos de ruta SVG completos

image

href, width, height

URL o URI data:image/... para imágenes incrustadas

text

content

Cadena o matriz (string | Tspan)[]

textPath

pathId, text

Texto siguiendo una curva; ruta definida en defs.paths

group

children

Atributos compartidos aplicados a todos los hijos (sin grupos anidados)

use

href

Instanciar un símbolo o clonar un elemento por #id

radial-group

cx, cy, count, radius, child

Colocar N copias alrededor de un círculo completo

arc-group

cx, cy, radius, count, startAngle, endAngle, child

Colocar N copias a lo largo de un arco circular

grid-group

cols, rows, colSpacing, rowSpacing, child

Colocar copias en una cuadrícula de M por N

scatter-group

width, height, count, seed, child

Dispersar N copias en posiciones aleatorias con semilla

path-group

waypoints, count, child

Distribuir N copias uniformemente a lo largo de una polilínea

parametric

fn

Curva matemática: rose, heart, star, lissajous, spiral, superformula, epitrochoid, hypotrochoid, wave

Todos los elementos visuales (Campos compartidos)

{
  id?: string,             // required for filter/gradient/clip references
  cssClass?: string,       // matches CSS animation names
  fill?: string,           // "#rrggbb" | "none" | "url(#gradId)"
  stroke?: string,
  strokeWidth?: number,
  strokeDasharray?: string, // "10 5", use for draw-on animation
  strokeDashoffset?: number,
  opacity?: number,        // 0–1
  filter?: string,         // "url(#filterId)"
  clipPath?: string,       // "url(#clipId)"
  transform?: string,      // "rotate(45)" "translate(100, 50)"
  transformBox?: "fill-box" | "view-box" | "stroke-box",  // set "fill-box" for CSS rotation
  transformOrigin?: string, // "center", works with fill-box
  smilAnimations?: SMILAnimation[]
}

Ajustes preestablecidos de filtros

Referencia como filter: "url(#myId)" en cualquier elemento después de definirlo en defs.filters:

{ "type": "preset", "id": "myGlow", "preset": "glow", "stdDeviation": 8, "color": "#ff00ff" }

Ajuste

Parámetros clave

Efecto

glow

stdDeviation, color

Halo suave

neon

stdDeviation, color

Brillo intenso

blur

stdDeviation

Desenfoque gaussiano

drop-shadow

stdDeviation, offsetX, offsetY, color

Sombra paralela

glitch

stdDeviation

Desplazamiento de turbulencia (animado)

grayscale

value (0–1)

Desaturar

sepia

Tono sepia cálido

invert

Invertir colores

saturate

value

Aumentar/reducir saturación

hue-rotate

value (grados)

Cambiar tonos

chromatic-aberration

value (desplazamiento px, por defecto 3)

División de canal RGB para efecto de distorsión de lente

noise

value (opacidad 0 a 1, por defecto 0.25)

Grano de película y superposición de textura

outline

color, value (grosor, por defecto 2)

Contorno coloreado alrededor del elemento

inner-shadow

color, stdDeviation, value (opacidad, por defecto 0.5)

Sombra dentro del elemento

emboss

stdDeviation, value (intensidad, por defecto 1.5)

Efecto de sombreado en relieve 3D

Animaciones CSS

{
  "animations": [{
    "name": "pulse",
    "duration": "2s",
    "iterationCount": "infinite",
    "direction": "alternate",
    "keyframes": [
      { "offset": "from", "properties": { "opacity": "0.3", "transform": "scale(0.9)" } },
      { "offset": "to",   "properties": { "opacity": "1",   "transform": "scale(1.1)" } }
    ]
  }],
  "elements": [{
    "type": "circle",
    "cx": 100, "cy": 100, "r": 40,
    "cssClass": "pulse",
    "transformBox": "fill-box",
    "transformOrigin": "center"
  }]
}

Claves de propiedad CSS: camelCase (strokeDashoffset) o kebab-case (stroke-dashoffset). Ambos funcionan.

Propiedades CSS animables: opacity, fill, stroke, transform, filter, clip-path, stroke-dasharray, stroke-dashoffset, font-size, letter-spacing y más.

Animaciones SMIL

Tres tipos de SMIL, definidos en línea en cada elemento mediante smilAnimations: []:

{ "kind": "animate",          "attributeName": "d",       "from": "...", "to": "...", "dur": "2s" }
{ "kind": "animateTransform", "type": "rotate",            "from": "0 100 100", "to": "360 100 100", "dur": "3s" }
{ "kind": "animateMotion",    "path": "M 0 0 C ...",      "dur": "4s", "rotate": "auto" }

Morfología de ruta (attributeName: "d"): las rutas de origen/destino deben tener tipos y recuentos de comandos idénticos. Solo pueden diferir las coordenadas.

Fuentes

Las fuentes del sistema funcionan en todas partes sin necesidad de carga: Arial, Helvetica, Courier New, Georgia, Verdana, monospace, sans-serif, serif.

También se aceptan familias de fuentes personalizadas. Funcionan cuando la fuente está disponible en el entorno de renderizado (página web con fuentes cargadas, herramienta de diseño, etc.).

Casos de uso y compatibilidad

Contexto

CSS @keyframes

SMIL

Fuentes externas

Interactivo (onclick)

GitHub README <img>

Página web <img>

SVG en línea en página web

Exportación de herramienta de diseño

Visor de archivos estáticos

depende

depende

Solución de problemas

"MCP error -32602: Input validation error"

Esto significa que el SDK de MCP rechazó la entrada antes de que llegara al controlador. Suele ocurrir en el primer intento y funciona al reintentar. Los disparadores más comunes:

  • Error tipográfico en el tipo de degradado. Usa "linearGradient" o "radialGradient", no "linear" o "radial". Este es el error más frecuente.

  • Desplazamiento de fotograma clave como cadena. Escribe 0 o 100 (números) o "from" / "to". Escribir "0%" o "100%" fallará.

  • Colores con nombre. Solo funcionan los valores hexadecimales: "#ff0000", no "red". Tampoco rgb().

  • Falta type en los elementos. Cada objeto de elemento necesita un campo type.

Si estás creando una integración de cliente MCP y ves esto constantemente, el problema probablemente esté en cómo tu cliente serializa los argumentos. Consulta anthropics/claude-code#29104 para obtener contexto sobre peculiaridades de serialización conocidas.

La vista previa muestra una imagen en blanco o inesperada

La herramienta de vista previa renderiza una instantánea estática en t=0. Las animaciones no se capturan. Lo que ves es el estado inicial del SVG antes de que comience cualquier animación CSS o SMIL.

Si la imagen está completamente en blanco:

  • Comprueba que tus elementos tengan fill o stroke configurados. Una forma sin relleno en un lienzo transparente es invisible.

  • Comprueba las coordenadas. Un elemento en x: 2000 en un lienzo de 800px de ancho está simplemente fuera de la pantalla.

  • Si usas filter: "url(#myFilter)", asegúrate de que myFilter esté realmente definido en defs.filters.

Las animaciones no funcionan en GitHub

Los README de GitHub renderizan SVG a través de etiquetas <img>, que eliminan JavaScript pero mantienen CSS y SMIL. Si tu animación funciona localmente pero no en GitHub:

  • Evita <script> o controladores de eventos (onclick, onmouseover). Estos se eliminan.

  • Las fuentes externas no se cargarán. Limítate a las fuentes del sistema: Arial, Courier New, Georgia, monospace, sans-serif.

  • CSS @import para fuentes está bloqueado. Si necesitas una fuente específica, usa <text> en línea con una alternativa del sistema.

Salida SVG grande

Si render_svg devuelve una advertencia sobre el tamaño del archivo (más de 50kb), las curvas paramétricas o los grupos de patrones probablemente estén generando demasiados elementos. Reduce steps en las curvas paramétricas o count en los grupos de patrones. Un grid-group con cols: 50, rows: 50 produce 2500 elementos, lo cual suma rápidamente.

Stack tecnológico

  • TypeScript + Node.js 18+

  • @modelcontextprotocol/sdk (servidor MCP)

  • zod (validación de esquema y guía de tipos para IA)

  • Sin bibliotecas SVG externas, construcción XML pura

  • Vitest (280 pruebas)

Licencia

MIT. Creado por arikusi.

Available Tools

3 tools
previewPreview SVGA

Render SVG content to a PNG image so the AI can visually inspect the output.

When to use:

  • render_svg already returns a preview image by default; call this tool to re-preview a stored artifact at a different width, or to preview SVG that did not come from render_svg

  • Stop iterating when the visual result matches the intent

Input: pass EITHER artifact (id from render_svg, e.g. "art-1" — preferred, no SVG resend) OR content (raw SVG string).

Behavior:

  • Returns a PNG image (base64) rendered from the SVG

  • Background is transparent by default

  • CSS animations and SMIL are rendered as a static snapshot (t=0) — motion is not captured

Width:

  • Omit width to use the SVG's own declared width/viewBox

  • Pass width to scale the output (useful for small SVGs that need a larger preview)

ParametersJSON Schema
NameRequiredDescriptionDefault
widthNoRender width in pixels; defaults to SVG's own declared width
formatNoContent format; auto-detected from content if omitted
contentNoSVG string to render as PNG. Only needed when no artifact id exists.
artifactNoArtifact id returned by render_svg (e.g. "art-1"). Preferred over content.

TDQS

A4.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description discloses that the output is a PNG base64, background is transparent, animations are static snapshots, and width can be omitted or specified. It does not contradict any annotations (none provided). However, it does not explain the 'format' parameter's effect (e.g., when to use 'html') though schema covers it.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with sections (When to use, Input, Behavior, Width), front-loaded with purpose, and every sentence adds value without unnecessary text.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 4 optional parameters, no output schema, and no annotations, the description covers key behaviors and usage contexts. It does not explicitly state mutual exclusivity of artifact and content, but the 'pass EITHER' guidance implies it.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% so baseline is 3. The description adds meaning by explaining that 'artifact' is preferred over 'content', width can be left to default, and content is only needed when no artifact id exists.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states clearly 'Render SVG content to a PNG image so the AI can visually inspect the output.' It distinguishes from sibling tool render_svg by noting that render_svg already returns a preview and this tool is for re-previewing or previewing external SVG.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The 'When to use' section explicitly tells when to use this tool vs render_svg, including re-previewing artifacts or previewing SVG from other sources. It also advises to stop iterating when visual result matches intent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

render_svgRender SVGA

Render animated SVG from JSON config. AI controls all design parameters.

Workflow: render_svg returns a PNG preview of the result plus an artifact id — critique the image, revise the config, render again. Iterate at least 3 times before finalizing. The SVG text stays on the server: pass the artifact id to save (and to preview for a different width). Add output:{svg:true} only if you actually need the SVG text in the conversation.

output options (response shape, not content): {"svg":false,"preview":true,"previewWidth":800,"minify":false,"frames":4} — all optional. minify:true collapses whitespace in the stored/saved SVG. frames:N (2-10) replaces the static preview with one filmstrip image sampling the CSS animations at N times — use it to verify motion (rotation direction, timing, easing) since a single preview only shows t=0. SMIL is not sampled.

Element types: rect, circle, ellipse, line, polyline, polygon, path, image, text, textPath, group, use, radial-group, arc-group, grid-group, scatter-group, path-group, parametric

Pattern groups (use for repetitive designs): radial-group (circular: cx, cy, radius, count), arc-group (arc: cx, cy, radius, count, startAngle, endAngle), grid-group (matrix: cols, rows, colSpacing, rowSpacing), scatter-group (random: width, height, count, seed), path-group (along polyline: waypoints, count). Each takes ONE "child" element.

Parametric curves (fn field): rose, heart, lissajous, spiral, star, superformula, epitrochoid, hypotrochoid, wave. Size via "scale" field. Server computes coordinates.

defs: gradients (linear/radial, SMIL animated stops), filters (presets: glow, neon, blur, drop-shadow, glitch, chromatic-aberration, noise, outline, inner-shadow, emboss + 5 more), clipPaths, masks, patterns (tile fills).

Animations: CSS @keyframes via animations array. Set cssClass on element matching animation name. For transforms add transformBox="fill-box" transformOrigin="center". SMIL via smilAnimations on elements (animate, animateTransform, animateMotion).

Critical format rules:

  • Gradient type must be "linearGradient" or "radialGradient" (not "linear"/"radial"). Each needs id, stops (array with offset 0-1, color).

  • Filter type must be "preset" with a "preset" field: {"type":"preset","id":"myGlow","preset":"glow","stdDeviation":8,"color":"#ff00ff"}

  • Keyframe offset: use "from"/"to" or percentage number 0-100 (not "0%"/"100%").

  • Gradient stop and filter colors: hex only (#rrggbb or #rrggbbaa). Element fill/stroke accept '#rrggbb', 'none', or 'url(#id)' (hex is safest).

  • Every element needs "type" field. circle needs r, rect needs width+height, path needs d.

Field names that differ from raw SVG:

  • text: string goes in "content" (not "text"): {"type":"text","x":100,"y":50,"content":"Hello","fontSize":24,"textAnchor":"middle"}

  • textPath: {"type":"textPath","pathId":"idFromDefsPaths","text":"..."} — here the field IS "text".

  • group: {"type":"group","children":[...]} — children are shapes/text/use only, no nested groups.

  • Pattern groups take ONE "child" element drawn at local origin (child uses cx=0/cy=0); set rotateChildren:false to keep text upright.

Output: Pure SVG XML. No JavaScript. CSS @keyframes + SMIL only.

ParametersJSON Schema
NameRequiredDescriptionDefault
defsNo
canvasYes
outputNo
elementsYes
animationsNo

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden. It transparently discloses that SVG text stays on the server (access via artifact id), describes output format (PNG preview + artifact id), explains field name differences from raw SVG, critical format rules, and the behavior of pattern groups and parametric curves. No contradictions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but well-structured with sections (Workflow, output options, element types, pattern groups, etc.). Every sentence adds necessary detail given the complexity of SVG rendering. Slightly verbose but justified; could be tightened without losing clarity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (5 params, nested objects, no output schema), the description covers all essential aspects: input structure, workflow, output format, edge cases (field name differences, format rules), and usage of defs and animations. It explains return values (PNG preview + artifact id) despite no output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate fully. It provides extensive detail on each parameter group (canvas, elements, animations, output, defs) with examples, required fields, and format constraints (e.g., gradient type must be 'linearGradient', elements need 'type' field). This goes far beyond the bare schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description begins with 'Render animated SVG from JSON config', clearly stating the tool's core function. It distinguishes from siblings (preview, save) via workflow context, and the detailed enumeration of element types, animations, and output options reinforces the specific purpose.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides an explicit iterative workflow ('critique, revise, render again, iterate at least 3 times'), explains when to use output options like 'svg:true', and when to preview for different widths. However, it doesn't explicitly state when not to use this tool relative to the sibling tools, though the context strongly implies it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

saveSave ContentA

Save rendered content to disk. Format-aware: can save as text or render to raster image.

IMPORTANT: Use this only AFTER iterating on the design with render_svg's preview images. Do not save on the first render. Preview and refine your work first.

Input: pass EITHER artifact (id from render_svg, e.g. "art-1" — preferred, no SVG resend) OR content (raw string).

Format detection:

  • 'auto' (default): infers format from file extension. .svg saves as text, .png renders to image.

  • 'svg': saves content as a UTF-8 text file

  • 'png': renders the content (assumed SVG) to a PNG image, then saves it

If the file already exists, a numeric counter is appended before the extension to prevent overwriting: design.svg becomes design-1.svg, then design-2.svg. The actual saved path is returned in the response.

ParametersJSON Schema
NameRequiredDescriptionDefault
widthNoFor raster formats (png): render width in pixels. Defaults to the source content's own declared dimensions.
formatNoOutput format. 'auto' infers from file extension (.svg saves as text, .png renders to image). 'svg' saves content as a UTF-8 text file. 'png' renders SVG content to a PNG image before saving.auto
contentNoRaw content to save. Only needed when the content did not come from render_svg.
artifactNoArtifact id returned by render_svg (e.g. "art-1"). Preferred over content.
outputPathYesFile path to save to. The directory must already exist. If the file already exists, a numeric counter is appended before the extension: design.svg becomes design-1.svg, then design-2.svg, and so on. The actual saved path is returned in the response.

TDQS

A5/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description fully discloses behaviors: format detection (auto, svg, png), file overwrite prevention with numeric counter, and input options (artifact vs content). No contradictions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Well-structured with sections, bullet points, and bolded keywords. Every sentence earns its place—no fluff. Efficiently communicates complex behavior in a few paragraphs.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 5 params, no annotations, and no output schema, description covers all aspects: input selection, format handling, overwrite behavior, and return value. Complete enough for an agent to use correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, but description adds crucial context: width defaults to source dimensions, artifact is preferred over content, outputPath explains counter behavior, format enum values are elaborated. Adds significant value beyond schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states 'Save rendered content to disk' and distinguishes itself from siblings (preview, render_svg) by specifying it is for final saving after iterating on design.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly says 'Use this only AFTER iterating on the design with render_svg's preview images' and warns 'Do not save on the first render', providing clear usage context and when-not-to-use.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev0.3.0
    • Changedrender_svg1 field changed
      • addedInput schema / properties / output / properties / frames
        Added value: +{
        +  "type": "number"
        +}
  2. 3 tool updatesv0.2.0
    • Changedpreview3 fields changed
      • addedInput schema / properties / artifact
        Added value: +{
        +  "description": "Artifact id returned by render_svg (e.g. \"art-1\"). Preferred over content.",
        +  "type": "string"
        +}
      • changedInput schema / properties / content / description
        Previous value: -"SVG string to render as PNG"New value: +"SVG string to render as PNG. Only needed when no artifact id exists."
      • removedInput schema / required
        Removed value: -[
        -  "content"
        -]
    • Changedrender_svg6 fields changed
      • changedInput schema / additionalProperties
        Previous value: -falseNew value: +true
      • changedInput schema / properties / animations / items / additionalProperties
        Previous value: -falseNew value: +true
      • changedInput schema / properties / animations / items / properties / keyframes / items / additionalProperties
        Previous value: -falseNew value: +true
      • changedInput schema / properties / canvas / additionalProperties
        Previous value: -falseNew value: +true
      • changedInput schema / properties / defs / additionalProperties
        Previous value: -falseNew value: +true
      • addedInput schema / properties / output
        Added value: +{
        +  "additionalProperties": true,
        +  "properties": {
        +    "minify": {
        +      "type": "boolean"
        +    },
        +    "preview": {
        +      "type": "boolean"
        +    },
        +    "previewWidth": {
        +      "type": "number"
        +    },
        +    "svg": {
        +      "type": "boolean"
        +    }
        +  },
        +  "type": "object"
        +}
    • Changedsave3 fields changed
      • addedInput schema / properties / artifact
        Added value: +{
        +  "description": "Artifact id returned by render_svg (e.g. \"art-1\"). Preferred over content.",
        +  "type": "string"
        +}
      • changedInput schema / properties / content / description
        Previous value: -"Content to save. This is typically the output of a render tool such as render_svg."New value: +"Raw content to save. Only needed when the content did not come from render_svg."
      • changedInput schema / required
        Previous value: -[
        -  "content",
        -  "outputPath"
        -]New value: +[
        +  "outputPath"
        +]
  3. 1 tool updatev0.1.0
    • Changedrender_svg2 fields changed
      • removedInput schema / properties / animations / items / properties / keyframes / minItems
        Removed value: -2
      • removedInput schema / properties / elements / minItems
        Removed value: -1
  4. 3 tool updatesv0.1.3
    • First observedpreview
    • First observedrender_svg
    • First observedsave

TDQS

A4.7/5.0

Scored across 3 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: render_svg generates SVG from config, preview renders existing or external SVG to PNG, and save persists rendered content. The overlap where render_svg includes a preview by default is explicitly handled by the preview tool's description, so no ambiguity exists.

Naming Consistency4/5

All names use lowercase snake_case and are short, but there is a minor deviation: render_svg follows verb_noun while preview and save are bare verbs. The pattern is still predictable and readable, with only a slight structural inconsistency.

Tool Count5/5

Three tools is well-scoped for a focused SVG rendering service. Each tool earns its place: render for creation, preview for inspection, save for persisting output. No unnecessary duplication or bloat.

Completeness5/5

The tool surface covers the full intended workflow: render generated content, preview it at different sizes or from external SVG, and save as text or image. There are no obvious dead ends or missing core operations for the server's stated purpose.

Maintenance

ActivityStale
ResponsivenessUnresponsive

Related MCP Connectors

Related MCP Servers