What can you do with this server?

ALECS MCP Server for Akamai is an AI-powered automation tool that provides natural language interaction and programmatic control over Akamai CDN services. With this server, you can: * Property Management: List, create, activate, and modify CDN properties and configuration rules * DNS Management: Manage zones, create/modify records, and activate DNS changes * Certificate Management: Create and manage domain validation certificates and monitor enrollment status * Content Control: Purge cache by URL or CP code, and manage network lists for access control * Multi-Customer Support: Securely manage multiple Akamai accounts via EdgeGrid authentication * AI Integration: Connect with various AI tools (Claude Desktop, Cursor IDE, VS Code) via Model Context Protocol * Comprehensive Coverage: Access all major Akamai services including Property Manager, Edge DNS, CPS Certificates, Fast Purge, Network Lists, App Security, and Reporting

Which integrations are available for this server?

Enables interaction with Akamai's CDN and edge services, including property management, Edge DNS management, SSL/TLS certificate handling, content invalidation (FastPurge), CP code management, and multi-customer account support. Offers production-ready containers with compose configurations for simplified deployment and operation. Built on Node.js 18+ with a modular architecture allowing deployment of focused servers for specific use cases or a monolithic server with all features. Plans to add future capability to generate Terraform configurations from existing Akamai properties. The codebase is fully migrated to TypeScript with strict mode enabled, providing enhanced type safety and developer experience.

How do I use ALECS - MCP server for Akamai?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ALECS - MCP server for Akamai list my Akamai properties" 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.

🚀 ALECS MCP Server for Akamai

A Launchgrid for Edge & Cloud Services

AI-powered Akamai CDN management through natural language

🔧 156 Tools • 🌐 15 Services • 🔐 Full EdgeRC Support • ⚡ Production Ready

🎯 What is ALECS?

ALECS bridges the gap between AI tools and Akamai's Connected Cloud Platform. Ask Claude, Cursor, or any MCP-compatible tool to manage your Akamai infrastructure using natural language and minimize context switching when creating Infrastructure-as-Code!

"List my Akamai properties"          →  Complete property inventory
"Create a DNS zone for example.com"  →  Zone created and configured
"Purge cache for /images/*"          →  Cache invalidated instantly
"Check SSL certificate status"       →  Validation progress shown

Related MCP server: MCPfinder Server

🎉 One-Click Installation

macOS:

curl -sSL https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-claude-desktop.sh | bash

Windows:

# Download and run installation script
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-claude-desktop.sh" -OutFile "install-claude-desktop.sh"
bash install-claude-desktop.sh

Linux:

curl -sSL https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-claude-desktop.sh | bash

One-click button:

Auto-install script:

curl -sSL https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-cursor.sh | bash

One-click button:

Auto-install script:

curl -sSL https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-lmstudio.sh | bash

Extension + Server:

curl -sSL https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-vscode.sh | bash

Manual Setup:

Install MCP extension
Cmd/Ctrl + Shift + P
"MCP: Add Server"
Command: alecs

Auto-configure:

curl -sSL https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-windsurf.sh | bash

Manual Setup:

Open Windsurf Settings
Navigate to MCP Servers
Add server with command: alecs

Simple command:

claude mcp add alecs-akamai alecs

Verify:

claude mcp list

📦 Quick Start

1. Install ALECS

Choose your preferred method:

Global install:

npm install -g alecs-mcp-server-akamai

Verify:

alecs --version

macOS/Linux:

curl -sSL https://raw.githubusercontent.com/acedergren/alecs-mcp-server-akamai/main/scripts/install-homebrew.sh | bash

Manual:

brew install node
npm install -g alecs-mcp-server-akamai

Quick start:

docker run -it --env-file .env ghcr.io/acedergren/alecs-mcp-server-akamai:latest

See full Docker section below for more options

2. Configure Akamai

Create ~/.edgerc with your credentials:

[default]
client_secret = your_client_secret
host = your_host.luna.akamaiapis.net
access_token = your_access_token
client_token = your_client_token

3. Choose Your AI Tool

Pick your favorite AI assistant and use the one-click installers above! 🚀

🌟 Features

🛠️ Service Coverage

Service	Tools	Key Features
🏢 Property Manager	25	CDN configs, rules, activations
🛡️ Security	47	Network lists, WAF policies
🌐 Edge DNS	12	DNS zones, records, DNSSEC
📋 Includes	10	Include configurations
🔗 Edge Hostnames	10	Hostname management
📊 Reporting	9	Analytics and metrics
🔐 Certificates	8	SSL/TLS lifecycle management
⚡ Fast Purge	8	Cache invalidation
🔧 Workflow	7	Orchestration and automation
🌐 Hostname Mgmt	5	Advanced hostname operations
📦 Bulk Operations	5	Batch processing
🚨 SIEM	4	Security monitoring
🏗️ Rule Tree	4	Rule processing
📊 CPCode	2	Traffic analysis codes

