Thin MCP server for managing StyleDex design library artifacts.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"styledex-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# styledex-mcp Thin MCP server for managing the StyleDex design library at `~/.styledex/designs`. The server owns aliases, curated Playwright capture, metadata, artifact writes, validation summaries, rename, list, and delete. It does not expose generic browser controls; it only captures the StyleDex evidence types agents need. ## Install Install the MCP server: ```bash uv tool install styledex-mcp ``` Install the Playwright browser used for captures: ```bash uvx --from styledex-mcp playwright install chromium ``` If `styledex-mcp` is not found after installation, add uv's tool directory to your shell path: ```bash uv tool update-shell ``` Restart your shell after updating the path. Upgrade later with: ```bash uv tool upgrade styledex-mcp ``` Uninstall with: ```bash uv tool uninstall styledex-mcp ``` ## MCP Config Use the installed `styledex-mcp` executable in your MCP client config. ```json { "mcpServers": { "styledex": { "command": "styledex-mcp" } } } ``` For opencode: ```json { "mcp": { "styledex": { "type": "local", "command": ["styledex-mcp"], "enabled": true } } } ``` Restart your MCP client after changing MCP config. `styledex-mcp` uses stdio transport. Running it directly in a terminal is only useful for smoke testing; it waits for an MCP client on stdin. ## Environment - `STYLEDEX_ROOT`: optional override for the design library root. Defaults to `~/.styledex/designs`. - Legacy fallback: when `STYLEDEX_ROOT` is unset, `~/.styledex/designs` does not exist, and the old Style Mirror root exists, StyleDex reads `STYLE_MIRROR_ROOT` or `~/.style-mirror/designs` so existing captures remain available after the rename. ## Tools - `styledex_list` - `styledex_get` - `styledex_create` - `styledex_capture_screenshot` - `styledex_capture_snapshot` - `styledex_capture_extract` - `styledex_save` - `styledex_rename` - `styledex_delete` `styledex_create` supports `mode="overwrite"`. `styledex_delete` …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.