AI Dimensie
Wave 11·Docs · part of AI Dimensie·Why Docs? →·⌘K jump

MCP server and CLI command reference for the aidimension platform.

MCP + CLI Overview

aidimension ships two developer-facing tools that wire the platform into your editor, agent, or terminal:

  1. MCP Server — exposes every aidimension resource (components, templates, skills) over the Model Context Protocol
  2. CLI — a single binary for scaffolding, installing, and managing aidimension

This page is the index. Jump to:

MCP Server — TL;DR#

# Add the aidimension MCP server to Claude Desktop
claude mcp add aidimension -- npx -y @aidimension/mcp@latest

Once added, your agent can:

  • 🔍 Search components by name, prop, or use case
  • 📋 Copy component source into your project
  • 🎨 Generate a theme from a brand description
  • 🧱 Pick the right template for a new page
  • 🧠 Install skills into the running agent

Example conversation:

You: "Build me a pricing page with a monthly/annual toggle."

Agent: (calls mcp__aidimension__pick_template → returns pricing template, then mcp__aidimension__copy_template → writes src/app/pricing/page.tsx)

→ Full MCP Server reference

CLI — TL;DR#

# Install the CLI globally
npm i -g @aidimension/cli

# Add a component to your project
aidimension add button card dialog

# Add a template
aidimension add template landing-page

# List installed components
aidimension list

# Update to latest version
aidimension update

# Open the AI builder
aidimension magic "a pricing page with 3 tiers"

→ Full CLI Commands reference

When to use which#

TaskToolWhy
Add a single componentCLIFast, copy-paste, no agent needed
Add a component from your agentMCPAgent handles imports, placement, props
Scaffold a new appCLITemplates, deps, configs in one command
Ask "which component should I use?"MCPAgent can search and reason
Bulk-update across reposCLIScriptable, no LLM round-trip
Generate UI from a sentenceMCPAgent plans + executes + verifies

How they fit together#

The CLI and MCP server share the same component registry at registry.aidimension.io. When the CLI adds a component, it uses the same JSON manifest the MCP server queries. They're two interfaces to one source of truth.

┌────────────────────────────────────────┐
│       registry.aidimension.io              │
│  (component source, schemas, examples) │
└────────────────────────────────────────┘
              ↑                ↑
              │                │
        ┌─────┴─────┐    ┌─────┴──────┐
        │   CLI     │    │    MCP     │
        │ (terminal)│    │  (agent)   │
        └───────────┘    └────────────┘

Versioning#

Both tools follow semver:

  • 0.x.y — pre-1.0, breaking changes are minor bumps
  • 1.x.y — stable, breaking changes are major bumps
  • x.y.0 — feature additions
  • x.y.z — patches and fixes

Pin your version in package.json or MCP config to avoid surprises.

Support#

Next
Introduction