clear_cache
Clear cached data. Optionally specify a pattern to clear specific entries.
LABSCO SUMMARY
Component code arrives with its size attached, so the context budget is a decision rather than a surprise.
Every fetch carries estimatedTokens, and the tools route around the heavy ones themselves: past 25000 tokens the instruction is to read the file list from get_component and pull files individually instead of taking the component whole. Nothing here writes into a project — it reads the library, its examples, and a cache you can clear by pattern when a listing goes stale.
What it is
A read-only catalogue over the UntitledUI component library, returning component source and page examples with an estimatedTokens figure attached to each response.
What you get
- Component categories listed — application, base, marketing and the rest — and the components inside one, with subfolders for variants such as modals under application
- Components searched by name across every category at once
- A component's code returned together with its file list and an estimatedTokens figure
- The same component with its base dependencies resolved, for when the imports are the point
- One named file out of a component, for when the whole thing is too large to take in a single response
- Whole page examples browsed by path and returned with all their files
Requirements
Nothing for the free components. Application and marketing components need an UntitledUI Pro licence: sign in once with npx untitledui@latest login, or set UNTITLEDUI_LICENSE_KEY in the client config.
Setup effort
One command — npx untitledui-mcp
USE CASES
01
Finding the modal variant you half-remember
Start from the categories, drill into a subfolder such as modals under application, or skip both and search the name across every category.
02
Pulling a component in without spending the whole context on it
Fetch the component to see its file list and token estimate, take its base dependencies only if the imports matter, and drop to single files when the estimate says the full response will not fit.
03
Starting from a finished page instead of a single component
Browse the example categories, drill down to the page number you want, and take the example with all of its files in one go.
10 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_component
Get a single component's code with token estimates. Returns estimatedTokens and file list. If estimatedTokens > 25000, consider using get_component_file for specific files instead.
get_component_file
Get a single file from a component. Use this when get_component or get_component_with_deps returns a large response (>25000 tokens). First call get_component to see the file list, then fetch specific files as needed.
get_component_with_deps
Get a component with all base dependencies. Returns estimatedTokens. If response is too large (>25000 tokens), use get_component_file to fetch specific files individually.
get_example
Get a single example page with all files. Requires full path including page number.
list_component_types
List all available component categories (application, base, marketing, etc.)
list_components
List components in a category. Use subfolder for variants (e.g., type='application', subfolder='modals')
list_examples
Browse available page examples. Call without path to see categories, then drill down.
search_components
Search for components by name across all categories
validate_license
Verify that the license key is valid
BEFORE YOU INSTALL
What to know first
Tools you get
10 tools when we connected. validate_license, list_component_types and clear_cache are missing from the documentation's table. Application and marketing components need a Pro licence; fetch them with get_component_with_deps so imports resolve.
Requires
- npx on PATH
- Node.js 18+
Optional
UNTITLEDUI_LICENSE_KEY in your environment
Where it runs
All 3 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 10 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx untitledui-mcpMCP Clients
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add untitledui -- npx untitledui-mcpFree components need no key. For Pro components (application and marketing), run npx untitledui@latest login, which saves your licence key to ~/.untitledui/config.json where the server picks it up, or add "env": {"UNTITLEDUI_LICENSE_KEY": "<your-key>"} to the block.
Cursor
CURSOR · JSON
{
"mcpServers": {
"untitledui": {
"command": "npx",
"args": [
"-y",
"untitledui-mcp"
]
}
}
}Free components need no key. For Pro components (application and marketing), run npx untitledui@latest login, which saves your licence key to ~/.untitledui/config.json where the server picks it up, or add "env": {"UNTITLEDUI_LICENSE_KEY": "<your-key>"} to the block.
VS Code
VS CODE · JSON
{
"servers": {
"untitledui": {
"command": "npx",
"args": [
"-y",
"untitledui-mcp"
]
}
}
}Free components need no key. For Pro components (application and marketing), run npx untitledui@latest login, which saves your licence key to ~/.untitledui/config.json where the server picks it up, or add "env": {"UNTITLEDUI_LICENSE_KEY": "<your-key>"} to the block.
