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:

bash

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

Install

bash

npm install
npm run build

Configuration

json

{
  "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