ibmcloud-mcp-server

IBM Cloud CLI MCP Server

Comprehensive MCP server wrapping the IBM Cloud CLI for Claude Code. Provides 80+ tools covering all major IBM Cloud services and operations.

Features

• Authentication - Login, logout, target, regions
• Resource Management - Service instances, keys, resource groups
• Cloud Foundry - Apps, services, routes, marketplace
• Kubernetes - Clusters, workers, worker pools, zones
• Container Registry - Namespaces, images, quotas
• IAM - Users, API keys, service IDs, access groups
• Catalog & Billing - Service catalog, usage, billing

Tool Categories

Authentication (8 tools)

Tool	Description
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

Resource Management (14 tools)

Tool	Description
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

Cloud Foundry (20 tools)

Tool	Description
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

Kubernetes (15 tools)

Tool	Description
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

Container Registry (5 tools)

Tool	Description
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

IAM (18 tools)

Tool	Description
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

Catalog & Billing (7 tools)

Tool	Description
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

Plugins (4 tools)

Tool	Description
ibmcloud_plugin_list	List installed plugins
ibmcloud_plugin_repo_plugins	List available plugins
ibmcloud_plugin_install	Install a plugin
ibmcloud_version	Show CLI version

Setup

1. Prerequisites

Install IBM Cloud CLI:

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

2. Install Dependencies

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

3. Add to Claude Code

Add to ~/.claude.json:

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

Architecture

Claude Code (Opus 4.5)
         │
         └──▶ IBM Cloud MCP Server
                    │
                    └──▶ ibmcloud CLI
                              │
                              ├── Resource Controller
                              ├── Cloud Foundry API
                              ├── Kubernetes Service
                              ├── Container Registry
                              ├── IAM Service
                              └── Billing Service

Usage Examples

User: List my IBM Cloud Kubernetes clusters

Claude: [Uses ibmcloud_ks_clusters tool]
Result:
- mycluster (VPC Gen2, us-south, 1.28, 3 workers) - normal
- dev-cluster (Classic, dal10, 1.27, 2 workers) - normal

User: Create a new Cloud Object Storage instance

Claude: [Uses ibmcloud_resource_service_instance_create]
Created: my-cos-instance (cloud-object-storage, lite plan)

IBM Cloud Services Supported

• Watson AI: watsonx.ai, Watson Studio, Watson ML
• Storage: Cloud Object Storage, Block Storage
• Databases: Db2, PostgreSQL, MongoDB, Redis
• Containers: Kubernetes, OpenShift, Container Registry
• Serverless: Cloud Functions, Code Engine
• Networking: VPC, Load Balancers, DNS
• Security: Key Protect, Secrets Manager, IAM
• Integration: API Connect, MQ, Event Streams

Files

ibmcloud-mcp/
├── src/
│   ├── index.ts    # MCP server implementation
│   └── cli.ts      # IBM Cloud CLI wrapper
├── dist/           # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

Author

Matthew Karsten

License

MIT