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

💜 Support This Project

If this MCP server is useful to you, consider supporting its development:

Enterprise support available - Contact us for SLAs, custom development, and priority support.