MACHINE INTERFACE

MCP server

Connect your coding agent to Kinetiq. The Model Context Protocol server reads the machine catalog and hands your agent tools to search, read, and install components — and to stay on the motion vocabulary while it composes. 212 components and 16 blocks, one command away.

Tools

Tool	What it does
search_components	Rank the catalog by name, tagline, or keyword.
get_component	Full metadata + source for one component or block.
list_catalog	Browse everything, grouped and filterable.
get_install_command	The exact shadcn add command for any items.
get_motion_system	The five springs, tween scale, and cascade rules.
get_conventions	The AGENTS.md operating rules as markdown.

Plus three read-only resources for agents that prefer attaching the whole system at once:

kinetiq://registry-metaThe whole machine catalog (JSON).
kinetiq://conventionsThe agent rules (markdown).
kinetiq://llms-fullConventions + motion + every item's docs (text).

Setup

The server runs locally over stdio — no hosting, no account. It reads the live catalog and falls back to a bundled snapshot offline. Set KINETIQ_REGISTRY_URL to point it at a local or forked registry.

CLAUDE CODE

terminal

# After the package is published
claude mcp add kinetiq -- npx -y @kinetiqui/mcp

# Point it at a local or forked registry
claude mcp add kinetiq --env KINETIQ_REGISTRY_URL=http://localhost:3000 -- npx -y @kinetiqui/mcp

CURSOR · ~/.cursor/mcp.json

mcp.json

{
  "mcpServers": {
    "kinetiq": {
      "command": "npx",
      "args": ["-y", "@kinetiqui/mcp"],
      "env": { "KINETIQ_REGISTRY_URL": "https://kinetiqui.vercel.app" }
    }
  }
}

ANY MCP CLIENT

server entry

{
  "command": "npx",
  "args": ["-y", "@kinetiqui/mcp"],
  "env": { "KINETIQ_REGISTRY_URL": "https://kinetiqui.vercel.app" }
}

Rules for your agent

Install the operating rules so your agent stays on Kinetiq's vocabulary automatically — it drops an AGENTS.md at your repo root.

$ pnpm dlx shadcn@latest add @kinetiq/agents-rules

Machine endpoints

/registry-meta.jsonthe complete machine catalog
/llms.txtthe index, as plain text
/llms-full.txtthe full reference in one fetch
/r/<slug>.jsonone registry item, sources inlined

Prefer raw registry access without an agent? See the integration guide →