MCP Server SDK

Overview of the MCP Server SDK package for building MCP servers that expose Umbraco APIs to AI assistants.

The @umbraco-cms/mcp-server-sdk package provides infrastructure for building Model Context Protocol (MCP) servers that expose Umbraco APIs to AI assistants. The SDK handles tool registration, API communication, error handling, configuration loading, tool filtering, and MCP chaining.

Getting Started

Create a new MCP server project with the Create Umbraco MCP Server CLI. The project template includes this SDK and configures it for you.

Documentation

Guide	Description
Tool Authoring	How the system works, adding collections and tools, examples
API Helpers	API call helpers, HTTP client, ProblemDetails handling
Tool Filtering	Modes, slices, collections, configuration flow
MCP Chaining	Proxying, delegation, and composite tool patterns
Configuration	Server config, env vars, CLI flags, custom fields
Constants	Well-known Umbraco IDs reference
Testing and Evals	Unit testing, snapshot helpers, LLM eval framework
Coverage Tracking	Count tools and catalog ignored endpoints