Skip to main content

ns-ui / connect

Get the registry into an agent.

Three ways in: an MCP server for tools an agent can call mid-task, a CLI for finding, inspecting and installing from a terminal, and the raw text feeds for anything that just reads.

MCP server

Five tools: search the catalog, get one component's full detail and real source, list categories, get the install command, and get the design-token conventions the components are built against. Ships a static snapshot of the registry, so it works once installed from npm without a live connection back to this site.

Add to your MCP client

Run in a terminal

claude mcp add ns-ui -- npx -y @nikolas.sapa/ns-ui-mcp

Requires Node 18+.

CLI

Finds and inspects components from a terminal, not just installs them: search narrows the catalog by name, description, tags and use-when guidance; info prints one component's props, dependencies and install command. add installs by delegating to shadcn add, once per name, and fails fast with a "did you mean" on a typo instead of handing it to shadcn. Reads from a local cache first and a bundled snapshot if the network is down, so it still works offline.

Find one

npx @nikolas.sapa/ns-ui search "reactive hero"

Read its props and install command

npx @nikolas.sapa/ns-ui info undo-ghost-row

Install it

npx @nikolas.sapa/ns-ui add <name> [...names]

Also: list, categories, and mcp (prints the MCP config block above). Full command reference: cli/README.md.

If npx refuses either package with "No versions available", that's npm's own minimum-release-age setting on your machine (a supply-chain policy some orgs and individuals set) rejecting a package published within that window, not a problem with the package itself. Wait out the window or override the policy locally.

Text feeds

For anything that just reads rather than calls tools: /llms.txt is the catalog index, and /llms-full.txt adds a condensed prop signature and usage guidance per component. Both are generated from the same registry data as the MCP server and the site itself, so none of the three can drift from another.

Feed URLs

https://design.helpmarq.com/llms.txt
https://design.helpmarq.com/llms-full.txt

Every install command resolves against https://design.helpmarq.com.

Ask AI

Point an assistant at the registry's llms.txt feeds with one click.

Claude, ChatGPT, Grok, and Perplexity open with the prompt already in. Gemini copies it to your clipboard first. Paste it in once the chat opens.