code-engine-mcp-server 1.0.1 → 1.0.3

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Contributors
+Copyright (c) 2026 Markus van Kempen
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,5 +1,7 @@
 # Code Engine MCP Server
 
+![Code Engine MCP Logo](./images/code_engine_mcp_logo.png)
+
 Model Context Protocol (MCP) server for IBM Code Engine and Docker/Podman integration.
 It enables AI assistants to build, run, push, and deploy containerized workloads with a single MCP server.
 
@@ -12,10 +14,12 @@ It enables AI assistants to build, run, push, and deploy containerized workloads
 
 - [What You Get](#what-you-get)
 - [Quick Start](#quick-start)
+- [Deploy Your First App](#deploy-your-first-app)
 - [Documentation](#documentation)
 - [Project Structure](#project-structure)
 - [Features](#features)
 - [Configuration](#configuration)
+- [npm and MCP Registry](#npm-and-mcp-registry)
 - [Example Prompts](#example-prompts)
 - [Available Tools](#available-tools)
 - [Environment Variables](#environment-variables)
@@ -31,8 +35,9 @@ It enables AI assistants to build, run, push, and deploy containerized workloads
 ## ✨ What You Get
 
 - Container workflow tools for Docker or Podman
+- IBM Container Registry (ICR) tools — list namespaces, list images, delete images
 - IBM Code Engine project and application management tools
-- MCP-ready setup for GitHub Copilot, Cline, and Claude Desktop
+- MCP-ready setup for GitHub Copilot, Cline, Claude Desktop, and the optional VS Code extension in `vscode-extension/`
 - A simple local development and troubleshooting workflow
 
 ## 🚀 Quick Start
@@ -50,13 +55,260 @@ node build/index.js
 
 Then configure your MCP client using one of the examples in the Configuration section below.
 
-## 📖 Documentation
+## � Deploy Your First App
+
+This walks through deploying the included [Star Wars splash page example](./examples/starwars-splash/) — a static nginx container — entirely through the MCP server.
+
+> **Apple Silicon users:** always build with `--platform linux/amd64`. Code Engine runs amd64 only.
+
+### Step 1 — Build and push the image
+
+```bash
+cd examples/starwars-splash
+podman build --platform linux/amd64 -t us.icr.io/<your-namespace>/starwars-splash:v1.0.0 .
+podman push us.icr.io/<your-namespace>/starwars-splash:v1.0.0
+```
+
+Or ask your assistant:
+```
+Build examples/starwars-splash as us.icr.io/my-namespace/starwars-splash:v1.0.0 for linux/amd64 and push it
+```
+
+**MCP response — `build_container_image`:**
+```json
+{
+  "success": true,
+  "command": "podman build --platform linux/amd64 -t us.icr.io/my-namespace/starwars-splash:v1.0.0 ...",
+  "build_output": "STEP 1/5: FROM nginx:alpine\nSTEP 2/5: COPY index.html /usr/share/nginx/html/index.html\nSTEP 3/5: RUN sed -i 's/listen  80;/listen 8080;/g' /etc/nginx/conf.d/default.conf\nSTEP 4/5: EXPOSE 8080\nSTEP 5/5: CMD [\"nginx\", \"-g\", \"daemon off;\"]\nSuccessfully tagged us.icr.io/my-namespace/starwars-splash:v1.0.0"
+}
+```
+
+> **Note:** Container runtimes (Podman/Docker) write build progress to stderr. The `build_output` field combines stdout and stderr so you see the full build log.
+
+**MCP response — `push_container_image`:**
+```json
+{
+  "success": true,
+  "command": "podman push us.icr.io/my-namespace/starwars-splash:v1.0.0",
+  "output": "Getting image source signatures\nCopying blobs...\nWriting manifest to image destination"
+}
+```
+
+### Step 2 — Create a registry pull secret
+
+Ask your assistant (once per project):
+```
+Create a registry secret called icr-pull-secret in project <project-id> for us.icr.io using my IBM Cloud API key
+```
+
+Or use the `ce_create_secret` tool directly:
+```json
+{
+  "project_id": "<your-project-id>",
+  "name": "icr-pull-secret",
+  "format": "registry",
+  "data": {
+    "username": "iamapikey",
+    "password": "<your-ibm-cloud-api-key>",
+    "server": "us.icr.io",
+    "email": "user@example.com"
+  }
+}
+```
+
+**MCP response — `ce_create_secret`:**
+```json
+{
+  "name": "icr-pull-secret",
+  "format": "registry",
+  "resource_type": "secret_registry_v2",
+  "created_at": "2026-05-08T22:10:00Z",
+  "project_id": "<your-project-id>"
+}
+```
+
+### Step 3 — Deploy the application
+
+Ask your assistant:
+```
+Deploy us.icr.io/my-namespace/starwars-splash:v1.0.0 to Code Engine project <project-id>
+as app "starwars-splash" using pull secret icr-pull-secret, min 1 instance
+```
+
+Or use the `ce_create_application` tool:
+```json
+{
+  "project_id": "<your-project-id>",
+  "name": "starwars-splash",
+  "image": "us.icr.io/<your-namespace>/starwars-splash:v1.0.0",
+  "image_secret": "icr-pull-secret",
+  "scale_min_instances": 1,
+  "scale_max_instances": 3
+}
+```
+
+**MCP response — `ce_create_application`:**
+```json
+{
+  "name": "starwars-splash",
+  "resource_type": "app_v2",
+  "status": "deploying",
+  "image_reference": "us.icr.io/my-namespace/starwars-splash:v1.0.0",
+  "image_secret": "icr-pull-secret",
+  "image_port": 8080,
+  "scale_min_instances": 1,
+  "scale_max_instances": 3,
+  "scale_cpu_limit": "1",
+  "scale_memory_limit": "4G",
+  "endpoint": "https://starwars-splash.<subdomain>.us-south.codeengine.appdomain.cloud",
+  "status_details": {
+    "latest_created_revision": "starwars-splash-00001",
+    "latest_ready_revision": null
+  }
+}
+```
+
+### Step 4 — Check deployment status
+
+```
+Get details for the starwars-splash app in project <project-id>
+```
+
+This calls `ce_get_application` and returns the public URL once the app reaches `ready` status.
+
+```
+List the running instances of starwars-splash in project <project-id>
+```
+
+This calls `ce_list_app_instances` (or `ce_get_app_instance` for a specific instance) and shows:
+- Instance name and revision
+- Container status (`running` / `pending` / `failed`)
+- Restart count
+- Started-at timestamp
+- CPU and memory allocation
+
+**MCP response — `ce_get_application` (once ready):**
+```json
+{
+  "name": "starwars-splash",
+  "status": "ready",
+  "image_reference": "us.icr.io/my-namespace/starwars-splash:v1.0.0",
+  "image_port": 8080,
+  "scale_min_instances": 1,
+  "scale_max_instances": 3,
+  "scale_cpu_limit": "0.5",
+  "scale_memory_limit": "1G",
+  "region": "us-south",
+  "endpoint": "https://starwars-splash.<subdomain>.us-south.codeengine.appdomain.cloud",
+  "status_details": {
+    "latest_created_revision": "starwars-splash-00001",
+    "latest_ready_revision": "starwars-splash-00001"
+  }
+}
+```
+
+### Step 5 — Map a custom domain (optional)
+
+To serve the app at your own domain (e.g. `myapp.example.com`) you need a TLS certificate. The IBM Code Engine REST API always requires a real certificate — IBM's Console "Platform managed" option is not available via the API.
+
+**5a — Get a Let's Encrypt certificate (certbot)**
+
+```bash
+# Install once
+brew install certbot
+
+# Request cert — certbot will print a DNS TXT challenge value
+mkdir -p ~/certbot/{config,work,logs}
+/opt/homebrew/bin/certbot certonly --manual --preferred-challenges dns \
+  -d <your-domain> --agree-tos --no-eff-email --email you@example.com \
+  --config-dir ~/certbot/config --work-dir ~/certbot/work --logs-dir ~/certbot/logs
+```
+
+Certbot will pause and ask you to add a TXT record:
+```
+Add TXT record: _acme-challenge.<your-domain> = <challenge-value>
+```
+Verify propagation, then press Enter. Certbot writes:
+- `~/certbot/config/live/<your-domain>/fullchain.pem`
+- `~/certbot/config/live/<your-domain>/privkey.pem`
+
+**5b — Create the TLS secret in Code Engine**
+
+Ask your assistant:
+```
+Create a TLS secret called starwars-tls in project <project-id>
+using cert ~/certbot/config/live/myapp.example.com/fullchain.pem
+and key ~/certbot/config/live/myapp.example.com/privkey.pem
+```
+
+This calls `ce_create_tls_secret_from_pem` — reads the PEM files from disk and stores them as a Code Engine `tls` secret.
+
+**MCP response — `ce_create_tls_secret_from_pem`:**
+```json
+{
+  "name": "my-tls",
+  "format": "tls",
+  "resource_type": "secret_tls_v2",
+  "created_at": "2026-05-08T22:30:00Z",
+  "project_id": "<your-project-id>"
+}
+```
+
+**5c — Create the domain mapping**
+
+Ask your assistant:
+```
+Map domain myapp.example.com to app my-app
+in project <project-id> using TLS secret my-tls
+```
+
+This calls `ce_create_domain_mapping` and returns the `cname_target`.
+
+**MCP response — `ce_create_domain_mapping`:**
+```json
+{
+  "name": "myapp.example.com",
+  "status": "ready",
+  "cname_target": "custom.<subdomain>.us-south.codeengine.appdomain.cloud",
+  "component": {
+    "resource_type": "app_v2",
+    "name": "my-app"
+  },
+  "tls_secret": "my-tls",
+  "region": "us-south"
+}
+```
+
+**5d — Update your CNAME**
+
+In your DNS provider, set:
+```
+myapp.example.com CNAME custom.<subdomain>.us-south.codeengine.appdomain.cloud
+```
+
+Use the `cname_target` value returned in 5c (it uses the `custom.` prefix, not the app name).
+
+Once DNS propagates, `https://<your-domain>` serves the app with a valid TLS certificate.
+
+> **Certificate renewal:** Let's Encrypt certs expire after 90 days. Re-run certbot to get updated PEM files, then ask Copilot to run `ce_renew_tls_secret_from_pem` — it patches the existing secret in-place so your domain mapping continues working without any changes.
+
+### Full one-shot prompt
+
+```
+I have a Star Wars splash page in examples/starwars-splash.
+Build it for linux/amd64 as us.icr.io/my-namespace/starwars-splash:v1.0.0,
+push it, then deploy it to Code Engine project <project-id> with pull secret icr-pull-secret.
+Tell me the public URL and confirm the instance is running.
+```
+
+## �📖 Documentation
 
 - [Code Engine API Reference](./docs/CODE_ENGINE_API_REFERENCE.md)
 - [API Call Scenarios](./docs/API_CALL_SCENARIOS.md)
 - [Setup Instructions](./docs/SETUP_INSTRUCTIONS.md)
 - [Client README](./docs/CLIENT_README.md)
 - [Cline MCP Config Example](./docs/CLINE_CONFIG_EXAMPLE.json)
+- [VS Code MCP extension](./vscode-extension/README.md) (registers this server via settings; no `mcp.json` required for the default `npx` flow)
 - [Code of Conduct](./docs/CODE_OF_CONDUCT.md)
 - [Contributing Guide](./docs/CONTRIBUTING.md)
 - [Maintainers](./docs/MAINTAINERS.md)
@@ -78,6 +330,7 @@ code-engine-mcp-server/
 ├── MAINTAINERS.md                    # Maintainer list
 ├── README.md                         # Project overview and usage
 ├── mcp.example.json                  # Example MCP client configuration
+├── vscode-extension/                 # Optional VS Code extension (MCP definition provider)
 ├── package.json                      # npm package metadata and scripts
 ├── server.json                       # MCP Registry metadata
 └── tsconfig.json                     # TypeScript configuration
@@ -87,23 +340,61 @@ code-engine-mcp-server/
 
 ### Container Runtime Tools (Docker/Podman)
 - ✅ Detect container runtime (Docker/Podman)
-- ✅ Build container images
+- ✅ Build container images (with platform targeting for amd64)
 - ✅ Push images to registries
 - ✅ List local images
 - ✅ Test containers locally
 - ✅ Get container logs
 - ✅ Stop and remove containers
 - ✅ List all containers
+- ✅ Validate Dockerfile for Code Engine compatibility (`ce_validate_dockerfile`) — checks architecture, port, nginx sed patterns, USER, CMD
+
+### IBM Container Registry (ICR)
+- ✅ List ICR namespaces
+- ✅ List images with optional namespace filter
+- ✅ Delete images by tag
 
 ### IBM Code Engine Tools
-- ✅ List Code Engine projects
-- ✅ Create applications
-- ✅ List applications in a project
-- ✅ Get application details
+- ✅ List, create, and delete projects
+- ✅ Deploy applications with image pull secrets
+- ✅ Update applications (image, scaling, env)
+- ✅ List applications and get public URLs
+- ✅ Get per-instance status (running, restarts, started-at)
+- ✅ Get application logs per instance
+- ✅ Build and job management
+- ✅ Secrets and ConfigMaps
+- ✅ Custom domain mappings (create, list, get, delete)
+- ✅ TLS secrets from Let's Encrypt / certbot PEM files (`ce_create_tls_secret_from_pem`)
+- ✅ TLS cert renewal in-place without disrupting domain mappings (`ce_renew_tls_secret_from_pem`)
+- ✅ Update any secret in-place (`ce_update_secret`)
+- ✅ Wait for app deployment or build run to complete (`ce_wait_for_app_ready`, `ce_wait_for_build_run`)
+- ✅ IAM token info and diagnostics (`iam_get_token_info`)
+- ✅ Create ICR namespaces via REST API (`icr_create_namespace`)
+
+### Procedures
+- ✅ `proc_build_push_deploy` — full container pipeline in one prompt (build → push → deploy → wait)
+- ✅ `proc_setup_custom_domain` — TLS cert + domain mapping in one step, returns CNAME target
+- ✅ `proc_build_run_and_deploy` — CE source build → wait → deploy app → wait → return URL
 
 ## ⚙️ Configuration
 
-### 1) GitHub Copilot (VS Code) - Recommended
+### VS Code — IBM Code Engine MCP extension (optional)
+
+The extension in `vscode-extension/` registers this MCP server with VS Code using the **MCP server definition provider** API (VS Code **1.101+**). You do **not** need a workspace `.vscode/mcp.json` entry for the default flow: the server is started with `npx -y code-engine-mcp-server` and your API key from settings.
+
+1. Install the extension (from a `.vsix` built with `npm run package` inside `vscode-extension/`, or from the Marketplace when published).
+2. Ensure **Node.js** is installed and `npx` is on your `PATH`.
+3. Open **Settings** and search for **IBM Code Engine MCP**, or edit `settings.json` directly:
+   - `codeEngineMcp.apiKey` — your IBM Cloud API key (**required**; until this is set, the extension contributes no MCP server).
+   - `codeEngineMcp.region` — IBM Cloud region (optional, default `us-south`). Passed as `IBMCLOUD_REGION` to the server.
+
+The extension sets `IBMCLOUD_API_KEY` and `IBMCLOUD_REGION` for the spawned process. Use GitHub Copilot and MCP in VS Code as described in the [Copilot documentation](https://code.visualstudio.com/docs/copilot/copilot-chat).
+
+More detail: [vscode-extension/README.md](./vscode-extension/README.md).
+
+---
+
+### 1) GitHub Copilot (VS Code) — `mcp.json` (workspace)
 
 Copy `mcp.example.json` to `.vscode/mcp.json` in your workspace root:
 
@@ -123,7 +414,6 @@ Then edit `.vscode/mcp.json` and replace the placeholder with your IBM Cloud API
                 "${workspaceFolder}/code-engine-mcp-server/build/index.js"
             ],
             "env": {
-                "IBM_CLOUD_API_KEY": "your-ibm-cloud-api-key-here",
                 "IBMCLOUD_API_KEY": "your-ibm-cloud-api-key-here"
             }
         }
@@ -178,6 +468,13 @@ Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
 }
 ```
 
+## npm and MCP Registry
+
+Use the published package from npm or browse the MCP Registry listing:
+
+- [npm package: code-engine-mcp-server](https://www.npmjs.com/package/code-engine-mcp-server)
+- [MCP Registry entry: io.github.markusvankempen/code-engine-mcp-server](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.markusvankempen%2Fcode-engine-mcp-server)
+
 ## 💬 Example Prompts
 
 ### Detect Container Runtime
@@ -227,9 +524,22 @@ I have a Node.js app in ./my-app with a Dockerfile. Can you:
 5. Show me the application URL
 ```
 
+### Custom Domain
+
+Ask your assistant:
+```
+Create a TLS secret called my-tls in project <project-id>
+using cert ~/certbot/config/live/example.com/fullchain.pem
+and key ~/certbot/config/live/example.com/privkey.pem.
+Then map domain example.com to app my-app using that secret.
+Tell me what CNAME value to set in DNS.
+```
+
 ## 🛠️ Available Tools
 
-43 tools total: 8 container tools + 35 Code Engine tools.
+62 tools total: 9 container tools + 4 ICR tools + 45 Code Engine tools + 1 IAM tool + 3 procedures.
+
+> **Procedures** bundle multiple tools into a single call. Use them for common end-to-end workflows.
 
 ### Container Tools (8)
 
@@ -243,6 +553,16 @@ I have a Node.js app in ./my-app with a Dockerfile. Can you:
 | `test_container_locally` | Run container for local testing | `image_name`, `port_mapping`, `env_vars` |
 | `get_container_logs` | Get logs from a running container | `container_id`, `runtime` |
 | `stop_local_container` | Stop and remove a container | `container_id`, `runtime` |
+| `ce_validate_dockerfile` | Validate a Dockerfile for Code Engine compatibility (architecture, port, nginx sed patterns, USER, CMD) | `dockerfile_path`, `context_path`, `expected_port` |
+
+### IBM Container Registry Tools (4)
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `icr_list_namespaces` | List ICR namespaces in your account | `region` |
+| `icr_list_images` | List images in ICR (optionally filtered by namespace) | `namespace`, `region` |
+| `icr_delete_image` | Delete an image by full tag | `image`, `region` |
+| `icr_create_namespace` | Create a new ICR namespace | `namespace`, `region` |
 
 ### Code Engine: Projects (4)
 
@@ -253,19 +573,21 @@ I have a Node.js app in ./my-app with a Dockerfile. Can you:
 | `ce_create_project` | Create a new project | `name`, `resource_group_id` |
 | `ce_delete_project` | Delete a project | `project_id` |
 
-### Code Engine: Applications (7)
+### Code Engine: Applications (9)
 
 | Tool | Description | Key Parameters |
 |------|-------------|----------------|
 | `ce_list_applications` | List applications in a project | `project_id` |
-| `ce_get_application` | Get application details | `project_id`, `app_name` |
-| `ce_create_application` | Deploy a new application | `project_id`, `name`, `image`, `port`, `env_vars` |
-| `ce_update_application` | Update image, scaling, env | `project_id`, `app_name`, `image`, `scale_*` |
+| `ce_get_application` | Get application details and public URL | `project_id`, `app_name` |
+| `ce_create_application` | Deploy a new application | `project_id`, `name`, `image`, `image_secret`, `port`, `env_vars` |
+| `ce_update_application` | Update image, scaling, env, pull secret | `project_id`, `app_name`, `image`, `image_secret`, `scale_*` |
 | `ce_delete_application` | Delete an application | `project_id`, `app_name` |
-| `ce_list_app_instances` | List running instances (pods) | `project_id`, `app_name` |
+| `ce_list_app_instances` | List all running instances with status | `project_id`, `app_name` |
+| `ce_get_app_instance` | Get status details for a specific instance | `project_id`, `app_name`, `instance_name` |
 | `ce_get_app_logs` | Get logs for an app instance | `project_id`, `app_name`, `instance_name` |
+| `ce_wait_for_app_ready` | Poll until app status is ready or timeout; returns `poll_history` | `project_id`, `app_name`, `timeout_seconds` |
 
-### Code Engine: Builds (7)
+### Code Engine: Builds (9)
 
 | Tool | Description | Key Parameters |
 |------|-------------|----------------|
@@ -277,6 +599,7 @@ I have a Node.js app in ./my-app with a Dockerfile. Can you:
 | `ce_get_build_run` | Get build run status | `project_id`, `build_run_name` |
 | `ce_create_build_run` | Start a build run | `project_id`, `build_name` |
 | `ce_delete_build_run` | Delete a build run | `project_id`, `build_run_name` |
+| `ce_wait_for_build_run` | Poll until build run succeeds or fails; returns `poll_history` | `project_id`, `build_run_name`, `timeout_seconds` |
 
 ### Code Engine: Jobs (8)
 
@@ -291,14 +614,17 @@ I have a Node.js app in ./my-app with a Dockerfile. Can you:
 | `ce_create_job_run` | Submit a job run | `project_id`, `job_name` |
 | `ce_delete_job_run` | Delete a job run | `project_id`, `job_run_name` |
 
-### Code Engine: Secrets (4)
+### Code Engine: Secrets (7)
 
 | Tool | Description | Key Parameters |
 |------|-------------|----------------|
 | `ce_list_secrets` | List secrets (names + keys only) | `project_id` |
 | `ce_get_secret` | Get secret metadata (no values) | `project_id`, `secret_name` |
 | `ce_create_secret` | Create a secret | `project_id`, `name`, `format`, `data` |
+| `ce_update_secret` | Update an existing secret in-place (PATCH) | `project_id`, `secret_name`, `data` |
 | `ce_delete_secret` | Delete a secret | `project_id`, `secret_name` |
+| `ce_create_tls_secret_from_pem` | Create a TLS secret from PEM files | `project_id`, `secret_name`, `cert_pem_path`, `key_pem_path` |
+| `ce_renew_tls_secret_from_pem` | Renew an existing TLS secret from updated PEM files | `project_id`, `secret_name`, `cert_pem_path`, `key_pem_path` |
 
 ### Code Engine: ConfigMaps (4)
 
@@ -309,6 +635,29 @@ I have a Node.js app in ./my-app with a Dockerfile. Can you:
 | `ce_create_config_map` | Create a configmap | `project_id`, `name`, `data` |
 | `ce_delete_config_map` | Delete a configmap | `project_id`, `config_map_name` |
 
+### Code Engine: Domain Mappings (4)
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `ce_list_domain_mappings` | List all custom domain mappings | `project_id` |
+| `ce_get_domain_mapping` | Get status and CNAME target for a mapping | `project_id`, `domain_name` |
+| `ce_create_domain_mapping` | Map a custom domain to an app | `project_id`, `domain_name`, `app_name`, `tls_secret` |
+| `ce_delete_domain_mapping` | Delete a custom domain mapping | `project_id`, `domain_name` |
+
+### IBM Cloud IAM (1)
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `iam_get_token_info` | Inspect the current IAM token — account, expiry, validity | — |
+
+### Procedures — Multi-Step Workflows (3)
+
+| Tool | What it does | Key Parameters |
+|------|-------------|----------------|
+| `proc_build_push_deploy` | Build container for linux/amd64 → push → create/update CE app → wait for ready → return URL + `poll_history` | `context_path`, `project_id_or_name`, `app_name`, `image_secret`, `icr_namespace`, `image_tag` (default `latest`), `icr_host` (default `us.icr.io`), `port`, `timeout_seconds` |
+| `proc_setup_custom_domain` | Read PEM files → create TLS secret → create domain mapping → return CNAME target | `project_id_or_name`, `app_name`, `domain_name`, `tls_secret_name`, `cert_pem_path`, `key_pem_path` |
+| `proc_build_run_and_deploy` | Start CE build run → wait for success → create/update app → wait for ready → return URL + `build_poll_history` + `app_poll_history` | `project_id_or_name`, `build_name`, `app_name`, `image_secret`, `port`, `build_timeout_seconds`, `deploy_timeout_seconds` |
+
 ## 🔐 Environment Variables
 
 - `IBMCLOUD_API_KEY`: IBM Cloud API key (required for Code Engine operations)
@@ -319,9 +668,10 @@ I have a Node.js app in ./my-app with a Dockerfile. Can you:
 ## 📋 Prerequisites
 
 - Node.js v18 or higher
-- Docker or Podman installed
-- IBM Cloud CLI with Code Engine plugin (for Code Engine operations)
-- IBM Cloud API key (for Code Engine operations)
+- Docker or Podman installed (for container build/push tools)
+- IBM Cloud API key (for all Code Engine and ICR operations)
+
+> The MCP server communicates directly with the IBM Cloud REST API and ICR API. No IBM Cloud CLI or Code Engine plugin is required.
 
 ## 👩‍💻 Development
 
@@ -353,10 +703,10 @@ node build/index.js
 
 ### Code Engine Commands Failing
 
-1. Verify IBM Cloud CLI: `ibmcloud --version`
-2. Check Code Engine plugin: `ibmcloud plugin list`
-3. Verify API key is set in environment
-4. Test manually: `ibmcloud ce project list`
+1. Verify your API key is set: check `IBMCLOUD_API_KEY` in your MCP client config
+2. Confirm the region is correct (default `us-south`); set `IBMCLOUD_REGION` if needed
+3. Verify the project ID is valid: use `ce_list_projects` to find it
+4. Check for expired tokens — the server re-fetches IAM tokens automatically; if errors persist, regenerate your API key at [IBM Cloud IAM → API keys](https://cloud.ibm.com/iam/apikeys)
 
 ## 🛡️ Security
 
@@ -371,7 +721,7 @@ MIT (see `LICENSE`)
 
 ## 🤝 Contributing
 
-Contributions are welcome! Please open an issue or submit a pull request.
+Contributions are welcome! Please open an issue or submit a pull request (see [Contributing Guide](./docs/CONTRIBUTING.md)).
 
 ## 👤 Author
 

package/build/context-discovery.js

@@ -269,10 +269,10 @@ import { writeFileSync } from 'fs';
 const __filename = fileURLToPath(import.meta.url);
 const isMainModule = process.argv[1] === __filename;
 if (isMainModule) {
-    const apiKey = process.env.IBM_CLOUD_API_KEY;
+    const apiKey = process.env.IBMCLOUD_API_KEY;
     const region = process.env.IBM_CLOUD_REGION || 'us-south';
     if (!apiKey) {
-        console.error('❌ Error: IBM_CLOUD_API_KEY environment variable not set');
+        console.error('❌ Error: IBMCLOUD_API_KEY environment variable not set');
         process.exit(1);
     }
     discoverContext(apiKey, region)

package/build/context-discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-discovery.js","sourceRoot":"","sources":["../src/context-discovery.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context-discovery.js","sourceRoot":"","sources":["../src/context-discovery.ts"],"names":[],"mappings":"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"}

package/build/deploy-tool-enhanced.js

@@ -166,7 +166,7 @@ async function deployApplication(token, region, projectId, appName, imageName, p
  */
 export async function deployWithContext(spec) {
     const steps = [];
-    const apiKey = process.env.IBMCLOUD_API_KEY || process.env.IBM_CLOUD_API_KEY;
+    const apiKey = process.env.IBMCLOUD_API_KEY;
     const region = spec.region || 'us-south';
     if (!apiKey) {
         return {
@@ -174,7 +174,7 @@ export async function deployWithContext(spec) {
             appName: spec.appName,
             projectName: '',
             projectId: '',
-            error: 'IBM_CLOUD_API_KEY environment variable not set',
+            error: 'IBMCLOUD_API_KEY environment variable not set',
             steps
         };
     }