Umbraco MCP Server — CLI Guide

This MCP server runs as a CLI tool. The CLI handles authentication and configuration, then exposes tools that talk directly to the Umbraco Management API.

Detecting the CLI Command

Determine the CLI command in a single check:

# One command to detect context — check for local build AND .env together
ls dist/index.js .env 2>/dev/null

• If dist/index.js exists: use node dist/index.js
• Otherwise: use npx @umbraco-cms/mcp-dev@latest

All examples below use <cli> as a placeholder — substitute the correct command.

Quick Reference