v1.0.0-beta.1
GitHub

Agent interface

AI tooling

Nerio exposes the same registry contract to people and agents through llms.txt and a read-only Model Context Protocol server.

MCP server

stdio

The server uses the official MCP TypeScript SDK and reads component metadata directly from the version-aligned Nerio Registry. Install it in the consuming project and run its public bin through pnpm; no monorepo checkout or internal source path is required.

Every tool publishes an output schema and returns the same payload as structured content and formatted JSON text. Tool failures use stable error codes so clients do not need to parse prose.

pnpm add -D @nerio-ui/mcp@1.0.0-beta.1
{  "mcpServers": {    "nerio": {      "command": "pnpm",      "args": [        "exec",        "nerio-mcp"      ]    }  }}

Clients that intentionally prefer one-off package execution may use the package-qualified configuration below. A persistent local install is easier to pin and diagnose.

{  "mcpServers": {    "nerio": {      "command": "pnpm",      "args": [        "dlx",        "@nerio-ui/mcp@1.0.0-beta.1"      ]    }  }}

Read-only tools

list_componentsDiscover names, categories, and purposes.
get_componentRead the complete registry item and token contract.
get_component_usageRead usage, source files, tokens, primitives, slots, variants, and accessibility guidance.
get_registryRead the coordinated Registry and MCP release metadata.

Import model

import { Alert, Card, Table } from "@nerio-ui/ui";import { Button, Dialog, Select, ToastProvider } from "@nerio-ui/ui/client";import "@nerio-ui/ui/styles.css";

Agents should keep static components on the server-safe @nerio-ui/ui entrypoint and use @nerio-ui/ui/client only for interactive Base UI-backed components.

Composition rules

  • Select the smallest component set that expresses the workflow.
  • Preserve semantic tokens, slots, and accessible names.
  • Use requiredTokens before inventing new product CSS variables.
  • Prefer source installation when a product needs to customize component behavior.
  • Never introduce an overlapping primitive library into a Nerio composition.

The concise machine-readable overview is available at /llms.txt.