IBM Cloud CLI

You will run an MCP server that wraps the IBM Cloud CLI, exposing 80+ IBM Cloud tools through a consistent MCP interface. This enables you to perform authentication, resource management, Cloud Foundry, Kubernetes operations, container registry tasks, IAM management, catalog and billing, and more from a single, scriptable endpoint.

How to use

Use the IBM Cloud MCP Server with an MCP client to access a wide range of IBM Cloud capabilities. You will issue high-level prompts that map to specific IBM Cloud CLI tools, such as logging in, listing resources, managing Kubernetes clusters, deploying Cloud Foundry apps, and querying billing information. The server orchestrates the underlying IBM Cloud CLI calls and returns structured results that you can further process in your workflow.

How to install

Prerequisites include a functioning Node.js environment and the IBM Cloud CLI. You will also need a runtime environment capable of executing MCP server code.

Install IBM Cloud CLI using the command below.

curl -fsSL https://clis.cloud.ibm.com/install/osx | sh

Install dependencies for the MCP server and build it.

cd ~/mcp-servers/ibmcloud-mcp
npm install
npm run build

Configure Claude Code to load the MCP server. Create or edit your Claude configuration to include the IBM Cloud MCP server, pointing to the compiled index script.

{
  "mcpServers": {
    "ibmcloud": {
      "type": "stdio",
      "command": "node",
      "args": ["/Users/matthewkarsten/mcp-servers/ibmcloud-mcp/dist/index.js"]
    }
  }
}

Notes and usage considerations

The MCP server provides a wide set of IBM Cloud capabilities, organized into tool categories such as Authentication, Resource Management, Cloud Foundry, Kubernetes, Container Registry, IAM, Catalog & Billing, and Plugins. Each tool corresponds to a specific IBM Cloud CLI operation and can be invoked through your MCP client in a straightforward, consistent manner.

Available tools

ibmcloud_login

Login with API key or SSO

ibmcloud_logout

Logout from IBM Cloud

ibmcloud_target

Set target region/resource group

ibmcloud_api

View/set API endpoint

ibmcloud_regions

List available regions

ibmcloud_account_show

Show current account

ibmcloud_account_list

List accessible accounts

ibmcloud_config_list

List CLI configuration

ibmcloud_resource_groups

List resource groups

ibmcloud_resource_group_create

Create resource group

ibmcloud_resource_service_instances

List service instances

ibmcloud_resource_service_instance

Get instance details

ibmcloud_resource_service_instance_create

Create instance

ibmcloud_resource_service_instance_delete

Delete instance

ibmcloud_resource_service_instance_update

Update instance

ibmcloud_resource_service_keys

List service keys

ibmcloud_resource_service_key

Get key details

ibmcloud_resource_service_key_create

Create service key

ibmcloud_resource_service_key_delete

Delete service key

ibmcloud_resource_search

Search resources

ibmcloud_resource_tags

List tags

ibmcloud_resource_tag_attach

Attach tags

ibmcloud_cf_orgs

List organizations

ibmcloud_cf_spaces

List spaces

ibmcloud_cf_apps

List applications

ibmcloud_cf_app

Get app details

ibmcloud_cf_push

Deploy application

ibmcloud_cf_start

Start application

ibmcloud_cf_stop

Stop application

ibmcloud_cf_restart

Restart application

ibmcloud_cf_delete

Delete application

ibmcloud_cf_logs

View app logs

ibmcloud_cf_env

Show environment variables

ibmcloud_cf_set_env

Set environment variable

ibmcloud_cf_scale

Scale application

ibmcloud_cf_routes

List routes

ibmcloud_cf_services

List services

ibmcloud_cf_marketplace

List marketplace

ibmcloud_cf_create_service

Create service

ibmcloud_cf_bind_service

Bind service to app

ibmcloud_cf_unbind_service

Unbind service

ibmcloud_ks_clusters

List Kubernetes clusters

ibmcloud_ks_cluster

Get cluster details

ibmcloud_ks_cluster_config

Configure kubectl

ibmcloud_ks_cluster_create

Create cluster

ibmcloud_ks_cluster_delete

Delete cluster

ibmcloud_ks_workers

List worker nodes

ibmcloud_ks_worker_pools

List worker pools

ibmcloud_ks_worker_pool_create

Create worker pool

ibmcloud_ks_worker_pool_resize

Resize worker pool

ibmcloud_ks_zones

List available zones

ibmcloud_ks_versions

List K8s versions

ibmcloud_ks_flavors

List machine flavors

ibmcloud_cr_namespaces

List namespaces

ibmcloud_cr_namespace_add

Create namespace

ibmcloud_cr_images

List images

ibmcloud_cr_image_rm

Remove image

ibmcloud_cr_quota

Get quota info

ibmcloud_iam_users

List users

ibmcloud_iam_user_invite

Invite user

ibmcloud_iam_api_keys

List API keys

ibmcloud_iam_api_key_create

Create API key

ibmcloud_iam_api_key_delete

Delete API key

ibmcloud_iam_service_ids

List service IDs

ibmcloud_iam_service_id

Get service ID

ibmcloud_iam_service_id_create

Create service ID

ibmcloud_iam_service_id_delete

Delete service ID

ibmcloud_iam_service_api_keys

List service API keys

ibmcloud_iam_service_api_key_create

Create service API key

ibmcloud_iam_access_groups

List access groups

ibmcloud_iam_access_group

Get access group

ibmcloud_iam_access_group_create

Create access group

ibmcloud_iam_access_group_users

List group users

ibmcloud_iam_access_group_user_add

Add user to group

ibmcloud_iam_access_group_policies

List group policies

ibmcloud_iam_access_group_policy_create

Create policy

ibmcloud_iam_roles

List IAM roles

ibmcloud_catalog_search

Search service catalog

ibmcloud_catalog_service

Get service details

ibmcloud_catalog_service_plans

List service plans

ibmcloud_billing_account_usage

Get account usage

ibmcloud_billing_resource_group_usage

Get RG usage

ibmcloud_billing_resource_instances_usage

Get instance usage

ibmcloud_billing_org_usage

Get org usage