Use Cases and Scenarios
Common useful scenarios for the developer MCP
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
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-typeGenerate 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-typeImport 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-typeCreate 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
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-typeSync 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:
documentCreate 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-blueprintCopy 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
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,tagPublish 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:
documentAuto-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:
documentContent 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
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-typeValidate 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-typeCheck 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:
documentEnsure 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
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-fileOrganize 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:
mediaAudit 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:
mediaTrack and audit media usage across content
Example Prompt: "Show me which documents are using the hero-banner.jpg image"
Required Tool Collections:
mediaIdentify and clean up unused media assets
Example Prompt: "Find all media items that aren't referenced by any published content"
Required Tool Collections:
media
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-fileProcess 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-fileCreate media with proper metadata and tags
Example Prompt: "Upload these images and automatically tag them based on their filenames"
Required Tool Collections:
mediaManage 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
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-typeUpdate 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-typeManage 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-typeGenerate 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
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-typeUpdate Data Type configurations globally
Example Prompt: "Update the Rich Text Editor Data Type to enable the source code button"
Required Tool Collections:
data-typeFind 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-typeMigrate 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-typeStandardize 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
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,documentSearch 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
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-typeAutomate 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-typeDeploy content structure changes across environments
Example Prompt: "Compare Document Types between dev and staging and generate a migration plan"
Required Tool Collections:
document-typeValidate content before deployment
Example Prompt: "Check that all required Document Types exist before deploying content"
Required Tool Collections:
document-type
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-builderCreate scripts and stylesheets programmatically
Example Prompt: "Create a new stylesheet called
landing-page.csswith our standard structure"Required Tool Collections:
stylesheet,scriptGenerate partial views from templates
Example Prompt: "Create partial views for each of our navigation components"
Required Tool Collections:
partial-viewAutomate boilerplate code creation
Example Prompt: "Generate a surface controller template for handling form submissions"
Required Tool Collections:
template
Monitoring & Maintenance
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:
healthMonitor server status and performance
Example Prompt: "Check the server status and tell me if there are any performance issues"
Required Tool Collections:
serverExecute remedial actions for issues
Example Prompt: "If the HTTPS check fails, show me the current configuration and suggest fixes"
Required Tool Collections:
healthTrack 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
Log Analysis
Search and filter log entries
Example Prompt: "Show me all error log entries from the last 24 hours"
Required Tool Collections:
log-viewerCreate saved searches for common issues
Example Prompt: "Create a saved search for all SQL timeout errors"
Required Tool Collections:
log-viewerMonitor error patterns and trends
Example Prompt: "Find the most common error messages in the past week"
Required Tool Collections:
log-viewerGenerate reports from log data
Example Prompt: "Create a summary report of all errors grouped by message type"
Required Tool Collections:
log-viewer
Search & Indexing
Rebuild search indexes automatically
Example Prompt: "Rebuild the external search index"
Required Tool Collections:
indexerQuery content using custom searchers
Example Prompt: "Search for all documents containing 'sustainability' using the external index"
Required Tool Collections:
searcherMonitor index status and health
Example Prompt: "Check if all Examine indexes are healthy and report any issues"
Required Tool Collections:
indexerOptimize search performance
Example Prompt: "Show me which indexes are largest and might need optimization"
Required Tool Collections:
indexer
User & Permissions Management
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-groupAudit user group configurations
Example Prompt: "Show me all user groups and their permission levels"
Required Tool Collections:
user-groupUpdate user group settings
Example Prompt: "Update the Marketing user group to allow access to the Media section"
Required Tool Collections:
user-groupClean 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
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-typeManage member groups and properties
Example Prompt: "Add all members with 'premium' status to the Premium Members group"
Required Tool Collections:
member,member-groupUpdate member type configurations
Example Prompt: "Add a 'Subscription Expiry Date' property to the Member type"
Required Tool Collections:
member-typeTrack member engagement and access
Example Prompt: "Find all members who haven't logged in for 6 months"
Required Tool Collections:
member
Content Analysis & Reporting
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,documentAnalyze 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:
documentIdentify 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:
documentGenerate content dependency reports
Example Prompt: "Create a report showing the content hierarchy and dependencies for the /services section"
Required Tool Collections:
document
Version Control
Manage document versions programmatically
Example Prompt: "Show me all versions of the homepage from the last 30 days"
Required Tool Collections:
document-versionRollback to previous versions
Example Prompt: "Rollback the /pricing page to the version from last Friday"
Required Tool Collections:
document-versionPrevent cleanup of important versions
Example Prompt: "Mark the current version of all legal pages as 'keep forever'"
Required Tool Collections:
document-versionAudit 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
Language Management
Configure languages and fallback chains
Example Prompt: "Add Spanish as a new language with English as the fallback"
Required Tool Collections:
languageCreate multi-language content variants
Example Prompt: "Create French variants for all pages under /products that don't have them yet"
Required Tool Collections:
document,languageManage dictionary items for translations
Example Prompt: "Add dictionary items for all our standard UI labels with English and German translations"
Required Tool Collections:
dictionary,languageBulk 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
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:
webhookMonitor 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:
webhookIntegrate 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:
webhookAutomate notifications and integrations
Example Prompt: "Create webhooks to notify our CDN purge at
https://cloudflare/something endpoint whenever content in /news is published"Required Tool Collections:
webhook
Redirect Management
Create and manage URL redirects
Example Prompt: "Create a 301 redirect from /old-services to /services"
Required Tool Collections:
redirectImport bulk redirect rules
Example Prompt: "Import all the redirects from redirects.csv"
Required Tool Collections:
redirectMonitor redirect usage
Example Prompt: "Show me which redirects have been hit in the last 30 days"
Required Tool Collections:
redirectMaintain 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
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:
documentAutomatically tag and categorize content
Example Prompt: "Analyze all blog posts and suggest appropriate category tags based on content"
Required Tool Collections:
document,tag
Last updated
Was this helpful?