Docs / MCP
MCP tools reference
All three tools are read-only.
list_categories
No arguments. Returns the 12 categories with their id, name, a short description, how many arts each has and how many are free.
search_arts
| Argument | Type | What it does |
|---|---|---|
query | string | Words describing the art, such as radar, 404 page or background for a sign-in form |
category | string | One category id, such as loaders |
access | string | free, pro or all (default) |
fit | string | icon, card, banner or background |
limit | integer | 1 to 87, default 20 |
Results are ranked: words that match an art's id or name count most. Each result has the art's id, name, category, access, fit, what it shows, where it fits, and its page address.
get_art
| Argument | Type | What it does |
|---|---|---|
link | string | A design link copied from an art page; it carries the art and its settings |
id | string | An art id from search_arts, when there is no link |
format | string | react (default), html or svg |
| any option | color, speed, spacing, text and the rest |
Settings named in the call win over those in the link. For a free art, the answer is plain text: a line saying to use the code as it is, how to use it and the smallest width it reads well at, then the file, ready to save. It has no structuredContent, because some clients (Claude Code among them) show the model only structuredContent when there is one, and the code would never reach it. The code is the art exactly as the art page draws it: the assistant should save it as it is, not rewrite or redraw it. Settings outside their range are moved into it; unknown ones are ignored. SVG stills are drawn at the default dot spacing or coarser, so they stay small.
For a Pro art, the answer says so, gives the art's page, where it can be previewed, and lists the free arts in the same category. It asks the assistant not to recreate the Pro art by hand, and to ask you before adding one of the free arts instead.
Example request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_art",
"arguments": { "link": "https://elrootlabs.com/opensource/dotmatrix/signals/radar?c=FFB000", "format": "react" },
"_meta": { "io.modelcontextprotocol/protocolVersion": "2026-07-28" }
}
}
Sent with the headers MCP-Protocol-Version: 2026-07-28, Mcp-Method: tools/call and Mcp-Name: get_art.