Breadcrumbs

📘 Cloudamize MCP Server – Admin & Setup Guide

🧩 Overview

Cloudamize MCP Server is a secure integration layer that connects Cloudamize APIs with:

  • AI assistants (Cursor, Claude Desktop, etc.)

  • AI agents

  • Enterprise agentic systems (AWS Transform, Kiro, workflows)

It provides access to:

  • Migration plans

  • Infrastructure assessment

  • Cost (TCO) insights

  • Recommendations

  • Migration grouping

🌐 Deployment Options

Mode

Endpoint

Use

🌍 Hosted

https://mcp.cloudamize.com

Recommended

🐳 Local

http://localhost:8080

Restricted environments

🌍 Hosted MCP Setup

🔑 Generate Token (Valid for 12 hours) 

#!/bin/sh

USERNAME="${API_USER:-your-email@email.com}"
PASSWORD="${API_PASS:-your password}"

URL="https://precloud-api.cloudamize.com/auth/token?termsAccepted=true"

if command -v base64 >/dev/null 2>&1; then
    AUTH=$(printf "%s:%s" "$USERNAME" "$PASSWORD" | base64)
else
    AUTH=$(printf "%s:%s" "$USERNAME" "$PASSWORD" | openssl base64)
fi
echo "Using user: $USERNAME"

# If Jq is not installed, use the following command to get the token
# curl --silent \
#   --location "$URL" \
#   --header "Authorization: Basic $AUTH"

  TOKEN=$(curl --silent \
  --location "$URL" \
  --header "Authorization: Basic $AUTH" \
  | jq -r '.access_token')

echo $TOKEN

(this script is currently only supporting for assessment's primary user credentials

We can also pass x-api-key value in PASSWORD if we do not have credentials)

🐳 Local MCP Setup (Docker) 

Pull image from ECR
docker pull public.ecr.aws/m5z6i3j5/cloudamize/cloudamize-mcp/prod

docker run -d \
  --name cmz-mcp-server \
  -p 8080:8080 \
  -e MODE=http \
  -e PRECLOUD_BASE_URL=https://precloud-api.cloudamize.com \
  -e GRAPH_BASE_URL=https://mp-api.cloudamize.com/api/v1 \
  -e MIGRATOR_BASE_URL=https://migrator-api.cloudamize.com \
  720780545726.dkr.ecr.eu-central-1.amazonaws.com/cmz-mcp-server/prod:latest


🧪 Example MCP Call (Hosted)

1. Initialize

Bash
curl -i https://mcp.cloudamize.com \
  -H 'Authorization: Bearer $TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": { "name": "curl", "version": "1.0.0" }
    }
  }'

  • Save the response header Mcp-Session-Id (example: mcp-session-xxxxxxxx-...).

  • Response body is JSON-RPC with server capabilities.

2. Initialized notification (recommended for spec-compliant clients)

Many MCP clients send this once after a successful initialize:

Bash
SESSION_ID='<Mcp-Session-Id from step 1>'

curl -i https://mcp.cloudamize.com \
  -H 'Authorization: Bearer $TOKEN' \
  -H "Mcp-Session-Id: ${SESSION_ID}" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "notifications/initialized"
  }'

  • Expect 202 Accepted (no JSON-RPC result body).

  • The cmz-mcp-server does not require this for basic tools/list / tools/call in manual tests, but production MCP clients typically send it.

3. List tools

Bash
curl -i https://mcp.cloudamize.com \
  -H 'Authorization: Bearer $TOKEN' \
  -H "Mcp-Session-Id: ${SESSION_ID}" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/list"
  }'

Registered tools include (non-exhaustive): getRecommendations, getInfrastructureAssessment, getPlanInsights, getTCO, getAIGroupingDetails, getApplicationData, getObservedInfrastructure, getServerConnectivity.

4. Call a tool

Bash
curl -i https://mcp.cloudamize.com \
  -H 'Authorization: Bearer $TOKEN' \
  -H "Mcp-Session-Id: ${SESSION_ID}" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "getInfrastructureAssessment",
      "arguments": {}
    }
  }'

📡 Local Endpoint 

http://localhost:8080/

⏳ Token Info

  • Token validity: 12 hours

  • Expired token → returns 401 Unauthorized

  • Must be refreshed periodically

🔐 Auth Methods

  • Bearer Token

🧠 Architecture 

AI Assistant / AI Agent
        ↓
MCP Server (Hosted / Local)
        ↓
Cloudamize APIs

⚙️ Admin Configuration

Variable

Description

MODE

http / stdio

PRECLOUD_BASE_URL

Cloudamize API endpoint

GRAPH_BASE_URL

Graph API endpoint

MIGRATOR_BASE_URL

Migration UI data API endpoint

AUTH_TOKEN

Bearer token (stdio mode)

📌 Summary

  • Hosted MCP is recommended: https://mcp.cloudamize.com

  • Local Docker available for restricted environments

  • Token expires every 12 hours

  • Supports AI assistants, AI agents, and enterprise agentic systems