Available Tools
Complete reference for all 29 MCP tools provided by the ArgoCD MCP Server. Tools are organized by category.
🎯 Application Management Tools
Tools for managing ArgoCD application lifecycle.
| Tool | Description | Write Access |
|---|---|---|
list_applications | List all applications in a cluster | No ✅ |
get_application_details | Get detailed application information | No ✅ |
create_application | Create a new ArgoCD application | Yes ✋ |
update_application | Update application configuration | Yes ✋ |
delete_application | Delete an ArgoCD application | Yes ✋ |
validate_application_config | Validate application configuration | No ✅ |
get_application_events | Get Kubernetes events for application | No ✅ |
list_applications
List all applications across clusters with health and sync status.
"List all applications in the production cluster"
"Show me applications in the staging namespace"
get_application_details
Get comprehensive application information including resource breakdown.
"Get details for the payment-service application"
"Show me the status of my-app in production"
create_application
Create a new ArgoCD application from a Git repository.
"Create an application for my-app from the main branch"
"Deploy a new application from https://github.com/myorg/myrepo"
validate_application_config
Validate application configuration before deployment.
"Validate this application configuration"
"Check if my app config is correct before deploying"
🚀 Deployment & Operations Tools
Tools for deploying, syncing, and managing application operations.
| Tool | Description | Write Access |
|---|---|---|
sync_application | Sync application to desired state | Yes ✋ (dry-run: No) |
get_application_diff | Preview changes before deployment | No ✅ |
get_sync_status | Get current sync operation status | No ✅ |
rollback_application | Rollback to previous revision | Yes ✋ |
rollback_to_revision | Rollback to specific revision | Yes ✋ |
get_application_logs | Get logs with error detection | No ✅ |
prune_resources | Remove orphaned resources | Yes ✋ |
hard_refresh | Force refresh application state | Yes ✋ |
soft_refresh | Soft refresh application state | Yes ✋ |
cancel_deployment | Cancel ongoing sync operation | Yes ✋ |
sync_application
Sync application to desired state with optional dry-run.
"Sync the frontend application to production"
"Deploy my-app with dry-run to preview changes"
Parameters:
app_name- Application namerevision- Target revision (optional)dry_run- Preview only without applying (optional)prune- Remove orphaned resources (optional)
get_application_diff
Preview what changes will be applied before deployment.
"Show me what will change if I deploy my-app"
"Get the diff for the payment-service deployment"
rollback_application
Rollback to the previous revision.
"Rollback my-app to the previous version"
"Revert the last deployment of payment-service"
rollback_to_revision
Rollback to a specific revision number.
"Rollback my-app to revision 5"
"Revert to the deployment from 2 hours ago"
get_application_logs
Get application logs with automatic error detection.
"Show me logs for payment-service"
"Get error logs from my-app"
📦 Repository Management Tools
Tools for managing Git repositories in ArgoCD.
| Tool | Description | Write Access |
|---|---|---|
onboard_repository_https | Onboard repository via HTTPS | Yes ✋ |
onboard_repository_ssh | Onboard repository via SSH | Yes ✋ |
list_repositories | List all registered repositories | No ✅ |
get_repository | Get repository details | No ✅ |
validate_repository_connection | Validate repository connectivity | No ✅ |
delete_repository | Delete a repository from ArgoCD | Yes ✋ |
generate_repository_secret_manifest | Generate K8s secret YAML | No ✅ |
onboard_repository_https
Onboard a GitHub repository using HTTPS authentication.
"Onboard https://github.com/myorg/myapp to ArgoCD"
"Add my GitHub repository using HTTPS"
Requires: GIT_PASSWORD environment variable set
onboard_repository_ssh
Onboard a GitHub repository using SSH authentication.
"Onboard git@github.com:myorg/myapp.git using SSH"
"Add my repository with SSH key authentication"
Requires: SSH_PRIVATE_KEY_PATH environment variable set
validate_repository_connection
Test repository connectivity before onboarding.
"Check if ArgoCD can connect to my repository"
"Validate the GitHub connection"
generate_repository_secret_manifest
Generate Kubernetes secret YAML for disaster recovery.
"Generate a secret manifest for my repository credentials"
🏢 Project Management Tools
Tools for managing ArgoCD projects (multi-tenancy).
| Tool | Description | Write Access |
|---|---|---|
create_project | Create ArgoCD project with RBAC | Yes ✋ |
list_projects | List all ArgoCD projects | No ✅ |
get_project | Get project details | No ✅ |
delete_project | Delete an ArgoCD project | Yes ✋ |
generate_project_manifest | Generate AppProject YAML | No ✅ |
create_project
Create an ArgoCD project with RBAC policies.
"Create a project for the payments team"
"Set up a new project with namespace restrictions"
Features:
- Define source repository patterns (wildcards supported)
- Configure destination clusters and namespaces
- Whitelist/blacklist cluster resources
generate_project_manifest
Generate AppProject YAML manifest for GitOps.
"Generate a project manifest for version control"
Tool Availability Summary
| Category | Total Tools | Read-Only | Write Required |
|---|---|---|---|
| Application Management | 7 | 4 | 3 |
| Deployment & Operations | 10 | 3 | 7 |
| Repository Management | 7 | 4 | 3 |
| Project Management | 5 | 3 | 2 |
| Total | 29 | 14 | 15 |
Legend:
- ✅ = Available in read-only mode (
MCP_ALLOW_WRITE=false) - ✋ = Requires
MCP_ALLOW_WRITE=true
Next Steps
- 📁 Resources and Prompts - MCP resources and prompts
- 📖 Examples - Usage patterns and workflows