@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 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| 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 immediately). When SSO expires, call this directly — do not try API keys first. 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
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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