desty2k avatar

Akamai CDN

desty2k/readonly-mcp-akamai

A read-only interface to Akamai CDN APIs, intentionally stripped of any write operations. You get fuzzy search across CDN properties, direct access to rule trees and activation history, DNS zone inspection, and the ability to browse EdgeWorker serverless code with regex search across bundled files. It also surfaces network lists for IP allowlists and blocklists, translates those cryptic Akamai error codes, and lists CP codes for billing tracking. The property index lives in memory and refreshes every five minutes. Reach for this when you need to audit configurations, debug routing rules, or examine EdgeWorker implementations without worrying about accidentally purging caches or pushing changes to production.

GitHub stars
1
tools
16
auth
Secret needed
transport
STDIO
env vars
4
last updated
Nov 2, 2026

Tools

16 tools

Public tool metadata for what this MCP can expose to an agent.

search_propertiesFuzzy search CDN properties by name. Uses a preloaded in-memory index refreshed every 5 minutes. Returns match scores, flags close matches, and reports why the index failed to load if it did.

Fuzzy search CDN properties by name. Uses a preloaded in-memory index refreshed every 5 minutes. Returns match scores, flags close matches, and reports why the index failed to load if it did.

No parameter schema in public metadata yet.

get_property_detailsGet property versions, hostnames, and activation status.

Get property versions, hostnames, and activation status.

No parameter schema in public metadata yet.

get_property_rulesGet the rule tree for a property version — the full CDN configuration.

Get the rule tree for a property version — the full CDN configuration.

No parameter schema in public metadata yet.

get_property_activationsList deployment history for a property.

List deployment history for a property.

No parameter schema in public metadata yet.

list_dns_zonesList all DNS zones, optionally filtered by name or type.

List all DNS zones, optionally filtered by name or type.

No parameter schema in public metadata yet.

search_dns_recordsSearch DNS records within a zone by name or record type. Returns at most 500 records.

Search DNS records within a zone by name or record type. Returns at most 500 records.

No parameter schema in public metadata yet.

list_edgeworkersList all EdgeWorker IDs with names and descriptions.

List all EdgeWorker IDs with names and descriptions.

No parameter schema in public metadata yet.

list_edgeworker_versionsList versions for an EdgeWorker.

List versions for an EdgeWorker.

No parameter schema in public metadata yet.

get_edgeworker_filesDownload a version's code bundle and list all files. Cached in memory (bundles up to 16 MB, 128 MB in total).

Download a version's code bundle and list all files. Cached in memory (bundles up to 16 MB, 128 MB in total).

No parameter schema in public metadata yet.

get_edgeworker_fileRead a specific file from a cached bundle with line-range support. Output is capped at 100,000 characters, with the line to continue from.

Read a specific file from a cached bundle with line-range support. Output is capped at 100,000 characters, with the line to continue from.

No parameter schema in public metadata yet.

search_edgeworker_codeRegex search across all files in a cached bundle. Returns at most 200 matches.

Regex search across all files in a cached bundle. Returns at most 200 matches.

No parameter schema in public metadata yet.

search_network_listsSearch network lists (IP allowlists, blocklists, geo lists) by name.

Search network lists (IP allowlists, blocklists, geo lists) by name.

No parameter schema in public metadata yet.

get_network_listGet the contents of a network list, at most 5,000 entries.

Get the contents of a network list, at most 5,000 entries.

No parameter schema in public metadata yet.

list_groupsList account groups in the Akamai hierarchy.

List account groups in the Akamai hierarchy.

No parameter schema in public metadata yet.

list_cp_codesList CP codes (billing/reporting identifiers) for a contract and group.

List CP codes (billing/reporting identifiers) for a contract and group.

No parameter schema in public metadata yet.

translate_error_codeTranslate Akamai reference error codes to human-readable descriptions.

Translate Akamai reference error codes to human-readable descriptions.

No parameter schema in public metadata yet.

Sponsors

Configuration

AKAMAI_HOST*

Akamai EdgeGrid API hostname (e.g., akab-xxxx.luna.akamaiapis.net)

AKAMAI_CLIENT_TOKEN*secret

Akamai EdgeGrid client token

AKAMAI_CLIENT_SECRET*secret

Akamai EdgeGrid client secret

AKAMAI_ACCESS_TOKEN*secret

Akamai EdgeGrid access token

Readme

readonly-mcp-akamai

CI codecov PyPI Python License: MIT

A read-only Model Context Protocol (MCP) server that lets AI agents explore an Akamai account: CDN properties and their rule trees, EdgeWorker code, Edge DNS zones, network lists, CP codes, and error references. 16 tools, all of them reads.

Quick start

With uv installed, there is nothing else to install:


View the full README on GitHub

Details

Repository
github.com/desty2k/readonly-mcp-akamai
Website
blog.wentland.io/blog/read-only-mcp-server-akamai
Package
readonly-mcp-akamai
Transport
STDIO
Auth
Required
Registry
MCP registry, active