MCP cldkctl Server

You can access Cloudeka’s cldkctl CLI functionality through MCP clients like Claude Desktop and Cursor by using the MCP cldkctl Server. It provides token-based authentication, automatic environment fallbacks, and a complete set of cldkctl endpoints exposed as MCP tools for easy management of projects, Kubernetes, VMs, billing, registries, notebooks, and more.

How to use

You run the MCP cldkctl Server locally with a compatible MCP client and then use the client’s command surface to manage Cloudeka resources. Start the server using one of the supported entry points, then configure your MCP clients to point at it.

How to install

Prerequisites: ensure you have Python and a compatible MCP runner available on your system.

Install the MCP cldkctl package from PyPI or via your MCP runner.

pip install mcp-cldkctl
# or
uvx mcp-cldkctl

Configuration and usage notes

Configure your MCP client to supply your cldkctl token and base URL. You can prefer production with automatic fallbacks to staging when needed.

Example client configuration for Claude Desktop and Cursor is shown below. Use your own token and project values where indicated.

{
  "mcpServers": {
    "cldkctl": {
      "command": "uvx",
      "args": ["mcp-cldkctl"],
      "env": {
        "CLDKCTL_TOKEN": "your_cldkctl_token_here",
        "CLDKCTL_BASE_URL": "https://ai.cloudeka.id"
      }
    }
  }
}

Environment and authentication flow

The server authenticates via a cldkctl token and caches a JWT locally. If the production environment encounters a database error or other issues, it automatically falls back to staging and remembers the working environment for future requests.

Typical steps are: authenticate with your token, check current status, and switch environments if needed.

Example usage

Basic authentication and routine management tasks are done through MCP tools exposed by the server. You can list projects, view Kubernetes pods, check billing, manage VMs, and access registries and notebooks through the respective tool endpoints.

Available tools

auth

Authenticate with your cldkctl token to obtain a JWT and initiate the session.

switch_environment

Switch between production and staging environments to continue operations when a primary environment has issues.

status

Check the current authentication state and which environment is active.

balance_detail

Retrieve detailed balance information for your current project.

billing_daily_cost

Query daily billing costs for the active project.

billing_monthly_cost

Query monthly billing costs for the active project.

billing_history

Fetch billing history for a given date range.

k8s_pods

List Kubernetes pods for a given project.

k8s_deployments

List Kubernetes deployments for a given project and namespace.

k8s_services

List Kubernetes services for a given project and namespace.

k8s_configmaps

List Kubernetes configmaps for a given project and namespace.

k8s_secrets

List Kubernetes secrets for a given project and namespace.

project_list

List all projects accessible to your account.

project_detail

Get detailed information for a specific project.

org_detail

Retrieve organization details.

org_members

List members of your organization.

profile_detail

Get your user profile details.

vm_list

List virtual machines for your project.

vm_detail

Get details for a specific virtual machine.

registry_list

List container registries for your project.

registry_repositories

List repositories within a container registry.

notebook_list

List Deka notebooks under your project.

notebook_create

Create a new Deka notebook.

voucher_list

List available vouchers.

voucher_apply

Apply a voucher code to a project.

token_list

List cldkctl tokens.

token_create

Create a new cldkctl token.

token_delete

Delete a cldkctl token.

audit_logs

Retrieve audit logs for your account.