readonly-mcp-akamai

Read-only MCP server for Akamai CDN. Search properties, browse EdgeWorker code, query DNS zones, inspect network lists, and translate error codes.

Read-only by design. This server can only read data. It cannot create, modify, delete, activate, deactivate, or purge anything. See blog.wentland.io for the rationale.

Tools

Properties (CDN configurations)

DNS

EdgeWorkers (serverless functions)

Network Lists

Utility

Install

# With uv (recommended)
uv pip install readonly-mcp-akamai

# With pip
pip install readonly-mcp-akamai

Docker

docker run -e AKAMAI_HOST=... -e AKAMAI_CLIENT_TOKEN=... \
  -e AKAMAI_CLIENT_SECRET=... -e AKAMAI_ACCESS_TOKEN=... \
  ghcr.io/desty2k/readonly-mcp-akamai

Configuration

All settings are via environment variables with the AKAMAI_ prefix.

Get credentials from Akamai Control Center > Identity & Access Management > API Clients.

MCP client configuration

Claude Desktop

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

{
  "mcpServers": {
    "akamai": {
      "command": "readonly-mcp-akamai",
      "env": {
        "AKAMAI_HOST": "akab-xxxx.luna.akamaiapis.net",
        "AKAMAI_CLIENT_TOKEN": "akab-xxxx",
        "AKAMAI_CLIENT_SECRET": "xxxx",
        "AKAMAI_ACCESS_TOKEN": "akab-xxxx"
      }
    }
  }
}

Claude Code

claude mcp add akamai -- readonly-mcp-akamai

Set the AKAMAI_* environment variables before starting Claude Code.

Example questions

An agent with this server can answer:

• "Find the CDN property for api.example.com and show me its caching rules"
• "What version is currently deployed to production for the main website?"
• "Show me all DNS records for example.com"
• "What EdgeWorkers are configured? Show me the code for the request router"
• "Search for all uses of setResponseHeader in EdgeWorker 42"
• "What IPs are in the blocklist network list?"
• "Translate this Akamai error: 9.6f64d440.1318965461.2f2b078"
• "List all CP codes for the main contract"

Development

# Clone
git clone https://github.com/desty2k/readonly-mcp-akamai.git
cd readonly-mcp-akamai

# Install with dev dependencies
uv pip install -e ".[dev]"

# Run tests
pytest --cov

# Lint
ruff check .
ruff format --check .

License

MIT