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

one-liner, no file to edit

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.

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