Meta Agent Tools
PT

Back to the catalog

io.github.ExpertVagabond/ibmcloud

IBM Cloud CLI MCP server

Open source Open in the app JSON README (API)

About

IBM Cloud CLI MCP server

Details

Kind
MCP servers
Topic
Developer tools
Publisher
expertvagabond
Origin
official
Category
ferramentas
Transport
local
Version
1.0.1
Last push
2026-09-08T02:24:21Z
Repository state
ativo
Language
TypeScript
License
MIT
Added
2026-08-29 03:01:54
Updated
2026-08-29 03:01:54
Origin id
io.github.ExpertVagabond/ibmcloud

README

# ibmcloud-mcp-server

[\![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[\![MCP](https://img.shields.io/badge/MCP-Compatible-blue.svg)](https://modelcontextprotocol.io)
[\![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](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
```

## License

[MIT](LICENSE)

More