Skip to content

Documentation

MCP server

Coding agents search the live registry, fetch source, and — on a local project — compose, add pages, install, theme, and upgrade. Listed as io.github.pedrogbraz/cronus-ui on the official MCP Registry. Two transports: hosted HTTP for cloud builders, stdio for IDEs that can spawn a process.

Official MCP Registry

Name: io.github.pedrogbraz/cronus-ui. Clients that browse the registry get stdio (npx -y cronus-ui-mcp) and the hosted remote at https://aicronus.com/mcp.

Pick a transport

The hosted server is the same catalog as stdio. It cannot write files — there is no project on the other side of a URL.

Hosted Streamable HTTP versus local stdio.
TransportConnect withToolsUse when
Streamable HTTPhttps://aicronus.com/mcpRead-only catalogv0, Lovable, Replit, Bolt, Base44, or any client that takes a URL
stdionpx -y cronus-ui-mcpRead + writeClaude Code, Cursor, VS Code, Codex, Grok CLI, OpenCode, Zed

Greenfield is not an MCP tool

Scaffold with npx create-cronus-app my-app --template saas, then point the stdio server at that project. Write tools spawn the pinned cronus-ui CLI inside an already-inited app.

Hosted HTTP

Paste the URL into any client that speaks Streamable HTTP. No API key. This preview also serves the same handler at /mcp.

Custom MCP / Connectors

bash
https://aicronus.com/mcp

Paste the URL. No API key. Catalog only — install still happens in a local repo via the CLI.

A GET without the SSE Accept header returns a small JSON discovery document:

bash
curl -s https://aicronus.com/mcp

Local stdio

Full surface: search, install, compose, add-page, theme, upgrade. The process runs on your machine, so it can write the project.

One command writes every project file. Restart the agent afterwards.

bash
npx cronus-ui mcp init

terminal

bash
claude mcp add cronus-ui -- npx -y cronus-ui-mcp

Project scope: the same JSON in `.mcp.json` at the repo root.

Conductor and Kilo Code inherit the agent they wrap. A repo-root .mcp.json (stdio JSON above, the shape create-cronus-app already writes) is enough for Conductor Claude sessions. Kilo takes the same command + args as Cursor.

Which client

Config file and transport for each host. VS Code is the one that does not use mcpServers.

MCP-capable clients and how they connect to Cronus UI.
ClientTransportConfigNotes
Claude Codebothclaude mcp add / .mcp.jsonnpx cronus-ui mcp init writes .mcp.json (stdio).
Cursorboth~/.cursor/mcp.json or .cursor/mcp.jsonRoot key is mcpServers.
Windsurfboth~/.codeium/windsurf/mcp_config.jsonSame mcpServers JSON as Cursor.
VS Code / GitHub Copilotboth.vscode/mcp.jsonRoot key is servers, not mcpServers.
Codexboth~/.codex/config.tomlcodex mcp add cronus-ui -- npx -y cronus-ui-mcp.
Grok CLIboth~/.grok/config.tomlgrok mcp add. Also reads .mcp.json / .cursor/mcp.json.
OpenCodebothopencode.jsonRoot key is mcp; command is a single array.
Zedstdiosettings.json → context_serversZed calls MCP servers context servers.
Antigravitystdio~/.gemini/config/mcp_config.jsonShared with Antigravity IDE and CLI. mcpServers JSON.
Kilo Codestdiokilo.json / .kilocode/Local stdio. Same command + args as Cursor.
Conductorstdioinherits Claude Code / Codex / Cursor.mcp.json in the repo is enough for Claude sessions.
v0 / Lovable / Replit / Bolt / Base44httpCustom MCP URL fieldPaste https://aicronus.com/mcp. Read-only catalog — no local CLI.

Tools

Hosted HTTP exposes the read list. stdio adds the write list, which spawns cronus-ui@pinned inside the detected project root.

Read

  • list_components
  • list_blocks
  • list_catalog
  • match_catalog
  • search_registry
  • get_component
  • get_install_command
  • get_design_context

Write (stdio only)

  • compose_app
  • add_page
  • set_theme
  • install_component
  • upgrade_components
  • apply_theme