Akamai CDN
Read-only MCP server for Akamai CDN — properties, EdgeWorkers, DNS, network lists
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
readonly-mcp-akamaiclaude mcp add akamai-cdn -e 'AKAMAI_HOST=<AKAMAI_HOST>' -e 'AKAMAI_CLIENT_TOKEN=<your akamai_client_token>' -e 'AKAMAI_CLIENT_SECRET=<your akamai_client_secret>' -e 'AKAMAI_ACCESS_TOKEN=<your akamai_access_token>' -- uvx readonly-mcp-akamai==0.1.1
{
"mcpServers": {
"akamai-cdn": {
"command": "uvx",
"args": [
"readonly-mcp-akamai==0.1.1"
],
"env": {
"AKAMAI_HOST": "<AKAMAI_HOST>",
"AKAMAI_CLIENT_TOKEN": "<your akamai_client_token>",
"AKAMAI_CLIENT_SECRET": "<your akamai_client_secret>",
"AKAMAI_ACCESS_TOKEN": "<your akamai_access_token>"
}
}
}
}
Environment variables
AKAMAI_HOSTrequired Akamai EdgeGrid API hostname (e.g., akab-xxxx.luna.akamaiapis.net)AKAMAI_CLIENT_TOKENrequired secret Akamai EdgeGrid client tokenAKAMAI_CLIENT_SECRETrequired secret Akamai EdgeGrid client secretAKAMAI_ACCESS_TOKENrequired secret Akamai EdgeGrid access token
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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)
| Tool | Description |
|---|---|
search_properties | Fuzzy search CDN properties by name. Uses a preloaded in-memory index refreshed every 5 minutes. |
get_property_details | Get property versions, hostnames, and activation status. |
get_property_rules | Get the rule tree for a property version — the full CDN configuration. |
get_property_activations | List deployment history for a property. |
DNS
| Tool | Description |
|---|---|
list_dns_zones | List all DNS zones, optionally filtered by name or type. |
search_dns_records | Search DNS records within a zone by name or record type. |
EdgeWorkers (serverless functions)
| Tool | Description |
|---|---|
list_edgeworkers | List all EdgeWorker IDs with names and descriptions. |
list_edgeworker_versions | List versions for an EdgeWorker. |
get_edgeworker_files | Download a version's code bundle and list all files. Cached in memory. |
get_edgeworker_file | Read a specific file from a cached bundle with line-range support. |
search_edgeworker_code | Regex search across all files in a cached bundle. |
Network Lists
| Tool | Description |
|---|---|
search_network_lists | Search network lists (IP allowlists, blocklists, geo lists) by name. |
get_network_list | Get the full contents of a network list. |
Utility
| Tool | Description |
|---|---|
list_groups | List account groups in the Akamai hierarchy. |
list_cp_codes | List CP codes (billing/reporting identifiers) for a contract and group. |
translate_error_code | Translate Akamai reference error codes to human-readable descriptions. |
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.
| Variable | Required | Default | Description |
|---|---|---|---|
AKAMAI_HOST | Yes | — | Akamai API hostname (e.g., akab-xxxx.luna.akamaiapis.net) |
AKAMAI_CLIENT_TOKEN | Yes | — | EdgeGrid client token |
AKAMAI_CLIENT_SECRET | Yes | — | EdgeGrid client secret |
AKAMAI_ACCESS_TOKEN | Yes | — | EdgeGrid access token |
AKAMAI_TRANSPORT | No | stdio | Transport: stdio, http, or sse |
AKAMAI_HTTP_PORT | No | 8080 | Port for HTTP/SSE transport |
AKAMAI_LOG_FORMAT | No | json | Log format: json or text |
AKAMAI_LOG_LEVEL | No | INFO | Log level: DEBUG, INFO, WARNING, ERROR |
AKAMAI_INDEX_REFRESH_INTERVAL | No | 300 | Property index refresh interval in seconds |
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
setResponseHeaderin 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
Frequently asked questions
What is Akamai CDN?
Read-only MCP server for Akamai CDN — properties, EdgeWorkers, DNS, network lists
How do I install Akamai CDN?
It runs on your machine. In Claude Code: claude mcp add akamai-cdn -e 'AKAMAI_HOST=<AKAMAI_HOST>' -e 'AKAMAI_CLIENT_TOKEN=<your akamai_client_token>' -e 'AKAMAI_CLIENT_SECRET=<your akamai_client_secret>' -e 'AKAMAI_ACCESS_TOKEN=<your akamai_access_token>' -- uvx readonly-mcp-akamai==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Akamai CDN need an API key?
Yes. It expects AKAMAI_HOST, AKAMAI_CLIENT_TOKEN, AKAMAI_CLIENT_SECRET, AKAMAI_ACCESS_TOKEN, which you set in its configuration.
Is Akamai CDN open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Akamai CDN?
It is published by desty2k. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.