Skip to main content
Glama

mcp-connector-for-akamai

Disclaimer: This is an independent, unofficial, community-driven project. It is not affiliated with, endorsed by, sponsored by, or in any way officially connected to Akamai Technologies, Inc. The name "Akamai" and any related trademarks, service marks, or logos are the property of their respective owners and are used here solely for descriptive purposes to indicate compatibility. Use of these names does not imply any affiliation or endorsement. This software is provided "as is", without warranty of any kind. The authors assume no liability for any damages arising from the use of this software.

An unofficial MCP (Model Context Protocol) server that connects AI assistants to Akamai APIs. Provides tools for edge diagnostics, debugging, and network analysis.

Link to NPM: https://npmjs.com/package/mcp-connector-for-akamai

Tools

Edge Diagnostics

Tool

Description

translate_error_string

Decode Akamai error reference codes into detailed error info

curl_from_edge

Fetch a URL from an Akamai edge server with debug headers

get_error_statistics

HTTP error statistics for a URL or CP code

verify_locate_ip

Verify if an IP is Akamai edge and get geolocation

locate_ip

Geolocate up to 10 IP addresses

dig_from_edge

DNS lookup from an Akamai edge server

mtr_from_edge

MTR traceroute from an Akamai edge server

grep_edge_logs

Search edge server logs by IP, time range, and filters

list_edge_locations

List available Akamai edge server locations

translate_akamaized_url

Decode an Akamaized URL (ARL) into components

verify_edge_ip

Verify up to 10 IPs as Akamai edge IPs

url_health_check

Comprehensive URL health check (cURL + dig + MTR)

connectivity_problems

Diagnose connectivity issues (GREP + cURL + MTR)

content_problems

Diagnose content/cache issues (edge vs origin comparison)

Setup

Prerequisites

  • Node.js 18+ or Bun

  • Akamai API credentials with Edge Diagnostics API access

Build

bun install
bun run build

Environment Variables

Variable

Required

Description

AKAMAI_CLIENT_SECRET

Yes

Akamai EdgeGrid client secret

AKAMAI_CLIENT_TOKEN

Yes

Akamai EdgeGrid client token

AKAMAI_ACCESS_TOKEN

Yes

Akamai EdgeGrid access token

AKAMAI_HOST

Yes

Akamai API hostname (e.g. akab-xxx.luna.akamaiapis.net)

AKAMAI_ACCOUNT_SWITCH_KEY

No

Account switch key for multi-account setups

VS Code / Copilot Configuration

Add to your .vscode/mcp.json:

{
  "inputs": [
    { "id": "akamai-client-secret", "type": "promptString", "description": "Akamai EdgeGrid client secret", "password": true },
    { "id": "akamai-client-token", "type": "promptString", "description": "Akamai EdgeGrid client token", "password": true },
    { "id": "akamai-access-token", "type": "promptString", "description": "Akamai EdgeGrid access token", "password": true },
    { "id": "akamai-host", "type": "promptString", "description": "Akamai API hostname (e.g. akab-xxx.luna.akamaiapis.net)" }
  ],
  "servers": {
    "mcp-connector-for-akamai": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-connector-for-akamai"],
      "env": {
        "AKAMAI_CLIENT_SECRET": "${input:akamai-client-secret}",
        "AKAMAI_CLIENT_TOKEN": "${input:akamai-client-token}",
        "AKAMAI_ACCESS_TOKEN": "${input:akamai-access-token}",
        "AKAMAI_HOST": "${input:akamai-host}"
      }
    }
  }
}

Claude Desktop Configuration

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

{
  "mcpServers": {
    "mcp-connector-for-akamai": {
      "command": "npx",
      "args": ["-y", "mcp-connector-for-akamai"],
      "env": {
        "AKAMAI_CLIENT_SECRET": "...",
        "AKAMAI_CLIENT_TOKEN": "...",
        "AKAMAI_ACCESS_TOKEN": "...",
        "AKAMAI_HOST": "..."
      }
    }
  }
}

Development

Adding new API tools

  1. Generate the API client: add the OpenAPI spec URL to generate-clients.sh (in the parent workspace) and run it

  2. Create a wrapper in src/akamai/apis/<api-name>/

  3. Add tool registration files under src/tools/<api-name>/

  4. Register the tools in src/tools/index.ts

Project structure

src/
├── index.ts                          # Entry point (McpServer + STDIO transport)
├── akamai/
│   ├── client.ts                     # Namespaced client hub (edgeDiagnostics, future APIs)
│   ├── customFetch.ts                # EdgeGrid-authenticated fetch
│   ├── generateAkamaiToken.ts        # EdgeGrid auth token generation
│   └── apis/
│       └── edge-diagnostics/
│           ├── index.ts              # Client factory & re-exports
│           └── v1/                   # Auto-generated API client
└── tools/
    ├── index.ts                      # Tool registration hub
    ├── utils.ts                      # Polling, formatting helpers
    └── edge-diagnostics/             # One file per tool or tool group
A
license - permissive license
-
quality - not tested
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/amankrokx/mcp-connector-for-akamai'

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