umbraco/Umbraco-MCP-Base

Latest recorded source activity: October 20, 2026 at 11:05

SkillsMP catalog refreshed: October 29, 2026 at 18:30

skills collected: 15

GitHub stars: 2
GitHub forks: 3

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/umbraco/Umbraco-MCP-Base.

Repository README

Repository README source: README.md

Read the source README

Expand full README

# Umbraco MCP Server SDK This monorepo contains the Umbraco MCP (Model Context Protocol) Server SDK for building MCP servers that expose Umbraco APIs to AI assistants. ## Packages ### [@umbraco-cms/mcp-server-sdk](./packages/mcp-server-sdk) The core SDK package providing: - Tool result formatting and error handling (ProblemDetails aware) - Structured content helpers with type safety - Tool decorators (error handling, validation, composition) - Configuration loading (modes, slices, collections) - Testing infrastructure (snapshot normalization, test environment setup) - Eval testing framework (LLM-based acceptance tests using Claude Agent SDK) **Install from npm:** ```bash npm install @umbraco-cms/mcp-server-sdk ``` ### [@umbraco-cms/create-umbraco-mcp-server](./packages/create-mcp-server) CLI tool for scaffolding, configuring, and discovering APIs for new MCP server projects. Covers the first three phases of the [development workflow](./packages/create-mcp-server/README.md): 1. **Create** — scaffold a new project 2. **Init** — configure Umbraco instance and features 3. **Discover** — analyze APIs and plan tool collections ```bash npx @umbraco-cms/create-umbraco-mcp-server my-mcp-server ``` ### [@umbraco-cms/mcp-hosted](./packages/hosted-mcp) Building blocks for deploying Umbraco MCP servers to Cloudflare Workers with OAuth authentication and Streamable HTTP transport. Provides consent-screen tool selection, three-tier configuration, and multi-site deployments. **Install from npm:** ```bash npm install @umbraco-cms/mcp-hosted ``` ### [Claude Code Plugin](./plugins) Skills and agents for building Umbraco MCP servers in Claude Code. Covers Phases 4-5 of the [development workflow](./packages/create-mcp-server/README.md) — tool implementation, testing, and LLM evaluation. ### [Template](./template) The starter kit bundled by `@umbraco-cms/create-umbraco-mcp-server`. Pre-configured with the SDK, example tools, tests, and Orval integration. ## Getting Started ### Create a New MCP Server ```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 full [development workflow documentation](./packages/create-mcp-server/README.md) for all five phases. ### Building the SDK ```bash # Install dependencies npm install # Build the SDK npm run build # Run tests npm run test ``` ## Who Is This For? This SDK is designed for: 1. **Umbraco Add-on Developers** - Creating MCP extensions for: - Umbraco Commerce - Umbraco Forms - Umbraco Deploy - Custom packages 2. **External Developers** - Building MCP servers for: - Custom Umbraco APIs - Third-party integrations - Private Umbraco installations ## Architecture ``` Umbraco-MCP-Base/ ├── packages/ │ ├── mcp-server-sdk/ # @umbraco-cms/mcp-server-sdk (npm package) │ │ ├── src/ │ │ │ ├── helpers/ # Tool result, API call, decorators │ │ │ ├── config/ # Collection/slice/mode configuration │ │ │ ├── testing/ # Snapshot normalization, test setup │ │ │ ├── evals/ # LLM-based acceptance testing │ │ │ └── types/ # Tool and collection types │ │ └── package.json │ │ │ ├── hosted-mcp/ # @umbraco-cms/mcp-hosted (npm package) │ │ ├── src/ │ │ │ ├── auth/ # OAuth flow, consent screen │ │ │ ├── server/ # Per-request server, worker entry helpers │ │ │ ├── config/ # Worker env config loader │ │ │ └── http/ # Fetch-based API client for Workers │ │ └── docs/ # Setup, deployment, architecture docs │ │ │ └── create-mcp-server/ # @umbraco-cms/create-umbraco-mcp-server CLI (npm package) │ └── src/ │ ├── scaffold.ts # Phase 1: project scaffolding │ ├── init/ # Phase 2: instance setup, feature config │ └── discover/ # Phase 3: API discovery, client generation │ ├── plugins/ # Claude Code skills & agents (not published) │ └── umbraco-mcp-skills/ │ ├── skills/ # /build-tools, /build-evals, /mcp-patterns, etc. │ └── agents/ # mcp-tool-creator, mcp-tool-reviewer, etc. │ ├── plugins-server/ # Claude Code plugin for MCP server CLI operation │ └── umbraco-mcp-server/ │ └── skills/ # /mcp-cli, etc. │ ├── template/ # Starter kit bundled by create-mcp-server │ ├── src/ │ │ └── tools/ │ ├── __tests__/ │ └── package.json │ └── package.json # Monorepo root ``` ## License MIT

Loading the repository README…

Skills in this repository

Run Playwright E2E tests for the hosted MCP Cloudflare Worker. Use this skill when the user says /run-e2e, "run e2e tests", "run the e2e", "run playwright tests", or wants to test the hosted worker end-to-end. Handles starting Umbraco, building, and running…

2026-04-28

update-ignored-endpoints

Software Developers

Update the IGNORED_ENDPOINTS.md documentation file with current endpoint coverage analysis. Discovers all generated API client files and compares against implemented MCP tools. Use when documentation needs to be refreshed or when verifying ignored endpoint…

2026-04-28

Showing 15 of 15 collected skills.