mcp-read-only-argocd
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_READ_ONLY_ARGOCD_CACHE_DIR | No | Override the cache directory path. Default is ~/.cache/lukleh/mcp-read-only-argocd/ | |
| MCP_READ_ONLY_ARGOCD_STATE_DIR | No | Override the state directory path. Default is ~/.local/state/lukleh/mcp-read-only-argocd/ | |
| MCP_READ_ONLY_ARGOCD_CONFIG_DIR | No | Override the config directory path. Default is ~/.config/lukleh/mcp-read-only-argocd/ |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_connectionsA | List all available Argo CD connections with their configuration details. Returns: JSON string with connection details including name, url, and description. |
| get_versionA | Get Argo CD version information. Args: connection_name: Name of the Argo CD connection to check Returns: JSON string with version information. |
| get_settingsC | Get Argo CD settings. Args: connection_name: Name of the Argo CD connection Returns: JSON string with Argo CD settings. |
| list_applicationsA | List all applications in Argo CD. Args: connection_name: Name of the Argo CD connection projects: Optional list of project names to filter by selector: Optional label selector to filter applications (e.g., "app=myapp") Returns: JSON string with list of applications. |
| get_applicationB | Get detailed information about a specific application. Args: connection_name: Name of the Argo CD connection name: Application name Returns: JSON string with application details including sync status, health, and spec. |
| get_application_resource_treeB | Get the Kubernetes resource tree for an application. Shows all resources created by the application and their relationships. Args: connection_name: Name of the Argo CD connection name: Application name Returns: JSON string with resource tree including nodes and their parent references. |
| get_application_managed_resourcesA | Get managed resources for an application. Args: connection_name: Name of the Argo CD connection name: Application name group: Optional API group to filter (e.g., "apps", "networking.k8s.io") kind: Optional resource kind to filter (e.g., "Deployment", "Service") namespace: Optional namespace to filter resource_name: Optional resource name to filter Returns: JSON string with list of managed resources. |
| get_application_logsA | Get logs for an application's pods. Args: connection_name: Name of the Argo CD connection name: Application name namespace: Optional namespace (defaults to application's namespace) pod_name: Optional specific pod name to get logs from container: Optional container name within the pod tail_lines: Number of lines from the end to return (e.g., 100) since_seconds: Return logs from the last N seconds Returns: JSON string with log entries. |
| list_projectsB | List all projects in Argo CD. Projects define the scope of resources an application can deploy. Args: connection_name: Name of the Argo CD connection Returns: JSON string with list of projects. |
| get_projectA | Get detailed information about a specific project. Args: connection_name: Name of the Argo CD connection name: Project name Returns: JSON string with project details including source repos, destinations, and roles. |
| list_clustersA | List all clusters registered in Argo CD. Args: connection_name: Name of the Argo CD connection Returns: JSON string with list of clusters including server URLs and connection status. |
| get_clusterB | Get detailed information about a specific cluster. Args: connection_name: Name of the Argo CD connection server: Cluster server URL (e.g., "https://kubernetes.default.svc") Returns: JSON string with cluster details including connection info and namespaces. |
| list_repositoriesB | List all repositories configured in Argo CD. Args: connection_name: Name of the Argo CD connection Returns: JSON string with list of repositories including URLs and connection status. |
| get_repositoryA | Get detailed information about a specific repository. Args: connection_name: Name of the Argo CD connection repo: Repository URL (e.g., "https://github.com/org/repo") Returns: JSON string with repository details including connection status and type. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
Each tool targets a distinct Argo CD resource or aspect (e.g., application details, logs, managed resources). There is no overlap in purpose, and descriptions clearly differentiate them.
All tools follow the verb_noun pattern with snake_case (e.g., get_application, list_applications). Naming is consistent and predictable throughout.
With 14 tools covering the main read-only operations for Argo CD (applications, clusters, projects, repositories, settings), the count is well-scoped and each tool earns its place.
The tool set provides comprehensive read-only coverage: listing and getting details for all major resources, plus application logs, managed resources, and resource tree. No obvious gaps for a read-only interface.