Akamai Cloud VM MCP

An MCP server, built on Zuplo, that exposes Linode (Akamai Cloud Computing) Compute Instance management as tools for MCP clients such as Claude Desktop. Each MCP client brings its own Linode Personal Access Token (PAT) — this gateway never stores or has access to your credentials; it just forwards your Authorization header through to api.linode.com.

Tools exposed

Scoped to Compute Instance (VM) lifecycle management, not the full Linode API (a smaller, curated tool set keeps AI tool selection reliable):

Related MCP server: Linode MCP Server

Project structure

This is a standard Zuplo API gateway project — everything below config/ and modules/ is Zuplo's own project layout, not custom to this repo:

Deploy your own copy

This repo is meant to be forked and deployed to your own Zuplo account, not used against a shared instance run by someone else — your Linode PAT flows through whichever Zuplo project is running this gateway, so it should be one you control.

1. Fork this repository.

2. In the Zuplo portal, create a new project and connect it to your fork.

3. No environment variables or secrets need to be configured — auth is supplied per-request by the connecting MCP client (see below).

4. Deploy an environment from the portal and note its URL. Your MCP endpoint is https://<your-project>.zuplo.app/mcp.

Connect from Claude Desktop

1. Create a Linode Personal Access Token (Linode Cloud Manager → My Profile → API Tokens → Create a Personal Access Token) with at least linodes:read_write scope.

2. Add an entry to claude_desktop_config.json using mcp-remote to bridge Claude Desktop to the remote MCP endpoint with your token as a header:

   {
     "mcpServers": {
       "akamai-cloud-vm": {
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote",
           "https://<your-project>.zuplo.app/mcp",
           "--header",
           "Authorization: Bearer ${LINODE_TOKEN}"
         ],
         "env": {
           "LINODE_TOKEN": "<your Linode Personal Access Token>"
         }
       }
     }
   }

3. Restart Claude Desktop.

Local development

npm install
npm run dev

Starts the gateway at http://localhost:9000 (route designer at :9100, docs at :9200). Requires Node.js >= 24 for the Zuplo CLI.

Extending

All routing lives in config/routes.oas.json. To expose another Linode API operation as an MCP tool:

1. Add it as a new OpenAPI path/operation with a unique operationId, an x-zuplo-route.handler of urlForwardHandler pointed at baseUrl: "https://api.linode.com/v4", and x-zuplo-route.mcp.type: "tool".

2. Add a matching { "file": "./config/routes.oas.json", "id": "<operationId>" } entry to the /mcp route's mcpServerHandler operations array.

See Linode's API reference for other available resources (Volumes, Domains, Images, LKE, NodeBalancers, Databases, etc.).