Skip to main content
Glama
desty2k
by desty2k

readonly-mcp-akamai

CI codecov PyPI License: MIT

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 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

Install Server
A
license - permissive license
A
quality
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/desty2k/readonly-mcp-akamai'

If you have feedback or need assistance with the MCP directory API, please join our Discord server