MCP Server
Use GodUI from your AI IDE. Find and install components by describing them.
GodUI ships an MCP server so AI coding agents (Cursor, Windsurf, Claude, Cline, Roo-Cline, …) can browse the GodUI catalog and install components straight into your project. Add it once, then ask for the component you want in plain language.
Installation
Use the CLI to write the config automatically, or add it Manually.
pnpm dlx @godui/cli@latest install cursorThen restart your IDE. The installer writes the GodUI server into Cursor's MCP config without touching your other servers.
The server runs locally over stdio via npx. It needs no API key or account. The CLI
installs into your editor's MCP config; with Manual you paste the block into it
yourself.
Usage
Ask your IDE to use any GodUI component:
- "Add a GodUI magic button"
- "Add a marquee of logos"
- "Add an animated gradient background"
- "Add a number ticker that counts to 1000"
The agent finds the right component, then installs it with the shadcn CLI, which copies the source into your project so you own it.
Tools
The server exposes three tools:
| Tool | What it does |
|---|---|
list_components | List the full catalog, optionally filtered by category. |
search_components | Find components by what they do (natural language). |
get_component | Fetch one component's install command and full source. |
How it works
The server fetches the live registry at https://godui.design/r, so a new
process serves the latest components. You don't need to upgrade the MCP
package when GodUI ships something new. Each process caches the catalog only for its own
lifetime and fails closed on invalid data; it does not silently fall back to a
stale catalog. Point it at a local registry for development by setting
GODUI_REGISTRY_URL:
GODUI_REGISTRY_URL=http://localhost:3000/r npx @godui/mcp@0.1.0The live endpoint always serves the latest registry, not an immutable snapshot. For reproducible installs or rollback, use a commit-addressed registry snapshot and require its source revision:
GODUI_REGISTRY_URL=https://raw.githubusercontent.com/godui-design/godui/<revision>/apps/docs/public/r \
GODUI_REGISTRY_REVISION=<revision> npx @godui/mcp@0.1.0The CLI and manual configuration pin the MCP package to 0.1.0; package
versions are never republished. Registry indexes carry the source revision
used to audit a deployment. See the MCP registry policy
for integrity, provenance, and rollback requirements.