ALECS - MCP Server for Akamai

MCP (Model Context Protocol) server that enables AI assistants to manage Akamai’s edge platform through natural language.

Note: This is an unofficial community project and comes without any support or warranty from Akamai Technologies.

Update regading ALECS

Stability over sprawl. I have made the hard decision to remove alot of tools for now. ALECS 1.6 now focuses on ~25 core tools that actually work and is well tested with Akamai APIs.

The plan is to slowy bring things back as we go and can make them stable, focusing on new worklows made possible with Elicitation in the new MCP spec from June 18, 2025.

Quick Start

# Clone and install
git clone https://github.com/acedergren/alecs-mcp-server-akamai.git
cd alecs-mcp-server-akamai
npm install

# Configure credentials
cp .edgerc.example ~/.edgerc
# Edit ~/.edgerc with your Akamai credentials

# Run
npm start

Core Features

• Property Management - Full CRUD operations on CDN properties
• DNS - Zone and record management with change-list workflow
• Certificates - DV certificate enrollment and management
• FastPurge - Content invalidation and cache management
• Network Lists - IP/Geo blocking and security lists
• Account switching - Account switching for with switch-key for those who need it ;)

Configuration

Akamai Credentials (.edgerc)

Create ~/.edgerc with your Akamai API credentials:

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

[production]
client_secret = prod_client_secret
host = prod_host.luna.akamaiapis.net
access_token = prod_access_token
client_token = prod_client_token
account_key = 1-ABCDEF

Claude Desktop Integration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "alecs": {
      "command": "node",
      "args": ["/path/to/alecs-mcp-server-akamai/dist/index.js"],
      "env": {
        "AKAMAI_EDGERC_PATH": "~/.edgerc"
      }
    }
  }
}

Usage Examples

Property Management

"List all my Akamai properties"
"Create property example.com using Ion Standard"
"Activate property to staging"

DNS Management

"List DNS zones"
"Add A record for www.example.com pointing to 192.0.2.1"
"Migrate DNS from Cloudflare"

FastPurge

"Purge https://example.com/images/*"
"Invalidate cache tag product-123"

Reporting

"Get performance metrics for my properties"
"Show traffic analysis for last 24 hours"
"Generate usage report by CP code"

Development

npm run build        # Build TypeScript
npm test            # Run tests
npm run dev         # Development mode
npm run lint        # Lint code
npm run typecheck   # Type checking

Available Servers

• npm run start:property - Property management (31 tools)
• npm run start:dns - DNS management (24 tools)