ibmcloud-mcp-server
[!License: MIT](https://opensource.org/licenses/MIT) [!MCP](https://modelcontextprotocol.io) [!TypeScript](https://www.typescriptlang.org)
MCP server wrapping the IBM Cloud CLI. Provides 80+ tools covering authentication, resource management, Cloud Foundry, Kubernetes, Container Registry, IAM, catalog, and billing operations.
Tools (80+)
Authentication (8 tools)
| Tool | Description |
|---|---|
ibmcloud_login | Login with API key or SSO |
ibmcloud_logout | Logout from IBM Cloud |
ibmcloud_target | Set target region and resource group |
ibmcloud_api | View or set API endpoint |
ibmcloud_regions | List available regions |
ibmcloud_account_show | Show current account details |
ibmcloud_account_list | List accessible accounts |
ibmcloud_config_list | List CLI configuration |
Resource Management (14 tools)
ibmcloud_resource_groups, ibmcloud_resource_group_create, ibmcloud_resource_service_instances, ibmcloud_resource_service_instance, ibmcloud_resource_service_instance_create, ibmcloud_resource_service_instance_delete, ibmcloud_resource_service_instance_update, ibmcloud_resource_service_keys, ibmcloud_resource_service_key, ibmcloud_resource_service_key_create, ibmcloud_resource_service_key_delete, ibmcloud_resource_search, ibmcloud_resource_tags, ibmcloud_resource_tag_attach
Cloud Foundry (20 tools)
ibmcloud_cf_orgs, ibmcloud_cf_spaces, ibmcloud_cf_apps, ibmcloud_cf_app, ibmcloud_cf_push, ibmcloud_cf_start, ibmcloud_cf_stop, ibmcloud_cf_restart, ibmcloud_cf_delete, ibmcloud_cf_logs, ibmcloud_cf_env, ibmcloud_cf_set_env, ibmcloud_cf_scale, ibmcloud_cf_routes, ibmcloud_cf_services, ibmcloud_cf_marketplace, ibmcloud_cf_create_service, ibmcloud_cf_bind_service, ibmcloud_cf_unbind_service
Kubernetes (15 tools)
ibmcloud_ks_clusters, ibmcloud_ks_cluster, ibmcloud_ks_cluster_config, ibmcloud_ks_cluster_create, ibmcloud_ks_cluster_delete, ibmcloud_ks_workers, ibmcloud_ks_worker_pools, ibmcloud_ks_worker_pool_create, ibmcloud_ks_worker_pool_resize, ibmcloud_ks_zones, ibmcloud_ks_versions, ibmcloud_ks_flavors
Container Registry (5 tools)
ibmcloud_cr_namespaces, ibmcloud_cr_namespace_add, ibmcloud_cr_images, ibmcloud_cr_image_rm, ibmcloud_cr_quota
IAM (18 tools)
ibmcloud_iam_users, ibmcloud_iam_user_invite, ibmcloud_iam_api_keys, ibmcloud_iam_api_key_create, ibmcloud_iam_api_key_delete, ibmcloud_iam_service_ids, ibmcloud_iam_service_id, ibmcloud_iam_service_id_create, ibmcloud_iam_service_id_delete, ibmcloud_iam_service_api_keys, ibmcloud_iam_service_api_key_create, ibmcloud_iam_access_groups, ibmcloud_iam_access_group, ibmcloud_iam_access_group_create, ibmcloud_iam_access_group_users, ibmcloud_iam_access_group_user_add, ibmcloud_iam_access_group_policies, ibmcloud_iam_access_group_policy_create, ibmcloud_iam_roles
Catalog and Billing (7 tools)
ibmcloud_catalog_search, ibmcloud_catalog_service, ibmcloud_catalog_service_plans, ibmcloud_billing_account_usage, ibmcloud_billing_resource_group_usage, ibmcloud_billing_resource_instances_usage, ibmcloud_billing_org_usage
Plugins (4 tools)
ibmcloud_plugin_list, ibmcloud_plugin_repo_plugins, ibmcloud_plugin_install, ibmcloud_version
Prerequisites
Install the IBM Cloud CLI:
curl -fsSL https://clis.cloud.ibm.com/install/osx | sh
Install
npm install
npm run build
Configuration
{
"mcpServers": {
"ibmcloud": {
"type": "stdio",
"command": "node",
"args": ["/path/to/ibmcloud-mcp/dist/index.js"]
}
}
}
Architecture
The server wraps the ibmcloud CLI binary, parsing JSON output from each command into structured MCP tool responses. Authentication state is managed by the CLI itself.
Project Structure
src/index.ts # MCP server with 80+ tool definitions
src/cli.ts # IBM Cloud CLI execution wrapper
tsconfig.json # TypeScript configuration
dist/ # Compiled output