> For the complete documentation index, see [llms.txt](https://docs.umbraco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.umbraco.com/umbraco-in-ai/17.latest/mcp/base-mcp/create-umbraco-mcp-server.md).

# Create Umbraco MCP Server

The `@umbraco-cms/create-umbraco-mcp-server` package provides a CLI toolkit and Claude Code plugin for building custom MCP servers on top of Umbraco. The toolkit takes you from an empty directory to a tested, production-ready MCP server through a five-phase workflow.

## What it includes

The package has three components:

* [**Project template**](/umbraco-in-ai/17.latest/mcp/base-mcp/create-umbraco-mcp-server/project-template.md) — A ready-to-go MCP server project with tool collections, API client generation, testing infrastructure, and optional features like MCP chaining.
* [**CLI toolkit**](/umbraco-in-ai/17.latest/mcp/base-mcp/create-umbraco-mcp-server/development-workflow.md) — Creates a new project, configures your Umbraco connection, and discovers API endpoints.
* [**Claude Code plugin**](/umbraco-in-ai/17.latest/mcp/base-mcp/create-umbraco-mcp-server/claude-code-plugin.md) — Skills and agents that automate tool creation, test generation, and Agent evaluation inside Claude Code.

## Prerequisites

Before starting, ensure the following are installed:

* **Node.js 22+**
* **.NET SDK** — Required for creating Umbraco instances
* **SQL Server** — Required for the Umbraco instance database, SQLite is not suitable for integration tests
* **Claude Code** — Required for tool building and evaluation (Phases 4-5)

## Getting Started

Create a new project and run the init wizard:

```bash
npx @umbraco-cms/create-umbraco-mcp-server my-mcp-server
cd my-mcp-server
npm install
npx @umbraco-cms/create-umbraco-mcp-server init
```

See the [development workflow](/umbraco-in-ai/17.latest/mcp/base-mcp/create-umbraco-mcp-server/development-workflow.md) for the complete walkthrough.

## Five-Phase Workflow

The [development workflow](/umbraco-in-ai/17.latest/mcp/base-mcp/create-umbraco-mcp-server/development-workflow.md) guides you through building a custom MCP server:

### CLI Phases

| Phase       | Command                                                | What happens                               |
| ----------- | ------------------------------------------------------ | ------------------------------------------ |
| 1. Create   | `npx @umbraco-cms/create-umbraco-mcp-server my-server` | Creates the project                        |
| 2. Init     | `npx @umbraco-cms/create-umbraco-mcp-server init`      | Configures the instance and trims features |
| 3. Discover | `npx @umbraco-cms/create-umbraco-mcp-server discover`  | Analyzes APIs and plans tool collections   |

### Claude Code Plugin Phases

After Phase 3, install the [Claude Code plugin](/umbraco-in-ai/17.latest/mcp/base-mcp/create-umbraco-mcp-server/claude-code-plugin.md) to automate the remaining phases:

```
/plugin marketplace add umbraco/Umbraco-MCP-Base
/plugin install umbraco-mcp-skills@umbraco-mcp-server-sdk-plugins
```

| Phase       | Command                                 | What happens                              |
| ----------- | --------------------------------------- | ----------------------------------------- |
| 4. Build    | `/build-tools` and `/build-tools-tests` | Generates tools and tests via Claude Code |
| 5. Evaluate | `/build-evals` and `npm run test:evals` | Runs LLM eval tests and iterates          |

## Learn more

* [Project Template](/umbraco-in-ai/17.latest/mcp/base-mcp/create-umbraco-mcp-server/project-template.md) — Structure, configuration, registries, and conventions of the generated project
* [Development Workflow](/umbraco-in-ai/17.latest/mcp/base-mcp/create-umbraco-mcp-server/development-workflow.md) — Detailed five-phase guide from scaffolding to evaluation
* [Testing Your MCP Server](/umbraco-in-ai/17.latest/mcp/base-mcp/create-umbraco-mcp-server/testing-your-mcp-server.md) — Run the scaffolded server in Claude Code via `.mcp.json` and iterate on tools
* [Claude Code Plugin](/umbraco-in-ai/17.latest/mcp/base-mcp/create-umbraco-mcp-server/claude-code-plugin.md) — Skills and agents for automated tool building and testing


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.umbraco.com/umbraco-in-ai/17.latest/mcp/base-mcp/create-umbraco-mcp-server.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.