Resources and Prompts
The ArgoCD MCP Server provides MCP Resources for real-time data streams and Prompts for guided workflows.
📁 Available Resources
Resources provide real-time data streams that can be monitored by AI agents.
| Resource URI | Description | Update Frequency |
|---|---|---|
argocd://applications/[cluster] | List all applications and their state | Every 5 seconds |
argocd://application-metrics/[cluster]/[app] | Real-time application metrics | Every 10 seconds |
argocd://sync-operations/[cluster] | Active sync operations | Every 2 seconds |
argocd://deployment-events/[cluster] | Deployment event stream | Real-time |
argocd://cluster-health/[cluster] | Overall cluster health | Every 30 seconds |
argocd://applications/[cluster]
List all applications in a cluster with health and sync status.
URI Example: argocd://applications/production
Returns:
- Application names
- Health status (Healthy, Degraded, Progressing)
- Sync status (Synced, OutOfSync)
- Last sync time
- Target revision
argocd://application-metrics/[cluster]/[app]
Get real-time metrics for a specific application.
URI Example: argocd://application-metrics/production/payment-service
Returns:
- Pod count and status
- Resource utilization
- Replica health
- Sync duration
argocd://sync-operations/[cluster]
Monitor active sync operations across the cluster.
URI Example: argocd://sync-operations/production
Returns:
- Active syncs
- Sync phase
- Progress percentage
- Resource changes
Use Case:
"Monitor the sync operation for my-app in production cluster"
argocd://deployment-events/[cluster]
Real-time stream of deployment events.
URI Example: argocd://deployment-events/production
Returns:
- Event type
- Application affected
- Timestamp
- Event details
argocd://cluster-health/[cluster]
Overall cluster health overview.
URI Example: argocd://cluster-health/production
Returns:
- Total applications
- Healthy count
- Degraded count
- Out-of-sync count
💬 Available Prompts
Prompts are guided workflows that orchestrate multiple tools to accomplish complex tasks.
| Prompt | Description | Tools Used |
|---|---|---|
onboard_github_repository | Step-by-step repository onboarding | 4 tools |
full_application_deployment | End-to-end deployment workflow | 11 tools |
debug_application_issues | Comprehensive troubleshooting | 5 tools |
rollback_decision | Guided rollback with impact analysis | 8 tools |
setup_argocd_project | Multi-tenancy project setup | 4 tools |
deploy_new_version | Guided deployment workflow | 7 tools |
post_deployment_validation | Comprehensive health check | 4 tools |
onboard_github_repository
Step-by-step GitHub repository onboarding workflow.
Workflow:
- Check environment credentials
- Validate repository connection
- Onboard to ArgoCD
- Verify registration
Use Case:
"Help me onboard my GitHub repository https://github.com/myorg/myapp"
full_application_deployment
Complete end-to-end deployment from repository to running application.
Workflow:
- Onboard repository (if needed)
- Create ArgoCD application
- Show deployment preview
- Execute deployment
- Monitor progress
- Validate success
Use Case:
"Deploy my application from https://github.com/myorg/myapp to production cluster"
Time Estimate: ~1-2 minutes
debug_application_issues
Comprehensive troubleshooting workflow with automatic error detection.
Workflow:
- Analyze application status
- Detect errors in logs
- Review Kubernetes events
- Identify root cause
- Provide recommendations
Use Case:
"My app 'payment-service' is not working in production, help me debug it"
Time Estimate: ~15 seconds (fully automated)
rollback_decision
Guided rollback with history and impact preview.
Workflow:
- Show deployment history
- Preview rollback changes
- Execute rollback
- Validate recovery
Use Case:
"URGENT: Latest deployment of checkout-service is broken, rollback immediately!"
Time Estimate: ~1 minute
setup_argocd_project
Multi-tenancy project configuration assistant.
Workflow:
- Gather project requirements
- Configure RBAC policies
- Create project
- Verify setup
- Generate manifests
Use Case:
"Set up a new ArgoCD project for the payments team"
deploy_new_version
Guided workflow for deploying a new version.
Workflow:
- Validate configuration
- Show deployment diff
- Execute sync
- Monitor progress
- Validate deployment
Use Case:
"Deploy version 2.0.0 of my-app to production"
post_deployment_validation
Comprehensive post-deployment health check.
Workflow:
- Check sync status
- Validate configuration
- Analyze logs for errors
- Get health metrics
Use Case:
"Validate that my deployment was successful"
Using Resources and Prompts
Accessing Resources
Resources are accessed via the MCP protocol using their URI:
Client: Monitor the production cluster health
Agent: [Subscribes to argocd://cluster-health/production]
[Provides real-time health updates]
Using Prompts
Prompts are invoked to guide complex multi-step operations:
Client: Deploy my application from GitHub to production
Agent: [Invokes full_application_deployment prompt]
[Orchestrates 11 tools in sequence]
[Provides step-by-step progress updates]
Next Steps
- 📖 Examples - Usage patterns and workflows
- 🛠️ Tools - Available MCP tools reference
- ⚙️ Configuration - Server configuration