@godrix/argocd-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ARGOCD_URL | No | Argo CD base URL for single instance mode | |
| ARGOCD_TOKEN | No | Alias for ARGOCD_API_KEY | |
| ARGOCD_CONFIG | No | Path to argocd CLI config (default: ~/.config/argocd/config) | /root/.config/argocd/config |
| ARGOCD_API_KEY | No | Bearer token for default profile or single instance | |
| ARGOCD_API_KEYS | No | Comma-separated API keys (same order as ARGOCD_PROFILES) | |
| ARGOCD_GRPC_WEB | No | Pass --grpc-web to argocd login (default: true) | true |
| ARGOCD_PROFILES | No | Comma-separated profile names for multi-environment mode | |
| ARGOCD_READ_ONLY | No | Block sync and other mutations (default: true) | true |
| ARGOCD_URL_PROFILES | No | Comma-separated URLs (same order as profiles) for multi-environment mode | |
| ARGOCD_ALLOW_REFRESH | No | Allow refresh-application (default: true) | true |
| ARGOCD_PRIORITY_APPS | No | Comma-separated bookmark app names | |
| ARGOCD_PROFILES_FILE | No | Legacy JSON file for profiles configuration (env vars override) | |
| ARGOCD_DEFAULT_PROFILE | No | Default profile name (must be in ARGOCD_PROFILES) for multi-environment mode | |
| ARGOCD_APP_CACHE_ENABLED | No | In-memory application name cache (default: true) | true |
| ARGOCD_APP_CACHE_TTL_SECONDS | No | Cache TTL in seconds (default: 300) | 300 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
| completions | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list-argocd-profilesA | List configured Argo CD environment profiles (qa, stg, prod, etc.) with URLs and authentication status. |
| argocd_loginA | Authenticate to Argo CD for a profile. Default: SSO via argocd CLI (opens browser). Alternative: username/password with sso=false. For API tokens without CLI login, use argocd_set_api_key or ARGOCD_API_KEY env vars. |
| argocd_set_api_keyA | Set an Argo CD API key (Bearer token) in memory for the current MCP session. Use when you have a token from the Argo CD UI (User Settings → API tokens) or argocd account generate-token. Env vars (ARGOCD_API_KEY) take precedence on server restart. |
| get-argocd-settingsA | Get public Argo CD settings for an environment profile (URL, OIDC config, UI banners). Does not require authentication. |
| get-argocd-userinfoA | Get the authenticated user for an environment profile (username, Azure groups, issuer). |
| search-argocd-endpointsA | Search Argo CD REST API endpoints from the bundled swagger catalog. Use before call-argocd-api. |
| describe-argocd-endpointB | Get full parameter documentation for an Argo CD API endpoint from swagger. |
| call-argocd-apiC | Execute a read-only Argo CD REST API call (GET). Mutations are blocked while ARGOCD_READ_ONLY=true. |
| argocd_auth_statusA | Show authentication status for all configured Argo CD profiles. Probes the API to detect expired or revoked tokens and returns recommendedAction (e.g. run argocd_login again). |
| list-applicationsA | List Argo CD applications with optional filters. Priority apps from env (ARGOCD_PRIORITY_APPS) appear first with isPriority=true. |
| search-applicationsA | Search Argo CD applications by substring (LIKE) using an in-memory cache. Matches name, project, repo, path and namespace. The Argo CD API only supports exact name match — use this tool for partial search (e.g. query='adherence'). |
| refresh-application-cacheA | Force refresh the in-memory application name cache for a profile. Useful after creating/deleting applications. |
| application-cache-statusA | Show application cache status per profile (enabled, TTL, count, expiry). |
| list-priority-applicationsA | List MCP priority/bookmark applications configured in env (ARGOCD_PRIORITY_APPS). Fetches live status for each name. Argo CD UI favorites are browser-only and cannot be read via API. |
| get-applicationA | Get detailed status of a single Argo CD application (sync, health, conditions, source). |
| get-application-diffA | Server-side dry-run diff for an application (what would change on sync). |
| get-application-manifestsB | Get rendered manifests for an application (optionally at a specific revision). |
| refresh-applicationB | Refresh an application (reconcile from Git). Use mode=hard to invalidate cache. Allowed when ARGOCD_ALLOW_REFRESH=true (default). |
| sync-applicationC | Sync application to target state. Blocked while ARGOCD_READ_ONLY=true. |
| get-application-pod-logsA | Get pod logs for an application (buffered tail, no streaming). Specify podName or use filters. |
| get-application-resource-treeB | Get the resource tree for an application (pods, services, deployments, health per node). |
| terminate-application-operationA | Terminate running sync/operation. Blocked while ARGOCD_READ_ONLY=true. |
| diagnose-applicationA | Composite troubleshooting: application status + resource tree + events + logs from unhealthy pods. |
| view-application-observabilityA | Abre um painel interativo com health, sync, Git, conditions e recursos unhealthy de uma application Argo CD. Em hosts sem MCP App, retorna JSON e resumo em texto. |
| refresh-application-observabilityA | Recarrega dados de observabilidade para o widget. Chamado pela UI, não pelo modelo. |
| list-projectsA | List Argo CD AppProjects with description, allowed source repos, and destinations. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| daily-argocd-healthcheck | Runs a daily health sweep across priority apps and unhealthy/out-of-sync applications. |
| investigate-outofsync | Investigates why an application is OutOfSync and whether sync is safe. |
| safe-sync-application | Checks permissions and diff before triggering a controlled sync. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| app-observability | Dashboard de observabilidade de uma application Argo CD (health, sync, Git, conditions) |
| argocd-profiles | Configured environment profiles (qa/stg/prod), URLs, auth status, and MCP mode flags. |
| argocd-priority-apps | MCP bookmark/priority application names from ARGOCD_PRIORITY_APPS env vars. |
| default | Public Argo CD settings per profile (OIDC, UI banners, kustomize). Cached for 5 minutes. |
| default | Cached application names and summaries per profile. Populated on first access; respects ARGOCD_APP_CACHE_TTL_SECONDS. |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/godrix/mcp-argocd'
If you have feedback or need assistance with the MCP directory API, please join our Discord server