Read-only MCP server for Akamai CDN — search properties, browse EdgeWorker code, query DNS
Strong foundation with 16 well-named, read-only tools covering Akamai CDN operations. All tools have descriptions (avg 95 chars) and input schemas with types. Naming follows verb_noun pattern consistently (list_, search_, get_). Schemas are complete with required/optional flags and enums where appropriate. Key gaps: output schemas are not documented in the tool definitions (only inferred from descriptions), error handling lacks recovery guidance, and parameter descriptions could be more prescriptive about formats/constraints. No tool annotations (readOnlyHint, etc.) despite all being read-only. Pagination support present in search tools but not explicitly documented.
Read a file from an EdgeWorker code bundle. Returns numbered source lines.
List files in an EdgeWorker version's code bundle. Returns file paths, sizes, and line counts.
Get the full contents of a network list. Returns metadata and every IP, CIDR, or country code entry.
Get activation history for a property. Returns which versions were deployed to staging and production, when, and by whom.
Get property versions, hostnames, and activation status for staging and production networks.
Get the rule tree for a property version. Returns the CDN configuration as nested rules with match criteria and behaviors: caching, origin settings, headers, redirects, and edge logic.
Output schemas not documented. Tool descriptions state what is returned (e.g., 'Returns zone names, types, and activation state') but formal output schema definitions are absent from tool registration. LLMs cannot reliably plan downstream calls or extract specific fields without documented return types.
No tool annotations despite all 16 tools being read-only. Missing readOnlyHint annotation prevents clients from optimizing caching, retry logic, and safety assumptions. Current spec (2026-07-28) supports tool annotations; they should be present.
Parameter descriptions lack prescriptive format guidance. E.g., 'edgeworker_id' is described as 'numeric' but no range or validation rules stated. 'version' is described as 'e.g., 1.0' but format (semantic versioning? string?) is ambiguous. LLMs cannot validate inputs without explicit constraints.
Inferred effective spec: 2026-07-28+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2026-07-28+ | v2 |
List CP codes for a contract and group. CP codes are numeric identifiers used for billing, reporting, and content segmentation.
List DNS zones. Returns zone names, types, and activation state.
List versions for an EdgeWorker. Returns version identifiers, creation dates, and checksums.
List all EdgeWorkers with names and group associations.
List account groups in the Akamai hierarchy. Returns group names, IDs, parent relationships, and associated contract IDs.
Get DNS records for a zone. Returns record names, types, TTLs, and values.
Search across all files in an EdgeWorker code bundle using a regex pattern. Returns matching file paths, line numbers, and content.
Search network lists by name. Network lists are collections of IP addresses, CIDR blocks, or country codes used for access control.
Search CDN properties by name. Returns matching properties with version numbers, staging/production versions, and group/contract IDs.
Translate an Akamai error reference code into human-readable details. Returns HTTP response code, client/server IPs, origin info, failure reason, and WAF details.
Error handling lacks recovery guidance. No evidence of actionable error messages or recovery suggestions in tool implementations. If a property_id is invalid or a zone does not exist, the LLM receives no guidance on what to try next (e.g., 'Try search_properties() first').
Pagination not explicitly documented in search tools. search_properties accepts 'limit' (1-50, default 10) but no 'offset' or 'next_cursor' parameter visible. If results exceed limit, LLM cannot fetch additional pages. Pagination support should be explicit in schema and description.