Artscii
@rxolve
About Artscii
ASCII art & kaomoji search for AI agents. 58 arts + 90 kaomoji. Search, convert images, get random art via MCP.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"artscii": {
"command": "npx",
"args": [
"-y",
"artscii"
]
}
}
}Tools
11Search ASCII art and kaomoji. Omit query to list all. Use random for a random entry. Use mode "categories" to list categories.
Get ASCII art by ID.
Render text as a large ASCII banner using FIGlet fonts. Great for CLI headers, welcome messages, and titles.
Get a kaomoji (Japanese text emoticon) by emotion or keyword. Perfect for inline text expressions.
Draw a box/frame around text. Styles: single, double, rounded, bold, ascii.
Render data as ASCII charts. Types: progress (bar), sparkline (trend), heatmap (2D grid).
Combine multiple text blocks side-by-side or stacked.
Compose ASCII animations: combine any art with a motion. Motions: bounce, shake, blink, slide, reveal, fade, pulse, rain, progress, wave, jump, talk. Returns a bash script or raw frames.
Convert an image (URL or base64) to ASCII art. Modes: "ascii" (character ramp) or "braille" (2x4 dot grid, higher fidelity).
Generate a unique ASCII character from a seed. 153600 possible combinations (16 species × 10 eyes × 8 mouths × 10 hats × 12 accessories). Same seed always produces the same character. Use mood for quick expression presets. Output can be piped to the animate tool.
Generate ASCII diagrams: flowcharts, boxes, trees, tables, sequence, timeline, bar, class, ER, mindmap, and gantt.
Overview
What is Artscii?
Artscii is an ASCII art and kaomoji server for AI agents, CLI tools, and chatbots, providing 58 built‑in arts and 90 kaomoji searchable via MCP or REST API.
How to use Artscii?
Run the MCP server with npx -y artscii and configure it in your MCP client (e.g., Claude Desktop, Cursor). Alternatively, start the REST API server with npx artscii and access endpoints like GET /search?q={query}. Use MCP tools such as search, kaomoji, get, random, list, submit, convert, and delete.
Key features of Artscii
- 58 built‑in ASCII arts in three size tiers (16w, 32w, 64w)
- 90 kaomoji across 22 emotion/theme categories
- Search art and kaomoji by query or category
- Convert images to ASCII art via URL or base64
- Submit and delete user‑contributed art
Use cases of Artscii
- Give CLI tools personality with ASCII loading screens, success badges, or error illustrations
- Make chatbots expressive by reacting with mood‑matched kaomoji
- Add visuals to AI agents without wasting tokens (16w art is only 8 lines)
FAQ from Artscii
What arts and kaomoji are included?
58 ASCII arts (icons, symbols, animal silhouettes, detailed scenes) and 90 kaomoji curated from the kao.moji project (MIT license). Art icons from game-icons.net (CC BY 3.0).
How do I install and run Artscii?
For MCP: npx -y artscii. For REST API: npx artscii or npm i artscii && npm start. The MCP server listens on standard MCP transport (stdio) and the REST API on port 3001 by default.
What MCP tools are available?
Tools include search, kaomoji, get, random, list, categories, submit, convert, and delete. Each has specific parameters described in the README.
Can I convert my own images to ASCII?
Yes, via the POST /convert endpoint or the MCP convert tool. Provide a URL or base64‑encoded image, optionally adjust size (16/32/64), invert, contrast, or gamma, and save the result.
Is there a limit on user‑submitted art?
The README does not specify limits. Submissions are stored and can be deleted via the delete tool or DELETE /art/:id endpoint.
Frequently asked questions
What arts and kaomoji are included?
58 ASCII arts (icons, symbols, animal silhouettes, detailed scenes) and 90 kaomoji curated from the kao.moji project (MIT license). Art icons from game-icons.net (CC BY 3.0).
How do I install and run Artscii?
For MCP: `npx -y artscii`. For REST API: `npx artscii` or `npm i artscii && npm start`. The MCP server listens on standard MCP transport (stdio) and the REST API on port 3001 by default.
What MCP tools are available?
Tools include `search`, `kaomoji`, `get`, `random`, `list`, `categories`, `submit`, `convert`, and `delete`. Each has specific parameters described in the README.
Can I convert my own images to ASCII?
Yes, via the `POST /convert` endpoint or the MCP `convert` tool. Provide a URL or base64‑encoded image, optionally adjust size (16/32/64), invert, contrast, or gamma, and save the result.
Is there a limit on user‑submitted art?
The README does not specify limits. Submissions are stored and can be deleted via the `delete` tool or `DELETE /art/:id` endpoint.
Basic information
More Other MCP servers
Inbox Zero AI
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Production-ready MCP integrations for AI applications
Klavis-AIKlavis AI: MCP integration platforms that let AI agents use tools reliably at any scale
MCP Registry
modelcontextprotocolA community driven registry service for Model Context Protocol (MCP) servers.
ICSS
chokcoco不止于 CSS
Lemon.io
lemon-ioRequest dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3
Comments