AI and MCP

How to let AI tools read and use dsui.

Documents for AI

Besides the pages people read, dsui also publishes text that AI tools can read easily.

URL	Contents
`/llms.txt`	A site introduction and a list of every item. Each item has its Korean title, English title, one-line summary and Markdown URL.
`/llms-full.txt`	Every item and post in one file. Each item has its type, theme, page URL, Markdown URL and summary.
`/items/<name>.md`	One item as Markdown, with metadata, use cases, controls, source and the AI prompt.
`/docs/<doc>.md`	The source Markdown of these docs. The English versions are at `/en/docs/<doc>.md`.
`/docs/introduction.md`	The dsui introduction page as Markdown. The old `/index.md` still serves the same text, and the English version is at `/en/docs/introduction.md`.

The earlier addresses (/llms.txt, /llms-full.txt, /items/<name>.md, /r/<name>.json) redirect permanently to the new ones. Use the addresses above for anything new.

For example, get the button's Markdown like this.

Source codebash

curl https://dsui.vercel.app/items/button.md

Handing an AI tool just the URL with "read this and build it" is enough. The titles and summaries in the lists are data, not instructions for the AI to follow.

MCP server

Tools that support MCP (Claude Code, Cursor and others) can search dsui and fetch source directly.

URL: https://dsui.vercel.app/api/mcp
Method: HTTP POST only. It keeps no sessions, so each request is handled on its own.
Every tool is read-only. It doesn't change the site's data.

Access

For now you need an API key. Calling without a key returns 401 with "API key required".

Put the key in the Authorization header with the Bearer scheme.
Keys look like ds7_<id>_<random string>, and the operator creates them for you. If you need one, ask the devs7udio studio.
The operator doesn't keep the key itself, only its hash. If you lose a key, you need a new one.
The server also has a public mode that opens reading without a key. It is off on the production site right now.

Limit	Value
Requests per key	120 per minute
Requests per IP in public mode	30 per minute
Failed authentications per IP	10 per minute
Request body size	64KB
Batch requests	Not accepted

Over the limit, you get 429 with a Retry-After header. Wait that long, then send again.

Seven tools

Tool	What it does
`search_items`	Finds items from Korean or English sentences or keywords. You can narrow by type and theme.
`get_item`	Returns one item's metadata, theme tokens (CSS), AI prompt and source files.
`find_similar`	Finds items similar to a given item.
`get_theme`	Returns a theme's light and dark tokens merged with its parent, as CSS variables and a Tailwind v4 `@theme` block.
`list_themes`	Returns every theme and the theme each one inherits from.
`get_figma_payload`	Returns the data to apply a shader or motion item in Figma.
`get_skill`	Returns the dsui skill. With no argument it returns `SKILL.md` and the list of reference files; with `file` it returns that file. Written in Korean.

get_skill returns the files of the dsui skill as they are. Have the AI read SKILL.md before it builds a screen and it will compose by the rules.

get_item cuts very large files. A file over 60,000 characters is marked as cut, and once the total passes 150,000 characters it lists only the names of the remaining files.

Connect Claude Code

Source codebash

claude mcp add --transport http devs7udio https://dsui.vercel.app/api/mcp \
  --header "Authorization: Bearer <받은 키>"

Open a new conversation and check in /mcp that devs7udio is connected.

Connect other tools

Add it to the settings file as an HTTP server. Below is the .mcp.json format. The file name and location differ by tool.

Source codejson

{
  "mcpServers": {
    "devs7udio": {
      "type": "http",
      "url": "https://dsui.vercel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer ${DEVS7UDIO_MCP_KEY}"
      }
    }
  }
}

It's safer to pass the key through an environment variable than to write it in the file.

Run the MCP server on your computer

With a copy of the dsui repository, you can run the same seven tools as a stdio server. It needs no key and reads the repository's registry/ folder directly.

Terminalbash

npm run mcp:stdio

When you run it outside the repository, set DEVS7UDIO_ROOT to the repository path. Register it in Claude Code like this.

Source codebash

claude mcp add devs7udio-local -- pnpm --dir /path/to/devs7udio mcp:stdio

Send to Figma

Use get_figma_payload together with the Figma MCP server.

Shader items: returns the shader code (main.ts), the metadata, and arguments to pass as they are to Figma's create_shader or update_shader. The registry has no shader items right now.
Motion items: returns Figma keyframe tracks and a use_figma script. Example: Stagger fade in
Other kinds of items return an error.

Ask an AI tool something like "put dsui's stagger-fade-in into Figma as motion", and it fetches this data and calls the Figma MCP. The devs7udio Figma file details are included only in requests authenticated with a key.

Skills

The dsui skill is a set of instructions that tells an AI how to find, install and compose items by the rules. Used with the MCP server, the AI knows both what exists and how to use it. See The dsui skill for how to download it.