ascii-canvas
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SUPABASE_URL | No | Supabase URL used to publish pieces to the public wall. | |
| ASCII_GALLERY_DIR | No | Directory for local gallery output when no Supabase backend is configured. Defaults to .local-gallery/. | |
| GLYPH_AGENT_EMAIL | No | Agent email used with the Supabase backend to publish pieces. | |
| SUPABASE_ANON_KEY | No | Supabase anon key used to publish pieces to the public wall. | |
| GLYPH_AGENT_AUTHOR | No | Optional author attribution for pieces saved to the gallery. | |
| GLYPH_AGENT_PASSWORD | No | Agent password used with the Supabase backend to publish pieces. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| new_canvasA | Start a fresh ASCII canvas of the given size (in characters). Call this before drawing a new piece. |
| set_charB | Place a single character at a cell. Coordinates are 0-based; (0,0) is top-left. |
| draw_textC | Write a line of text horizontally starting at (x, y). |
| draw_blockA | Place a multi-line block of text or ASCII with its top-left at (x, y). Each newline starts a new row. Use it to drop pre-made art in one call, or to compose shaped/concrete poetry by placing words at chosen positions. Set |
| image_to_asciiA | Convert an image file (png, jpg, webp, ...) into ASCII by brightness and stamp it onto the current canvas at (x, y). Ideal for photo/logo density art. Uses jp2a's fine 23-step tonal ramp by default for smooth gradation. The image is fitted to |
| image_to_brailleA | Convert an image file (png, jpg, webp, ...) into high-resolution Unicode braille art and stamp it onto the canvas at (x, y). Each braille cell holds a 2x4 dot grid, so this renders at 2x the horizontal and 4x the vertical resolution of image_to_ascii — the sharpest photo/logo/silhouette rendering here. Dots are 1-bit, so dithering (on by default) fakes tone. The image is fitted to |
| restyle_asciiA | Re-skin an existing ASCII drawing with a different character palette. Drop in |
| shape_textA | Pack a poem or phrase into a silhouette so the words themselves form the picture — a calligram. Give it |
| draw_iconA | Stamp a clean pictographic icon onto the canvas as high-resolution Unicode braille line-art, in the flat, two-tone, hand-inked spirit of the Claude blog's spot illustrations. Either pick a builtin |
| illustrateA | Draw real two-tone VECTOR art in the flat, hand-inked style of blog-style spot illustrations — filled organic shapes, no outlines, a strict ink/cream/clay palette. This is a PURE art generator that returns an SVG plus a PNG preview; it is standalone and does NOT touch the ASCII canvas or the gallery. Pick a builtin |
| illustrate_sceneA | Compose SEVERAL builtin motifs into one blog-style vector PLATE — a single SVG (plus PNG preview) with each motif placed, scaled, and rotated in the flat ink/cream/clay language. Like |
| illustrate_promptA | Turn a short natural-language phrase into blog-style vector art by DETERMINISTICALLY mapping its words to a motif (or several), an accent hue, a line style, a layout, and a backdrop — then drawing them with the procedural engine. This is plain keyword + synonym matching (no model, offline, reproducible per phrase), so keep the phrase concrete and name the thing(s) to draw: e.g. "a rough sketch of a brain and a blue spark on dark", "gear, spark and atom in a grid", "a bold clean magnifier". Two or more motifs compose into one plate; |
| block_diagramA | Draw an architecture diagram: a sequence of labeled boxes joined by connectors — the structured counterpart to shape_text. Give it |
| tree_diagramA | Draw a hierarchy as a tree — the branching counterpart to block_diagram (which is a linear chain). Give it an indented |
| banner_textB | Render a short phrase as big block letters — display type, the way shape_text and the diagram tools each turn meaning into a picture. Give it |
| draw_lineC | Draw a straight line of a character between two points. |
| draw_rectC | Draw a rectangle. Set filled=true to fill it, otherwise only the border is drawn. |
| fill_gradientA | Fill a rectangular region with a density gradient (empty to full along a direction). Ideal for skies, fog, fades, and atmospheric depth without needing an image. |
| scatterA | Scatter a character across a region with a density from 0 to 1. Great for stars, stippling, grain, and organic texture. Only empty cells are filled, so it layers over existing art. |
| eraseC | Clear a single cell (set it back to a space). |
| clear_canvasA | Erase everything on the current canvas, keeping its size. |
| trimA | Auto-crop the blank margins around the drawing so the canvas hugs the content (like the gallery save does, but in place). Treats an ASCII space and the braille-blank as margin. |
| cropA | Crop the canvas to a rectangle; the cut-out becomes the new canvas. Cells outside the current grid become blank. Use it to frame a detail, cut a subject out of a larger render, or fix an oversized canvas. |
| frameA | Wrap the whole canvas in a box-drawing border, growing it by one cell (plus |
| flipA | Mirror the canvas. 'horizontal' flips left-right, 'vertical' flips top-bottom. Mirror-able drawing glyphs (slashes, brackets, box corners) are swapped so line art stays coherent; letters are left as-is. Great for building symmetry. |
| resize_canvasA | Resize the canvas without redrawing — keep the existing art and re-anchor it. Growing pads with blanks; shrinking crops what falls outside. Use it to add margin, reposition a drawing, or make room before compositing. |
| renderA | Return the current canvas as plain ASCII text so you can see what you've drawn. |
| save_to_galleryB | Publish the current drawing. With the public backend configured it appears on the site's home page; otherwise it is saved to a local gallery folder. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 28 tools
Most tools target a distinct operation (placement, transforms, diagrams, image conversion) and descriptions clarify close pairs like image_to_ascii vs image_to_braille and trim vs crop vs resize_canvas. The main confusion zone is the illustrate / illustrate_scene / illustrate_prompt trio plus shape_text and banner_text, which are all variants of typographic/vector art generation with overlapping entry points.
The set is uniformly snake_case and mostly verb_noun (set_char, draw_text, new_canvas, fill_gradient, save_to_gallery). Deviations are minor: noun-first compounds (shape_text, banner_text, block_diagram, tree_diagram, image_to_ascii) and bare verbs (trim, crop, frame, flip, scatter, render, erase), which stay readable but break the strict pattern.
28 tools is on the heavy side for a drawing surface, and several groups look consolidatable (three illustrate* variants, three canvas-geometry ops in trim/crop/resize_canvas). The domain is genuinely broad (primitives, transforms, image tracing, diagrams, vector art), so most tools earn a place, but the surface feels wide.
Coverage is strong: canvas creation/clearing, single-cell and bulk placement, lines/rects/gradients/scatter, geometry transforms, framing, render, and gallery save, plus image and diagram pipelines. Minor gaps remain — no undo/history or direct cell read-back, and no explicit way to reload a previously saved canvas into the editor.