{
  "markdown": "# artscii\n\n[![npm](https://img.shields.io/npm/v/artscii)](https://www.npmjs.com/package/artscii)\n\n**LLMs can't draw. This MCP can.**\n\nASCII art, kaomoji, animations, diagrams, charts, image conversion & procedural characters — 11 focused tools for AI agents.\n\n81 curated arts × 12 motions = 972 terminal animations. 153,600 unique procedural characters from a single seed. Plus 100 kaomoji, 11 diagram types, FIGlet banners, and image-to-ASCII with braille mode.\n\n```\n     .::-::.         .:-::.        --- apple (16w) ---\n  .=#%@@@@@%#=:  .=*%@@@@@%#+:           +:\n -%@@@@@@@@@@@%*+%@@@@@@@@@@@%+      :--:#*.--:\n.%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@-    -#@@@@#%@@@@%=\n-@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*   :@@@%****+#%@@@:\n.%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@=   -@%%%+*@@+*@%%@-\n =@@@@@@@@@@@@@@@@@@@@@@@@@@@@*     *@@%+*+#=#%@@#\n  -#@@@@@@@@@@@@@@@@@@@@@@@@%=       +%@@@#@@@@%+\n    =%@@@@@@@@@@@@@@@@@@@@%*.         .-+**=*+=.\n      =#@@@@@@@@@@@@@@@@%+.\n        =#@@@@@@@@@@@@%+.    ʕ•ᴥ•ʔ  (◕‿◕)  (╯°□°)╯︵ ┻━┻\n          -#@@@@@@@@%+.\n            -#@@@@%=.\n              -*#=\n```\n\n## Install\n\n**Claude Code** — one command:\n```bash\nclaude mcp add artscii -- npx -y artscii\n```\n\n**Claude Desktop** — add to `claude_desktop_config.json`:\n```json\n{ \"mcpServers\": { \"artscii\": { \"command\": \"npx\", \"args\": [\"-y\", \"artscii\"] } } }\n```\n\n**Cursor** — add to `.cursor/mcp.json`:\n```json\n{ \"mcpServers\": { \"artscii\": { \"command\": \"npx\", \"args\": [\"-y\", \"artscii\"] } } }\n```\n\n**VS Code** — search `@mcp artscii` in Extensions panel, or add to `settings.json`:\n```json\n{ \"mcp\": { \"servers\": { \"artscii\": { \"command\": \"npx\", \"args\": [\"-y\", \"artscii\"] } } } }\n```\n\n## MCP Tools\n\n| Tool | Parameters | Description |\n|---|---|---|\n| `search` | `query?`, `type?`, `random?`, `mode?` | Search art + kaomoji. Omit query to list all |\n| `get` | `id` | Get art by ID |\n| `kaomoji` | `query?`, `category?` | Get kaomoji by emotion. Omit for random |\n| `banner` | `text`, `font?` | Render large ASCII text (FIGlet, 5 fonts) |\n| `frame` | `text`, `style?`, `padding?`, `align?`, `title?` | Draw box/frame around text (5 styles) |\n| `chart` | `type`, ... | Data visualization: progress, sparkline, heatmap |\n| `animate` | `art`, `motion`, `output?` | Compose art + motion → terminal animation |\n| `character` | `seed`, `species?`, `eyes?`, `mouth?`, `hat?`, `accessory?`, `mood?`, `size?` | Generate unique ASCII character from seed |\n| `compose` | `blocks`, `mode?`, `gap?`, `align?` | Combine text blocks side-by-side or stacked |\n| `convert` | `url?`, `base64?`, `mode?`, `size?`, ... | Image → ASCII (ascii or braille mode) |\n| `diagram` | `type`, ... | Generate ASCII diagrams (11 types) |\n\n## Box Frames\n\nDraw borders around any text with 5 styles:\n\n```\n┌───────┐   ╔═══════╗   ╭───────╮   ┏━━━━━━━┓   +-------+\n│ hello │   ║ hello ║   │ hello │   ┃ hello ┃   | hello |\n└───────┘   ╚═══════╝   ╰───────╯   ┗━━━━━━━┛   +-------+\n single      double      rounded       bold        ascii\n```\n\nOptions: `padding`, `align` (left/center/right), `title` in top border.\n\n## Charts\n\nUnified `chart` tool with 3 types: **progress**, **sparkline**, **heatmap**.\n\n```\nProgress:   ███████████████░░░░░ 75%\nSparkline:  ▁▂▃▄▅▆▇█▇▅▃▁\nHeatmap:     A B C\n           X ░▒█\n           Y ▓░▒\n```\n\n## Animations\n\nCompose any art (noun) with a motion (verb) to create terminal animations. **81 arts × 12 motions = 972 combinations.** Custom text works too.\n\n```\nanimate(\"apple\", \"bounce\")     → bouncing apple\nanimate(\"trophy\", \"progress\")  → trophy rides a progress bar 0→100%\nanimate(\"lock\", \"reveal\")      → line-by-line reveal\nanimate(\"GAME OVER\", \"blink\")  → blinking custom text\n```\n\nMotions: `bounce`, `shake`, `blink`, `slide`, `reveal`, `fade`, `pulse`, `rain`, `progress`, `wave`, `jump`, `talk`\n\nOutput: `script` (bash for terminal playback) or `frames` (raw data)\n\n## Character\n\nProcedural ASCII character generator. One seed → one unique character. **153,600 standard combinations** (16 species × 10 eyes × 8 mouths × 10 hats × 12 accessories).\n\n```\ncharacter(\"alice\")                   character(\"bob\", mood: \"happy\")\n\n   ____                                  /\\_/\\\n  ]==== )                                ( ^ ^ )\n  _____                                  ( u )\n / * * \\                                  \\_^_/\n|   u   |\n \\_____/\n  |||||\n   ~~o=o~~\n```\n\n**Species**: blob, cat, bear, robot, bird, bunny, ghost, alien, fox, frog, penguin, octopus, dragon, mushroom, cactus, skull\n\n**Mood presets**: happy, sad, angry, surprised, sleepy, cool, love, silly — sets eyes+mouth in one param. Explicit eyes/mouth still override.\n\n**Mini mode**: 2-line inline characters for chat and status lines.\n\n```\nmini blob: (^ ^)    mini cat: /^ ^\\    mini robot: [^ ^]\n            (u)                >u<                  [u]\n```\n\nSame seed always produces the same character. Output works directly with the `animate` tool — try `wave`, `jump`, or `talk` motions.\n\n## Compose\n\nCombine multiple text blocks horizontally (side-by-side) or vertically (stacked):\n\n```\n┌───┐ ┌───┐         ┌───┐\n│ A │ │ B │         │ A │\n└───┘ └───┘         └───┘\n horizontal          ---\n                    ┌───┐\n                    │ B │\n                    └───┘\n                    vertical\n```\n\nOptions: `gap`, `align` (top/middle/bottom), `separator` (vertical mode).\n\n## Image Conversion\n\nConvert images (URL or base64) to ASCII art. Two render modes:\n\n- **`ascii`** — character ramp (` .:-=+*#%@`), classic look\n- **`braille`** — Unicode braille dots (⠿), 8x resolution per character\n\nOptions: `size` (16/32/64), `invert`, `contrast`, `gamma`, `threshold` (braille).\n\n## Diagrams\n\n11 diagram types with `unicode`, `rounded`, and `ascii` border styles.\n\n| Type | Required fields | Output |\n|---|---|---|\n| `flowchart` | `nodes` | Vertical flow with `│` `▼` connectors |\n| `box` | `title`, `lines` | Title + separator + body |\n| `tree` | `root` (`{label, children?}`) | `├──` `└──` hierarchy |\n| `table` | `headers`, `rows` | Column-aligned grid |\n| `sequence` | `actors`, `messages` | Actor lifelines with arrows |\n| `timeline` | `events` | Vertical `●` `│` event list |\n| `bar` | `items`, `maxWidth?` | Horizontal `█` bar chart |\n| `class` | `classes` | UML class with properties/methods |\n| `er` | `entities`, `relationships` | Entity-relationship diagram |\n| `mindmap` | `root` | Horizontal mind map tree |\n| `gantt` | `tasks`, `unitLabel?` | Gantt chart with timelines |\n\n```\n┌─────────┐    ╭──────────╮    ┌──────┬───────┐    src\n│  Start  │    │  Status  │    │ Name │ Score │    ├── index.ts\n└────┬────┘    ├──────────┤    ├──────┼───────┤    └── diagram.ts\n     │         │ Line 1   │    │ A    │ 95    │\n     ▼         │ Line 2   │    │ B    │ 87    │\n┌─────────┐    ╰──────────╯    └──────┴───────┘\n│   End   │\n└─────────┘\n flowchart       box              table              tree\n```\n\n### Class Diagram\n\n```json\n{ \"type\": \"class\", \"classes\": [\n  { \"name\": \"Animal\", \"properties\": [\"+ name: string\"], \"methods\": [\"+ speak(): void\"] },\n  { \"name\": \"Dog\", \"properties\": [\"+ breed: string\"], \"methods\": [\"+ bark(): void\"] }\n]}\n```\n\n```\n┌──────────────────┐\n│      Animal       │\n├──────────────────┤\n│ + name: string   │\n├──────────────────┤\n│ + speak(): void  │\n└──────────────────┘\n         ▲\n         │\n┌──────────────────┐\n│       Dog         │\n├──────────────────┤\n│ + breed: string  │\n├──────────────────┤\n│ + bark(): void   │\n└──────────────────┘\n```\n\n### Gantt Chart\n\n```json\n{ \"type\": \"gantt\", \"tasks\": [\n  { \"label\": \"Design\", \"start\": 0, \"duration\": 3 },\n  { \"label\": \"Develop\", \"start\": 2, \"duration\": 5 },\n  { \"label\": \"Test\", \"start\": 5, \"duration\": 3 }\n], \"unitLabel\": \"weeks\" }\n```\n\n```\n            0   2   4   6   8 weeks\n            ┼────────────────────\nDesign      ████████\nDevelop         █████████████████\nTest                 ████████████\n```\n\n## Banner\n\nRender text as large ASCII art using FIGlet fonts: `Standard`, `Small`, `Slant`, `Big`, `Mini`.\n\n## Size Tiers\n\nEach art is stored at its minimum identifiable size.\n\n| Tier | Dimensions | For |\n|------|-----------|-----|\n| **16w** | 16 x 8 | Icons, symbols, simple shapes |\n| **32w** | 32 x 16 | Animal silhouettes, emoji |\n| **64w** | 64 x 32 | Detailed scenes (rare) |\n\n## Kaomoji\n\n100 curated entries across 26 categories. Source: [kao.moji](https://github.com/bnookala/kao.moji) (MIT).\n\n| Category | Examples |\n|---|---|\n| happy | `(◕‿◕)` `◉‿◉` `(≧◡≦)` |\n| sad | `(ಥ﹏ಥ)` `╥﹏╥` `(;﹏;)` |\n| angry | `ಠ_ಠ` `(¬_¬)` `눈_눈` |\n| love | `♡＾▽＾♡` `(•ө•)♡` `✿♥‿♥✿` |\n| confused | `¯\\_(ツ)_/¯` `◔_◔` `(・・?)` |\n| animals | `ʕ•ᴥ•ʔ` `ฅ•ω•ฅ` `(•ㅅ•)` |\n| table-flip | `(╯°□°)╯︵ ┻━┻` `┬─┬ノ(ಠ_ಠノ)` |\n| + 19 more | excited, greeting, celebrate, hug, surprised, sleepy, nervous, wink, magic, laughing, determined, eating, dancing, hopeful, jealous, ... |\n\n## License\n\nMIT. Art icons from [game-icons.net](https://game-icons.net) (CC BY 3.0, Lorc & Delapouite).\n",
  "bytes": 8858,
  "sha": "d5784ecd4452f093fa158404d5495eeefdc17b97fb21855b21f548d51e2c54b3",
  "repo_slug": "rxolve/artscii",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rxolve_artscii_d3ad5a08/readme"
}