By umbraco
Skills for building Umbraco MCP servers - tool creation, testing, API patterns, and eval testing
npx claudepluginhub umbraco/umbraco-mcp-base --plugin umbraco-mcp-skillsUse this agent to create eval/acceptance tests that validate MCP tools using an LLM agent. Creates tests that measure how well an LLM can use your tools correctly.
Use this agent to create integration tests for MCP tools. Creates one test file per tool using snapshot testing for success cases and assertion testing for errors. Compiles and runs each file before creating the next.
QA agent that validates integration tests after creation. Reviews snapshot testing, file structure, builder/helper patterns, and one-file-per-tool compliance. Use after creating tests with integration-test-creator.
Use this agent when you need to create new MCP tools. This agent handles tool design, implementation following toolkit patterns, and integration with the Orval-generated API client.
Use this agent to write or improve tool descriptions for MCP tools. Creates clear, actionable descriptions that serve as mini-prompts for AI assistants.
Reviews MCP tools for LLM-readiness. Checks schema simplification, descriptions, response shaping, pagination, and anti-patterns. Use after creating tools with mcp-tool-creator.
Use this agent to create test builders and helpers for MCP tools. Creates fluent builder classes and helper classes in __tests__/helpers/. Compiles and tests each file before creating the next. Use when setting up test infrastructure for a new collection.
Add or update an LLM eval test for a specific tool or collection. Creates a new eval scenario or updates an existing one to cover new tools. Use when adding eval coverage for new or modified tools.
Add an integration test for a specific tool in an existing collection. Creates a test file following the collection's established patterns. Use when adding tests for new or modified tools, or re-creating deleted tests.
Add a new tool to an existing MCP collection. Creates the tool file, updates the collection index, optionally adds integration tests and eval tests. Use when adding new API endpoints to collections already created by '/build-tools'.
Build LLM eval tests for MCP tool collections. Reads .discover.json and creates eval setup and scenario test files per collection. Use after running '/build-tools'.
Build integration tests for MCP tool collections. Reads .discover.json and creates test setup, builders, helpers, and test files per collection. Use after running '/build-tools'.
Build MCP tool collections from discovered API groups. Reads .discover.json and generates tools and collection registrations. Use after running 'npx @umbraco-cms/create-umbraco-mcp-server discover'.
Count MCP tools in an SDK-based project and analyze implementation gaps against .discover.json. Use when the user asks about tool counts, progress, or collection coverage.
Advisory skill for reflecting on and improving an MCP server — trace analysis, chained tool design, and behavioral coverage review.
Load MCP development patterns and best practices for building tools with the @umbraco-cms/mcp-server-sdk. Use when starting tool development or needing pattern reference.
Load MCP eval testing patterns using @umbraco-cms/mcp-server-sdk/evals. Use when writing LLM-based acceptance tests for MCP tools.
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 the full test suite.
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 status.
This monorepo contains the Umbraco MCP (Model Context Protocol) Server SDK for building MCP servers that expose Umbraco APIs to AI assistants.
The core SDK package providing:
Install from npm:
npm install @umbraco-cms/mcp-server-sdk
CLI tool for scaffolding, configuring, and discovering APIs for new MCP server projects. Covers the first three phases of the development workflow:
npx @umbraco-cms/create-umbraco-mcp-server my-mcp-server
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:
npm install @umbraco-cms/mcp-hosted
Skills and agents for building Umbraco MCP servers in Claude Code. Covers Phases 4-5 of the development workflow — tool implementation, testing, and LLM evaluation.
The starter kit bundled by @umbraco-cms/create-umbraco-mcp-server. Pre-configured with the SDK, example tools, tests, and Orval integration.
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 for all five phases.
# Install dependencies
npm install
# Build the SDK
npm run build
# Run tests
npm run test
This SDK is designed for:
Umbraco Add-on Developers - Creating MCP extensions for:
External Developers - Building MCP servers for:
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)
│ ├── skills/ # /build-tools, /build-evals, /mcp-patterns, etc.
│ └── agents/ # mcp-tool-creator, mcp-tool-reviewer, etc.
│
├── template/ # Starter kit bundled by create-mcp-server
│ ├── src/
│ │ └── tools/
│ ├── __tests__/
│ └── package.json
│
└── package.json # Monorepo root
MIT
Comprehensive .NET development skills for modern C#, ASP.NET, MAUI, Blazor, Aspire, EF Core, Native AOT, testing, security, performance optimization, CI/CD, and cloud-native applications
Uses power tools
Uses Bash, Write, or Edit tools
Unity Development Toolkit - Expert agents for scripting/refactoring/optimization, script templates, and Agent Skills for Unity C# development
Complete collection of battle-tested Claude Code configs from an Anthropic hackathon winner - agents, skills, hooks, rules, and legacy command shims evolved over 10+ months of intensive daily use
Complete collection of battle-tested Claude Code configs agents, skills, hooks, rules, and legacy command shims evolved over 10+ months of intensive daily use
Complete collection of battle-tested Claude Code configs from an Anthropic hackathon winner - agents, skills, hooks, and rules evolved over 10+ months of intensive daily use
Complete creative writing suite with 10 specialized agents covering the full writing process: research gathering, character development, story architecture, world-building, dialogue coaching, editing/review, outlining, content strategy, believability auditing, and prose style/voice analysis. Includes genre-specific guides, templates, and quality checklists.