Agent guide

Install the easeUI agent skill, connect the MCP server, or consume the agent-friendly registry endpoints directly.

Agent skill

Install the skill when you want coding agents to choose existing easeUI components before inventing custom motion widgets.

terminal

npx skills add rjcuff/easeui --skill easeui

MCP server

Connect the hosted easeUI MCP server at https://easeui.dev/api/mcp.

Claude Code

claude mcp add --transport http easeui https://easeui.dev/api/mcp

Codex

codex mcp add easeui --url https://easeui.dev/api/mcp

Manual configuration:

mcp.json

{
  "mcpServers": {
    "easeui": {
      "type": "http",
      "url": "https://easeui.dev/api/mcp"
    }
  }
}

Available tools: list_components, search_components, get_component, and get_install_command.

Endpoints

Endpoint	Purpose
/llms.txt	Markdown discovery index
/r	JSON catalogue of every component
/r/{slug}	Component detail with files, dependencies, and source
/registry.json	shadcn directory-compatible catalogue
/r/{slug}.json	shadcn install item with inline file content
/r/{slug}/raw	Copy-ready plain-text source
/components/{category}/{slug}.md	Component documentation as Markdown

Agent flow

1. Fetch https://easeui.dev/r to discover components.
2. Select the closest item by its published name and description.
3. Fetch https://easeui.dev/r/{slug} for source, files, and dependencies.
4. Write every returned file to its declared path.
5. Install the external dependencies from the response.

shadcn flow

terminal

# Official registry namespace
npx shadcn@latest add @easeui/command-palette

# Direct registry URL
npx shadcn@latest add https://easeui.dev/r/command-palette.json