🎨 Natural Language Examples

🗣️ What You Say

"List my properties"
"Create DNS zone for example.com"
"Purge cache for /images/*"
"Check my SSL certificates"
"Show traffic for last 7 days"
"Add IP 192.168.1.0/24 to blocklist"

🤖 What ALECS Does

✅ property_list → Full inventory
✅ dns_zone_create → Zone configured
✅ fastpurge_url → Cache cleared
✅ certificate_status → SSL validated
✅ traffic_report → Analytics shown
✅ network_list_add → IP blocked

🏗️ Architecture

graph LR
    A[🤖 AI Assistant] --> B[🚀 ALECS Server]
    B --> C[🌐 Akamai APIs]

    subgraph "🔧 ALECS Components"
        B1[📡 MCP Protocol]
        B2[🔐 EdgeGrid Auth]
        B3[📋 Tool Registry]
        B4[🏪 Service Modules]
    end

    subgraph "🌐 Akamai Services"
        C1[🏢 Property Manager]
        C2[🌍 Edge DNS]
        C3[🔐 Certificates]
        C4[🛡️ Security]
        C5[⚡ Fast Purge]
    end

    B --> B1
    B1 --> B2
    B2 --> B3
    B3 --> B4
    B4 --> C1
    B4 --> C2
    B4 --> C3
    B4 --> C4
    B4 --> C5

🐳 Docker & Deployment

Quick Start

# Standard I/O for Claude Desktop (default)
docker run -it --env-file .env ghcr.io/acedergren/alecs-mcp-server-akamai:latest

# Streamable HTTP for web/CDN deployment
docker run -it -p 8080:8080 -e MCP_TRANSPORT=streamable-http --env-file .env ghcr.io/acedergren/alecs-mcp-server-akamai:latest

Transport Options

# Available transports
MCP_TRANSPORT=stdio           # Default - Claude Desktop, Cursor, CLI tools
MCP_TRANSPORT=streamable-http # Web clients, CDN deployment (recommended)
MCP_TRANSPORT=websocket       # Real-time bidirectional communication
MCP_TRANSPORT=sse             # Legacy Server-Sent Events (deprecated)

# Transport-specific configuration
HTTP_PORT=8080                # Port for streamable HTTP (default: 8080)
HTTP_HOST=0.0.0.0            # Host for streamable HTTP
HTTP_PATH=/mcp               # Base path for HTTP endpoints
CORS_ENABLED=true            # Enable CORS for browser clients

Available Docker Images

docker pull ghcr.io/acedergren/alecs-mcp-server-akamai:latest    # Full server
docker pull ghcr.io/acedergren/alecs-mcp-server-akamai:modular   # Microservices
docker pull ghcr.io/acedergren/alecs-mcp-server-akamai:websocket # WebSocket
docker pull ghcr.io/acedergren/alecs-mcp-server-akamai:http      # Streamable HTTP

🆕 OpenAPI-Driven Development

ALECS now features automatic tool generation from OpenAPI specifications:

# Generate new domain from API spec
alecs generate-from-api --spec ./openapi.json --domain mydomain

# Update existing tools when APIs change
alecs generate-from-api --spec ./api-v2.json --domain property --update

# Migrate legacy tools to OpenAPI patterns
alecs generate-from-api --spec ./api.json --tool ./dns-tools.ts --migrate

Benefits:

🚀 10x faster tool development
🔧 Always up-to-date with latest API changes
📝 Type-safe with automatic Zod schema generation
🔄 Smart updates preserve custom logic
🎯 Zero manual work for standard CRUD operations

📚 Documentation

📖 Guide	📝 Description
Developer Documentation	Complete developer guide
Developer Onboarding	New team member onboarding
API Reference	All 156 tools documented
Getting Started	Setup tutorials
Architecture Explainer	Comprehensive architecture guide
Architecture Quick Reference	Quick architecture lookup
Visual Architecture	Architecture diagrams
Architecture Deep Dive	Technical system design
Development Guide	Coding standards & patterns
Testing Strategy	Comprehensive testing approach
Deployment Guide	Production deployment
Operations Runbook	Production operations & troubleshooting
Tool Creation	Build custom tools & use OpenAPI

🤝 Contributing

We welcome contributions! Check out our Contributing Guide to get started.

🐛 Found a bug? Report it 💡 Have an idea? Suggest it ❓ Need help? Ask us

📄 License

GNU Affero General Public License v3.0 (AGPL-3.0) - see LICENSE

🌟 Star us on GitHub • 📦 Follow on NPM • 🐳 Use with Docker

Built with ❤️ for Akamai by Alexander Cedergren, alex@solutionsedge.io

ALECS - MCP server for Akamai