Resources and Prompts

The Helm MCP Server provides MCP Resources for data access and Prompts for guided workflows.

---

📁 Available Resources

Resources provide read-only access to Helm and Kubernetes data through URI-based queries.

Resource URI	Description
helm://releases	List all Helm releases in cluster
helm://releases/[release_name]	Get detailed release information
helm://charts	List available charts in repositories
helm://charts/[repo]/[name]	Get specific chart metadata
helm://charts/[repo]/[name]/readme	Get chart README documentation
kubernetes://cluster-info	Get Kubernetes cluster information
kubernetes://namespaces	List all Kubernetes namespaces
helm://best_practices	Helm Best Practices guide

---

helm://releases

List all Helm releases across the cluster.

Example Response:

{
  "releases": [
    {
      "name": "my-postgresql",
      "namespace": "database",
      "revision": 3,
      "status": "deployed",
      "chart": "postgresql-12.5.0",
      "app_version": "15.3.0"
    }
  ]
}

---

helm://releases/[release_name]

Get detailed information about a specific release.

URI Example: helm://releases/my-postgresql

Returns:

• Release metadata
• Current revision
• Values used
• Manifest resources
• Release history

---

helm://charts/[repo]/[name]

Get metadata for a specific chart.

URI Example: helm://charts/bitnami/postgresql

Returns:

• Chart description
• Available versions
• Maintainers
• Dependencies
• Keywords

---

helm://charts/[repo]/[name]/readme

Get the README documentation for a chart.

URI Example: helm://charts/bitnami/postgresql/readme

Returns:

• Full README content
• Installation instructions
• Configuration options
• Usage examples

---

kubernetes://cluster-info

Get information about the connected Kubernetes cluster.

Returns:

• Cluster version
• API server URL
• Node count
• Current context

---

helm://best_practices

Access the comprehensive Helm best practices guide.

Returns:

• Security best practices
• Configuration recommendations
• Deployment patterns
• Troubleshooting tips

---

💬 Available Prompts

Prompts provide structured guidance and workflows for common Helm operations.

Prompt	Description	Arguments
helm_workflow_guide	Complete workflow documentation	—
helm_quick_start	Quick start for common operations	—
helm_installation_guidelines	Installation best practices	—
helm_troubleshooting_guide	Troubleshooting common issues	error_type
helm_security_checklist	Security considerations	—
helm_upgrade_guide	Upgrade guide for charts	chart_name
helm_rollback_procedures	Rollback step-by-step guide	release_name

---

helm_workflow_guide

Comprehensive guide covering the complete Helm workflow from discovery to deployment.

Use Case:

"Show me the complete Helm workflow guide"
"How do I use Helm with this server?"

Contents:

• Discovery workflow
• Installation workflow
• Upgrade workflow
• Rollback procedures
• Monitoring and validation

---

helm_quick_start

Quick start guide for common Helm operations.

Use Case:

"Give me a quick start guide for Helm"
"How do I get started with Helm deployments?"

---

helm_installation_guidelines

Best practices and guidelines for Helm installations.

Use Case:

"What are the best practices for Helm installations?"
"How should I configure my Helm deployments?"

Contents:

• Value configuration best practices
• Namespace strategies
• Resource management
• Pre-installation checks

---

helm_troubleshooting_guide

Troubleshooting guide for common Helm issues.

Arguments:

Argument	Type	Description
error_type	string	Type of error to troubleshoot

Error Types:

• pod-crashloop - CrashLoopBackOff errors
• image-pull - Image pull failures
• pending-pods - Pods stuck in Pending state
• helm-timeout - Helm operation timeouts
• values-error - Values configuration errors

Use Case:

"My pods are in CrashLoopBackOff after deploying redis"
"Help me troubleshoot image pull errors"

---

helm_security_checklist

Security considerations and checklist for Helm deployments.

Use Case:

"What are the security best practices for Helm?"
"Show me the security checklist"

Contents:

• Secret management
• RBAC configuration
• Network policies
• Image security
• Audit logging

---

helm_upgrade_guide

Step-by-step guide for upgrading Helm releases.

Arguments:

Argument	Type	Description
chart_name	string	Name of the chart to upgrade

Use Case:

"How do I upgrade my PostgreSQL release?"
"Guide me through upgrading nginx-ingress"

Contents:

• Pre-upgrade checks
• Backup procedures
• Upgrade steps
• Verification
• Rollback plan

---

helm_rollback_procedures

Comprehensive rollback procedures for Helm releases.

Arguments:

Argument	Type	Description
release_name	string	Name of the release to rollback

Use Case:

"How do I rollback my-release?"
"Show me the rollback procedures for nginx"

Contents:

• When to rollback
• Identifying target revision
• Rollback execution
• Post-rollback verification
• Root cause analysis

---

Using Resources and Prompts

Accessing Resources

Resources are accessed via the MCP protocol using their URI:

Client: Can you show me helm://releases?
Agent: [Fetches and displays all Helm releases]

Using Prompts

Prompts are invoked by name with optional arguments:

Client: My pods are crashing, help me troubleshoot
Agent: [Uses helm_troubleshooting_guide with error_type="pod-crashloop"]

---

Next Steps

• 📖 Examples - Usage patterns and workflows
• 🛠️ Tools - Available MCP tools reference
• ⚙️ Configuration - Server configuration