Skip to main content
Glama
godrix

@godrix/argocd-mcp

by godrix

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ARGOCD_URLNoArgo CD base URL for single instance mode
ARGOCD_TOKENNoAlias for ARGOCD_API_KEY
ARGOCD_CONFIGNoPath to argocd CLI config (default: ~/.config/argocd/config)/root/.config/argocd/config
ARGOCD_API_KEYNoBearer token for default profile or single instance
ARGOCD_API_KEYSNoComma-separated API keys (same order as ARGOCD_PROFILES)
ARGOCD_GRPC_WEBNoPass --grpc-web to argocd login (default: true)true
ARGOCD_PROFILESNoComma-separated profile names for multi-environment mode
ARGOCD_READ_ONLYNoBlock sync and other mutations (default: true)true
ARGOCD_URL_PROFILESNoComma-separated URLs (same order as profiles) for multi-environment mode
ARGOCD_ALLOW_REFRESHNoAllow refresh-application (default: true)true
ARGOCD_PRIORITY_APPSNoComma-separated bookmark app names
ARGOCD_PROFILES_FILENoLegacy JSON file for profiles configuration (env vars override)
ARGOCD_DEFAULT_PROFILENoDefault profile name (must be in ARGOCD_PROFILES) for multi-environment mode
ARGOCD_APP_CACHE_ENABLEDNoIn-memory application name cache (default: true)true
ARGOCD_APP_CACHE_TTL_SECONDSNoCache 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

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}
completions
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
daily-argocd-healthcheckRuns a daily health sweep across priority apps and unhealthy/out-of-sync applications.
investigate-outofsyncInvestigates why an application is OutOfSync and whether sync is safe.
safe-sync-applicationChecks permissions and diff before triggering a controlled sync.

Resources

Contextual data attached and managed by the client

NameDescription
app-observabilityDashboard de observabilidade de uma application Argo CD (health, sync, Git, conditions)
argocd-profilesConfigured environment profiles (qa/stg/prod), URLs, auth status, and MCP mode flags.
argocd-priority-appsMCP bookmark/priority application names from ARGOCD_PRIORITY_APPS env vars.
defaultPublic Argo CD settings per profile (OIDC, UI banners, kustomize). Cached for 5 minutes.
defaultCached 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