
/plugin marketplace add liliang-cn/aigui /plugin install aigui@aigui
/plugin marketplace add liliang-cn/aigui /plugin install aigui@aigui
·
Let your coding agent draw. An MCP server — and the engine of the AIGUI plugin for Claude Code and Codex — that turns charts, diagrams, maths, 3D scenes, molecules, orbits, dashboards and step-by-step infrastructure topologies into PNGs the agent can check, or a live page in your browser.
Live demos · Source · All packages
Claude Code — the plugin also brings the skills that tell the agent when a picture beats text:
/plugin marketplace add liliang-cn/aigui
/plugin install aigui@aiguiCodex:
codex plugin marketplace add liliang-cn/aigui
codex plugin add aigui@aiguiAny MCP client — run aigui-mcp over stdio:
npm install -g @ai-gui/[email protected]
claude mcp add aigui -- aigui-mcpRequires Node.js 18.11+. The first drawing downloads a headless browser (about 100 MB, once); everything runs locally, with no account or API key.
![]() | ![]() |
![]() | ![]() |
21 block types: ECharts charts (3D too), Mermaid, KaTeX, dashboards and data walls, 3D scenes, molecules from SMILES, orbits and collisions, topologies whose steps play, knowledge graphs, geometry, function plots, optics, mechanics, labelled figures, candlesticks, tables and more. Nine of them render straight to PNG; all of them draw in a page.
| Tool | What it does |
|---|---|
aigui_guide | Lists the blocks, or returns the exact syntax for the ones named — read before writing a block. |
aigui_render | Draws the blocks in a markdown string as PNGs, returned to the agent and saved to disk. |
aigui_open | Opens the whole answer as a live page: charts to hover, 3D to turn, topologies and walls that play. |
aigui_edit | Changes part of a page by find-and-replace, without sending the whole answer again. |
aigui_export | Saves a page as PNG, PDF, one self-contained HTML file, or a GIF / WebM of it playing. |
aigui_topology | Draws a system from its docker-compose file or Kubernetes manifests. |
aigui_feedback | Reads the comments the user left on a page's blocks. |
data: {"sales": "/abs/path/sales.csv"} and write {"$data":"sales","column":"revenue"} in the chart — or pick, sum, count, max, min, avg. The figures are read from the file, never retyped by the model, and the result names the file behind each block.aigui_topology reads what is actually deployed, not what the model remembers.~/.cache/aigui/images, pages to ~/.cache/aigui/pages, listed newest first in pages/index.html. A page loads nothing from the network.Add your own block type in three files — no build step, no fork:
npx @ai-gui/cli plugin new ticket # writes ~/.config/aigui/plugins/ticket/| File | What it is |
|---|---|
aigui.json | Name, fences, a one-line description, whether it may render to PNG |
plugin.js | A plain browser script registering an AIGuiPlugin: (globalThis.__aiguiPacks ??= {}).ticket = (theme, still) => [...]. Its HTML is sanitized like any plugin's. |
spec.md | The rules the model follows to write the block |
It then appears in aigui_guide as [custom] and draws in pages, PNGs and exports. Blocks installed when a session starts are named in the tool descriptions too: in a measured run, agents used a custom block in 9 of 9 sessions with that, against 5 of 9 without. A broken folder is skipped with its reason; a name that collides with a built-in block is refused.
While the session runs, pages are served on 127.0.0.1 (a port the system picks) with a Comment button: pick a block, say what should change, send. The agent reads it with aigui_feedback and edits the page. Only the pages directory is served.
| Variable | Effect |
|---|---|
AIGUI_OUT_DIR | Where pictures and pages go. Default ~/.cache/aigui (XDG_CACHE_HOME honoured). |
AIGUI_NO_OPEN=1 | Write pages without opening them. |
AIGUI_OPEN_IMAGES=1 | Also open aigui_render's PNGs in the image viewer — the plugins set it, since a terminal cannot show images. |
AIGUI_PLUGIN_DIR | Where custom blocks live. Default ~/.config/aigui/plugins. |
AIGUI_NO_BROWSER_DOWNLOAD=1 | Skip the headless-browser download; draw with an installed Chrome or Edge. |
AIGUI_BROWSER_CHANNEL | Pin a browser: chromium, chrome or msedge. |
import { createServer, callTool, renderToContent, writePage } from "@ai-gui/mcp"createServer() returns the McpServer unconnected, for a host with its own transport; callTool(name, args) runs one tool directly.
MIT © Liang Li
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/mcp-4 to learn what the "Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add aigui -- aigui-mcpnpx @ai-gui/cli plugin new ticket # writes ~/.config/aigui/plugins/ticket/This server runs locally, so we can't read its tool list over the web yet.
We could not run this server: its npm package has not answered in our offline sandbox, which usually means it needs an API key or other configuration to start. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/mcp-4)Nothing comparable is listed yet.
v0.49.0Release notesv0.48.0Release notesv0.47.0Release notesv0.46.0Release notesv0.45.0Release notesv0.44.0Release notesv0.43.0Release notesv0.42.0Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "mcp-4" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.