# Use Cases

This document provides practical examples of how to use the Developer MCP for common Umbraco tasks. Each scenario includes example prompts that demonstrate how to accomplish real-world operations using the available MCP tools.

## Table of Contents

* [Content Management Automation](#content-management-automation)
* [Media Management](#media-management)
* [Site Structure & Configuration](#site-structure-and-configuration)
* [Development & DevOps](#development-and-devops)
* [Monitoring & Maintenance](#monitoring-and-maintenance)
* [User & Permissions Management](#user-and-permissions-management)
* [Content Analysis & Reporting](#content-analysis-and-reporting)
* [Multi-language & Localization](#multi-language-and-localization)
* [Advanced Workflows](#advanced-workflows)
* [API & Integration Use Cases](#api-and-integration-use-cases)

## Content Management Automation

1. **Bulk Content Creation**
   * Automatically create multiple documents from CSV/JSON/MD data together with the Filesystem MCP

     **Example Prompt:** "Read blog-posts.csv and create a Blog Post document for each row under /blog"

     **Required Tool Collections:** `document`, `document-type`
   * Generate landing pages from templates with dynamic content

     **Example Prompt:** "Read cities.csv and create city landing pages using the City Landing Page Document Type for each UK city"

     **Required Tool Collections:** `document`, `document-type`
   * Import product catalogs into Umbraco document structure

     **Example Prompt:** "Import the product catalog from catalog.json and create the appropriate document hierarchy"

     **Required Tool Collections:** `document`, `document-type`
   * Create multi-language content variants programmatically

     **Example Prompt:** "For all documents under /news, create German and French language variants with placeholder content"

     **Required Tool Collections:** `document`, `language`
2. **Content Migration & Synchronization**
   * Migrate content from external CMS to Umbraco

     **Example Prompt:** "Import all blog posts from the WordPress export file and create them as Blog Post documents"

     **Required Tool Collections:** `document`, `document-type`
   * Sync content between staging and production environments

     **Example Prompt:** "Compare the /products section between staging and production and show me what's different"

     **Required Tool Collections:** `document`
   * Create document blueprints from existing successful pages

     **Example Prompt:** "Analyze the top 10 performing blog posts and create blueprints based on their structure and content patterns"

     **Required Tool Collections:** `document`, `document-blueprint`
   * Copy and adapt content structures across sites

     **Example Prompt:** "Copy the entire /services structure to /solutions, but update all 'service' terminology to 'solution', fix internal links, and update the navigation metadata"

     **Required Tool Collections:** `document`
3. **Publishing Workflows**
   * Schedule bulk publishing of seasonal content

     **Example Prompt:** "Find all documents tagged 'Christmas Campaign' and publish them all at once"

     **Required Tool Collections:** `document`, `tag`
   * Publish document hierarchies with descendants

     **Example Prompt:** "Publish all pages under /summer-2025 that have a publishDate in the past and are still in draft, including all their child pages"

     **Required Tool Collections:** `document`
   * Auto-publish time-sensitive content (events, promotions)

     **Example Prompt:** "Find all Event documents where eventDate is in the next 48 hours and publish them if they're in draft"

     **Required Tool Collections:** `document`
   * Content Review Reminders: Identify stale content needing updates

     **Example Prompt:** "List all published documents that haven't been updated in over 12 months"

     **Required Tool Collections:** `document`
4. **Content Quality Validation Pipeline**
   * Run automated content checks (spell check, SEO validation, broken links)

     **Example Prompt:** "Check all Blog Post documents and report any with titles over 60 characters or missing meta descriptions"

     **Required Tool Collections:** `document`, `document-type`
   * Validate required fields and metadata completeness

     **Example Prompt:** "Audit all Product documents and show me which ones are missing required fields like price or category"

     **Required Tool Collections:** `document`, `document-type`
   * Check content against brand guidelines and style rules

     **Example Prompt:** "Find all pages where the main heading doesn't follow our title case convention"

     **Required Tool Collections:** `document`
   * Ensure all media references are valid and optimized

     **Example Prompt:** "Check all documents for broken media references and list any images over 2MB"

     **Required Tool Collections:** `document`, `media`

## Media Management

5. **Asset Management**
   * Batch upload media files from local directories

     **Example Prompt:** "Upload all images from the /downloads/product-photos folder to the Product Images media folder"

     **Required Tool Collections:** `media`, `temporary-file`
   * Organize media into folder structures programmatically

     **Example Prompt:** "Move all media items tagged 'press-kit-2024' into a new folder called Press/2024"

     **Required Tool Collections:** `media`
   * Audit and optimize media file sizes

     **Example Prompt:** "Find all images in the Team Photos folder and create a report showing their dimensions, file sizes, and which pages use them"

     **Required Tool Collections:** `media`
   * Track and audit media usage across content

     **Example Prompt:** "Show me which documents are using the hero-banner.jpg image"

     **Required Tool Collections:** `media`
   * Identify and clean up unused media assets

     **Example Prompt:** "Find all media items that aren't referenced by any published content"

     **Required Tool Collections:** `media`
6. **Media Integration**
   * Upload media from web URLs

     **Example Prompt:** "Download all the product images from these URLs and upload them to the Products media folder with appropriate naming"

     **Required Tool Collections:** `media`, `temporary-file`
   * Process and upload user-generated content

     **Example Prompt:** "Upload the submitted testimonial photos and link them to the corresponding Testimonial documents"

     **Required Tool Collections:** `media`, `temporary-file`
   * Create media with proper metadata and tags

     **Example Prompt:** "Upload these images and automatically tag them based on their filenames"

     **Required Tool Collections:** `media`
   * Manage media references and dependencies

     **Example Prompt:** "Update all references to old-logo.png to use new-logo.png instead"

     **Required Tool Collections:** `media`

## Site Structure & Configuration

7. **Document Type Management**
   * Create Document Types from JSON schemas

     **Example Prompt:** "Create a new FAQ Page Document Type with a title, rich text intro, and repeatable FAQ items block list"

     **Required Tool Collections:** `document-type`
   * Update property configurations across multiple types

     **Example Prompt:** "Add a 'Last Reviewed Date' property to all Document Types that have the SEO composition"

     **Required Tool Collections:** `document-type`
   * Manage compositions and inheritance structures

     **Example Prompt:** "Create a Social Media composition with Open Graph properties and apply it to all page types"

     **Required Tool Collections:** `document-type`
   * Generate element types for Block List/Grid configurations

     **Example Prompt:** "Create element types for Call To Action, Image Gallery, and Video blocks"

     **Required Tool Collections:** `document-type`
8. **Data Type Administration**
   * Create custom Data Types with specific property editors

     **Example Prompt:** "Create a color picker Data Type limited to our brand colors: #FF0000, #00FF00, #0000FF"

     **Required Tool Collections:** `data-type`
   * Update Data Type configurations globally

     **Example Prompt:** "Update the Rich Text Editor Data Type to enable the source code button"

     **Required Tool Collections:** `data-type`
   * Find and manage Data Type references

     **Example Prompt:** "Show me all Document Types using the 'Legacy Rich Text' Data Type"

     **Required Tool Collections:** `data-type`, `document-type`
   * Migrate between different property editor configurations

     **Example Prompt:** "Update all properties using the old Media Picker to use the new Media Picker 3"

     **Required Tool Collections:** `data-type`
   * Standardize property appearance settings

     **Example Prompt:** "Update all Rich Text Editor properties across all Document Types to use 'Label above' appearance"

     **Required Tool Collections:** `document-type`
9. **Template Management**
   * Execute template queries to test content rendering

     **Example Prompt:** "Test render the /products/widget-pro page using the Product Detail template"

     **Required Tool Collections:** `template`, `document`
   * Search and update template code

     **Example Prompt:** "Find all templates that reference the old ViewHelper and update them to use the new one"

     **Required Tool Collections:** `template`

## Development & DevOps

10. **CI/CD Integration**
    * Export/import Document Type definitions for version control

      **Example Prompt:** "Export all Document Type definitions to JSON files for commit to our repo"

      **Required Tool Collections:** `document-type`
    * Automate environment setup and configuration

      **Example Prompt:** "Set up the Document Type structure from our schema files in this fresh Umbraco instance"

      **Required Tool Collections:** `document-type`
    * Deploy content structure changes across environments

      **Example Prompt:** "Compare Document Types between dev and staging and generate a migration plan"

      **Required Tool Collections:** `document-type`
    * Validate content before deployment

      **Example Prompt:** "Check that all required Document Types exist before deploying content"

      **Required Tool Collections:** `document-type`
11. **Code Generation**
    * Trigger Models Builder to generate strongly-typed models

      **Example Prompt:** "Regenerate all ModelsBuilder models after the Document Type changes"

      **Required Tool Collections:** `models-builder`
    * Create scripts and stylesheets programmatically

      **Example Prompt:** "Create a new stylesheet called `landing-page.css` with our standard structure"

      **Required Tool Collections:** `stylesheet`, `script`
    * Generate partial views from templates

      **Example Prompt:** "Create partial views for each of our navigation components"

      **Required Tool Collections:** `partial-view`
    * Automate boilerplate code creation

      **Example Prompt:** "Generate a surface controller template for handling form submissions"

      **Required Tool Collections:** `template`

## Monitoring & Maintenance

12. **Health Monitoring**
    * Run system health checks programmatically

      **Example Prompt:** "Run all health checks and report any that are in warning or error state"

      **Required Tool Collections:** `health`
    * Monitor server status and performance

      **Example Prompt:** "Check the server status and tell me if there are any performance issues"

      **Required Tool Collections:** `server`
    * Execute remedial actions for issues

      **Example Prompt:** "If the HTTPS check fails, show me the current configuration and suggest fixes"

      **Required Tool Collections:** `health`
    * Track system diagnostics and troubleshooting data

      **Example Prompt:** "Generate a diagnostic report for our support ticket including all health check results"

      **Required Tool Collections:** `health`, `server`
13. **Log Analysis**
    * Search and filter log entries

      **Example Prompt:** "Show me all error log entries from the last 24 hours"

      **Required Tool Collections:** `log-viewer`
    * Create saved searches for common issues

      **Example Prompt:** "Create a saved search for all SQL timeout errors"

      **Required Tool Collections:** `log-viewer`
    * Monitor error patterns and trends

      **Example Prompt:** "Find the most common error messages in the past week"

      **Required Tool Collections:** `log-viewer`
    * Generate reports from log data

      **Example Prompt:** "Create a summary report of all errors grouped by message type"

      **Required Tool Collections:** `log-viewer`
14. **Search & Indexing**
    * Rebuild search indexes automatically

      **Example Prompt:** "Rebuild the external search index"

      **Required Tool Collections:** `indexer`
    * Query content using custom searchers

      **Example Prompt:** "Search for all documents containing 'sustainability' using the external index"

      **Required Tool Collections:** `searcher`
    * Monitor index status and health

      **Example Prompt:** "Check if all Examine indexes are healthy and report any issues"

      **Required Tool Collections:** `indexer`
    * Optimize search performance

      **Example Prompt:** "Show me which indexes are largest and might need optimization"

      **Required Tool Collections:** `indexer`

## User & Permissions Management

15. **User Group Administration**
    * Create and configure user groups

      **Example Prompt:** "Create a 'Content Reviewer' user group with read access to all content but no publish rights"

      **Required Tool Collections:** `user-group`
    * Audit user group configurations

      **Example Prompt:** "Show me all user groups and their permission levels"

      **Required Tool Collections:** `user-group`
    * Update user group settings

      **Example Prompt:** "Update the Marketing user group to allow access to the Media section"

      **Required Tool Collections:** `user-group`
    * Clean up unused user groups

      **Example Prompt:** "Find and delete any user groups that have no users assigned to them"

      **Required Tool Collections:** `user-group`, `user`
16. **Member Management**
    * Create member accounts programmatically

      **Example Prompt:** "Create member accounts for all email addresses in the subscribers.csv file"

      **Required Tool Collections:** `member`, `member-type`
    * Manage member groups and properties

      **Example Prompt:** "Add all members with 'premium' status to the Premium Members group"

      **Required Tool Collections:** `member`, `member-group`
    * Update member type configurations

      **Example Prompt:** "Add a 'Subscription Expiry Date' property to the Member type"

      **Required Tool Collections:** `member-type`
    * Track member engagement and access

      **Example Prompt:** "Find all members who haven't logged in for 6 months"

      **Required Tool Collections:** `member`

## Content Analysis & Reporting

17. **Content Auditing**
    * Audit content relationships and dependencies

      **Example Prompt:** "Show me all relations of type 'Related Links' for documents under /products"

      **Required Tool Collections:** `relation`, `relation-type`, `document`
    * Analyze content tree structure for impact

      **Example Prompt:** "List all descendant pages under /products/legacy so I can understand the impact of deletion"

      **Required Tool Collections:** `document`
    * Identify content without required metadata

      **Example Prompt:** "Find all published pages that are missing SEO metadata like meta descriptions or Open Graph tags"

      **Required Tool Collections:** `document`
    * Generate content dependency reports

      **Example Prompt:** "Create a report showing the content hierarchy and dependencies for the /services section"

      **Required Tool Collections:** `document`
18. **Version Control**
    * Manage document versions programmatically

      **Example Prompt:** "Show me all versions of the homepage from the last 30 days"

      **Required Tool Collections:** `document-version`
    * Rollback to previous versions

      **Example Prompt:** "Rollback the /pricing page to the version from last Friday"

      **Required Tool Collections:** `document-version`
    * Prevent cleanup of important versions

      **Example Prompt:** "Mark the current version of all legal pages as 'keep forever'"

      **Required Tool Collections:** `document-version`
    * Audit content changes over time

      **Example Prompt:** "Show me who made changes to documents under /products in the last week"

      **Required Tool Collections:** `document-version`

## Multi-language & Localization

19. **Language Management**
    * Configure languages and fallback chains

      **Example Prompt:** "Add Spanish as a new language with English as the fallback"

      **Required Tool Collections:** `language`
    * Create multi-language content variants

      **Example Prompt:** "Create French variants for all pages under /products that don't have them yet"

      **Required Tool Collections:** `document`, `language`
    * Manage dictionary items for translations

      **Example Prompt:** "Add dictionary items for all our standard UI labels with English and German translations"

      **Required Tool Collections:** `dictionary`, `language`
    * Bulk update culture-specific content

      **Example Prompt:** "Update all German content to use the formal 'Sie' instead of informal 'du'"

      **Required Tool Collections:** `document`, `language`

## Advanced Workflows

20. **Custom Webhooks**
    * Set up webhooks for content events

      **Example Prompt:** "Find the publish event, then create a webhook that posts to our Slack webhook URL whenever a page is published"

      **Required Tool Collections:** `webhook`
    * Monitor webhook execution logs

      **Example Prompt:** "Use get-all-webhook-logs to show me the last 50 webhook events and any that failed"

      **Required Tool Collections:** `webhook`
    * Integrate with external systems on content changes

      **Example Prompt:** "Use create-webhook to set up a webhook that calls <https://api.example.com/sync> when Product documents are published, triggering on the Content.Published event"

      **Required Tool Collections:** `webhook`
    * Automate notifications and integrations

      **Example Prompt:** "Create webhooks to notify our CDN purge endpoint at `https://cloudflare/` whenever content in `/news` is published"

      **Required Tool Collections:** `webhook`
21. **Redirect Management**
    * Create and manage URL redirects

      **Example Prompt:** "Create a 301 redirect from /old-services to /services"

      **Required Tool Collections:** `redirect`
    * Import bulk redirect rules

      **Example Prompt:** "Import all the redirects from redirects.csv"

      **Required Tool Collections:** `redirect`
    * Monitor redirect usage

      **Example Prompt:** "Show me which redirects have been hit in the last 30 days"

      **Required Tool Collections:** `redirect`
    * Maintain SEO during content restructuring

      **Example Prompt:** "When I move /products/widget to /solutions/widget, create the appropriate redirects"

      **Required Tool Collections:** `redirect`

## API & Integration Use Cases

22. **AI-Powered Content Management**
    * Generate content using AI and publish to Umbraco

      **Example Prompt:** "Generate product descriptions for all products missing them and save as drafts for review"

      **Required Tool Collections:** `document`
    * Automatically tag and categorize content

      **Example Prompt:** "Analyze all blog posts and suggest appropriate category tags based on content"

      **Required Tool Collections:** `document`, `tag`


---

# Agent Instructions: 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:

```
GET https://docs.umbraco.com/umbraco-in-ai/mcp/cms-developer-mcp/scenarios.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.