ibmcloud-mcp-server
Provides tools for managing Cloud Foundry organizations, spaces, applications, routes, services, and more through the IBM Cloud CLI.
Provides tools for managing Kubernetes clusters, worker nodes, worker pools, zones, versions, and flavors.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ibmcloud-mcp-server What Kubernetes clusters do I have?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Login with API key or SSO |
| Logout from IBM Cloud |
| Set target region and resource group |
| View or set API endpoint |
| List available regions |
| Show current account details |
| List accessible accounts |
| 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
Related MCP server: Data Intelligence MCP Server
Prerequisites
Install the IBM Cloud CLI:
curl -fsSL https://clis.cloud.ibm.com/install/osx | shInstall
npm install
npm run buildConfiguration
{
"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 outputLicense
Available Tools
88 toolsibmcloud_account_listA
List all accessible accounts
Inputs: no named parameters.
ibmcloud_account_showB
Show current account information
Inputs: no named parameters.
ibmcloud_apiB
View or set IBM Cloud API endpoint
Inputs: endpoint.
ibmcloud_billing_account_usageA
Get account usage for a billing period
Inputs: month.
ibmcloud_billing_org_usageC
Get Cloud Foundry org usage
Inputs: org (required), month.
ibmcloud_billing_resource_group_usageC
Get resource group usage
Inputs: resource_group (required), month.
ibmcloud_billing_resource_instances_usageB
Get usage for resource instances
Inputs: month, resource_group.
ibmcloud_catalog_searchC
Search the service catalog
Inputs: query (required).
ibmcloud_catalog_serviceB
Get details about a catalog service
Inputs: service (required).
ibmcloud_catalog_service_plansC
List plans for a catalog service
Inputs: service (required).
ibmcloud_cf_appC
Get Cloud Foundry application details
Inputs: name (required).
ibmcloud_cf_appsB
List Cloud Foundry applications
Inputs: no named parameters.
ibmcloud_cf_bind_serviceC
Bind a service to an application
Inputs: app_name (required), service_instance (required), parameters.
ibmcloud_cf_create_serviceC
Create a Cloud Foundry service instance
Inputs: plan (required), service (required), instance_name (required), parameters.
ibmcloud_cf_deleteB
Delete a Cloud Foundry application
Inputs: name (required), force, delete_routes.
ibmcloud_cf_envB
Show environment variables for an application
Inputs: name (required).
ibmcloud_cf_logsA
View recent logs for an application
Inputs: name (required), recent.
ibmcloud_cf_marketplaceC
List marketplace services
Inputs: service.
ibmcloud_cf_orgsA
List Cloud Foundry organizations
Inputs: no named parameters.
ibmcloud_cf_pushC
Deploy a Cloud Foundry application
Inputs: name, path, memory, manifest, +3 more.
ibmcloud_cf_restartC
Restart a Cloud Foundry application
Inputs: name (required).
ibmcloud_cf_routesB
List Cloud Foundry routes
Inputs: no named parameters.
ibmcloud_cf_scaleC
Scale a Cloud Foundry application
Inputs: name (required), disk, memory, instances.
ibmcloud_cf_servicesB
List Cloud Foundry services
Inputs: no named parameters.
ibmcloud_cf_set_envB
Set an environment variable for an application
Inputs: name (required), var_name (required), var_value (required).
ibmcloud_cf_spacesB
List Cloud Foundry spaces
Inputs: org.
ibmcloud_cf_startA
Start a Cloud Foundry application
Inputs: name (required).
ibmcloud_cf_stopB
Stop a Cloud Foundry application
Inputs: name (required).
ibmcloud_cf_unbind_serviceC
Unbind a service from an application
Inputs: app_name (required), service_instance (required).
ibmcloud_config_listB
List CLI configuration
Inputs: no named parameters.
ibmcloud_cr_image_rmB
Remove a container image
Inputs: image (required), force.
ibmcloud_cr_imagesB
List container images
Inputs: repository, include_ibm.
ibmcloud_cr_namespace_addC
Create a Container Registry namespace
Inputs: name (required), resource_group.
ibmcloud_cr_namespacesA
List Container Registry namespaces
Inputs: no named parameters.
ibmcloud_cr_quotaA
Get Container Registry quota information
Inputs: no named parameters.
ibmcloud_iam_access_groupC
Get access group details
Inputs: name (required).
ibmcloud_iam_access_group_createB
Create an access group
Inputs: name (required), description.
ibmcloud_iam_access_group_policiesB
List policies for an access group
Inputs: group (required).
ibmcloud_iam_access_group_policy_createB
Create a policy for an access group
Inputs: group (required), roles (required), resource, service_name, +2 more.
ibmcloud_iam_access_groupsB
List access groups
Inputs: no named parameters.
ibmcloud_iam_access_group_user_addB
Add users to an access group
Inputs: group (required), users (required).
ibmcloud_iam_access_group_usersB
List users in an access group
Inputs: group (required).
ibmcloud_iam_api_key_createC
Create an API key
Inputs: name (required), file, description.
ibmcloud_iam_api_key_deleteC
Delete an API key
Inputs: name (required), force.
ibmcloud_iam_api_keysB
List API keys
Inputs: no named parameters.
ibmcloud_iam_rolesC
List IAM roles
Inputs: service.
ibmcloud_iam_service_api_key_createB
Create an API key for a service ID
Inputs: name (required), service_id (required), file, description.
ibmcloud_iam_service_api_keysB
List API keys for a service ID
Inputs: service_id (required).
ibmcloud_iam_service_idC
Get service ID details
Inputs: name (required).
ibmcloud_iam_service_id_createB
Create a service ID
Inputs: name (required), description.
ibmcloud_iam_service_id_deleteC
Delete a service ID
Inputs: name (required), force.
ibmcloud_iam_service_idsA
List service IDs
Inputs: no named parameters.
ibmcloud_iam_user_inviteC
Invite a user to the account
Inputs: email (required), access_groups.
ibmcloud_iam_usersA
List users in the account
Inputs: no named parameters.
ibmcloud_ks_clusterC
Get cluster details
Inputs: cluster (required).
ibmcloud_ks_cluster_configC
Configure kubectl for a cluster
Inputs: cluster (required), admin.
ibmcloud_ks_cluster_createC
Create a Kubernetes cluster
Inputs: name (required), zone (required), flavor, vpc_id, +3 more.
ibmcloud_ks_cluster_deleteC
Delete a Kubernetes cluster
Inputs: cluster (required), force.
ibmcloud_ks_clustersC
List Kubernetes clusters
Inputs: provider.
ibmcloud_ks_flavorsB
List available machine types/flavors
Inputs: zone (required), provider.
ibmcloud_ks_versionsA
List available Kubernetes versions
Inputs: no named parameters.
ibmcloud_ks_worker_pool_createC
Create a worker pool
Inputs: name (required), flavor (required), cluster (required), size_per_zone.
ibmcloud_ks_worker_pool_resizeC
Resize a worker pool
Inputs: pool (required), cluster (required), size_per_zone (required).
ibmcloud_ks_worker_poolsA
List worker pools in a cluster
Inputs: cluster (required).
ibmcloud_ks_workersA
List worker nodes in a cluster
Inputs: cluster (required).
ibmcloud_ks_zonesC
List available zones
Inputs: location, provider.
ibmcloud_loginA
Login to IBM Cloud with API key or SSO
Inputs: sso, apikey, region.
ibmcloud_logoutA
Logout from IBM Cloud
Inputs: no named parameters.
ibmcloud_plugin_installC
Install a CLI plugin
Inputs: plugin (required), force.
ibmcloud_plugin_listA
List installed CLI plugins
Inputs: no named parameters.
ibmcloud_plugin_repo_pluginsA
List available plugins from repository
Inputs: no named parameters.
ibmcloud_regionsA
List available IBM Cloud regions
Inputs: no named parameters.
ibmcloud_resource_group_createC
Create a resource group
Inputs: name (required).
ibmcloud_resource_groupsB
List resource groups
Inputs: no named parameters.
ibmcloud_resource_searchC
Search for resources
Inputs: query (required).
ibmcloud_resource_service_instanceB
Get details of a service instance
Inputs: name (required).
ibmcloud_resource_service_instance_createC
Create a service instance
Inputs: name (required), plan (required), service (required), location, +2 more.
ibmcloud_resource_service_instance_deleteC
Delete a service instance
Inputs: name (required), force.
ibmcloud_resource_service_instancesC
List service instances
Inputs: service_name, resource_group.
ibmcloud_resource_service_instance_updateC
Update a service instance
Inputs: name (required), plan, new_name, parameters.
ibmcloud_resource_service_keyC
Get details of a service key
Inputs: name (required).
ibmcloud_resource_service_key_createB
Create a service key/credential
Inputs: name (required), instance (required), role, parameters.
ibmcloud_resource_service_key_deleteC
Delete a service key
Inputs: name (required), force.
ibmcloud_resource_service_keysC
List service keys/credentials
Inputs: instance.
ibmcloud_resource_tag_attachB
Attach tags to a resource
Inputs: tags (required), resource_id (required).
ibmcloud_resource_tagsC
List tags
Inputs: resource_id.
ibmcloud_targetA
View or set target region, resource group, org, and space
Inputs: org, space, region, resource_group.
ibmcloud_versionA
Show IBM Cloud CLI version
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 88 tools
Each tool follows a clear resource-action pattern with domain prefixes (cf, ks, cr, iam, resource, billing, catalog), making every tool's purpose distinct. Even similar operations like listing service instances in CF vs resource service instances are clearly separated by their prefixes and descriptions.
All tool names use the consistent ibmcloud_<domain>_<verb>_<noun> pattern, with plural nouns for list operations and singular for get/create/update/delete. Standalone commands like ibmcloud_login and ibmcloud_target fit the overall CLI convention without breaking the pattern.
At 88 tools, the server is far beyond a typical MCP size, even for a comprehensive cloud platform. While each tool is independently useful, the sheer number makes selection and discovery unwieldy, and the score guideline suggests 25+ is already too many.
The tool set covers most major IBM Cloud domains with reasonable CRUD coverage, but some lifecycle gaps exist. For example, access groups and their policies have create/list/get operations but no delete or update, and CF apps lack an explicit update op (though push serves that role). Overall, the core workflows are covered.
Maintenance
Related MCP Connectors
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Authenticated MCP server for ClearPolicy policy and compliance workflows.
Related MCP Servers
- FlicenseCqualityDmaintenanceComprehensive MCP server for managing all IBM Cloud services, offering 180+ tools across 16 domains to enable AI assistants to fully manage IBM Cloud infrastructure.1002-

Data Intelligence MCP Serverofficial
AlicenseNot gradedqualityBmaintenanceProvides a modular MCP server to integrate with IBM Data Intelligence services, enabling secure interaction with data intelligence capabilities via tools and skills.378 PyPI20Apache 2.0- AlicenseNot gradedqualityCmaintenanceUnified MCP server for managing cloud resources across AWS, Google Cloud, Azure, and DigitalOcean by wrapping their CLI tools.MIT
- AlicenseAqualityDmaintenanceMCP server for Oracle Cloud Infrastructure (OCI) that provides tools to manage Compute, Object Storage, Block Storage, Networking, Autonomous Database, and IAM via the official OCI SDK.23MIT