Skip to content

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

ArgumentTypeWhat it does
querystringWords describing the art, such as radar, 404 page or background for a sign-in form
categorystringOne category id, such as loaders
accessstringfree, pro or all (default)
fitstringicon, card, banner or background
limitinteger1 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

ArgumentTypeWhat it does
linkstringA design link copied from an art page; it carries the art and its settings
idstringAn art id from search_arts, when there is no link
formatstringreact (default), html or svg
any optioncolor, 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.