Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Kilawatt MCP Server

by KilaWattCloudversion 0.3.0i★ 0iRuns on your computerRepository ↗
Registry nameio.github.KilaWattCloud/kilawatt-mcp-server

How to install

What it does

Kilawatt Cloud MCP server: request GPU compute with account or x402 payments.

  • Connects Runs on your computer
  • Account or key Needs KILAWATT_API_KEY, KILAWATT_X402_PRIVATE_KEY
  • Category Other

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score12/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Kilawatt MCP Server. Follow https://mcp.popnx.com/i/kilawattcloud-kilawatt-mcp-server.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a Kilawatt MCP Server key (create it on the maker’s site) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Kilawatt MCP Server for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "kilawatt": { "command": "npx", "args": [ "-y", "kilawatt-mcp-server" ], "env": { "KILAWATT_API_KEY": "your-value", "KILAWATT_X402_PRIVATE_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For KILAWATT_API_KEY, KILAWATT_X402_PRIVATE_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Kilawatt MCP Server tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Kilawatt MCP Server key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  4. Paste these settings and save the file

    {
      "mcpServers": {
        "kilawatt": {
          "command": "npx",
          "args": [
            "-y",
            "kilawatt-mcp-server"
          ],
          "env": {
            "KILAWATT_API_KEY": "your-value",
            "KILAWATT_X402_PRIVATE_KEY": "your-value"
          }
        }
      }
    }

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Quit Claude and open it again

  6. Try it

    Use Kilawatt MCP Server and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Kilawatt MCP Server or shows a Kilawatt MCP Server tool in the answer, you are connected

5 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • KILAWATT_BASE_URL Optional gateway endpoint override
  • KILAWATT_SITE_URL Optional site root for the discovery and resume tools
  • KILAWATT_X402_MAX_USD_PER_JOB Maximum USD spend per x402 job (default 0.25)
  • KILAWATT_X402_MAX_USD_PER_SESSION Maximum USD spend per server session (default 1.00)
  • KILAWATT_X402_URL Optional x402 execution endpoint override

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Kilawatt MCP Server yet

Kilawatt MCP Server runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Kilawatt MCP Server

  • You need a Kilawatt MCP Server key (create it on the maker’s site) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • You need a Kilawatt MCP Server key (create it on the maker’s site) · Install Node.js on your computer first (one time)
  • You need a Kilawatt MCP Server key (create it on the maker’s site) · Install Node.js on your computer first (one time)
  • You need a Kilawatt MCP Server key (create it on the maker’s site) · Install Node.js on your computer first (one time)

B · Others in Other that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

You need a Kilawatt MCP Server key (create it on the maker’s site) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Kilawatt MCP Server for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user kilawatt --env KILAWATT_API_KEY=your-value --env KILAWATT_X402_PRIVATE_KEY=your-value -- npx -y kilawatt-mcp-server 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For KILAWATT_API_KEY, KILAWATT_X402_PRIVATE_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Kilawatt MCP Server tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Kilawatt MCP Server key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  4. Paste this command and press Enter

    claude mcp add --scope user kilawatt --env KILAWATT_API_KEY=your-value --env KILAWATT_X402_PRIVATE_KEY=your-value -- npx -y kilawatt-mcp-server

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Type /mcp in Claude Code

    You should see Kilawatt MCP Server listed as connected

  6. Try it

    Use Kilawatt MCP Server and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Kilawatt MCP Server or shows a Kilawatt MCP Server tool in the answer, you are connected

5 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • KILAWATT_BASE_URL Optional gateway endpoint override
  • KILAWATT_SITE_URL Optional site root for the discovery and resume tools
  • KILAWATT_X402_MAX_USD_PER_JOB Maximum USD spend per x402 job (default 0.25)
  • KILAWATT_X402_MAX_USD_PER_SESSION Maximum USD spend per server session (default 1.00)
  • KILAWATT_X402_URL Optional x402 execution endpoint override

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a Kilawatt MCP Server key (create it on the maker’s site) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Kilawatt MCP Server for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "kilawatt": { "command": "npx", "args": [ "-y", "kilawatt-mcp-server" ], "env": { "KILAWATT_API_KEY": "your-value", "KILAWATT_X402_PRIVATE_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For KILAWATT_API_KEY, KILAWATT_X402_PRIVATE_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Kilawatt MCP Server tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Kilawatt MCP Server key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  4. Fill in your key

    In the Kilawatt MCP Server settings, KILAWATT_API_KEY, KILAWATT_X402_PRIVATE_KEY is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in Cursor in Agent mode

  6. Try it

    Use Kilawatt MCP Server and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Kilawatt MCP Server or shows a Kilawatt MCP Server tool in the answer, you are connected

5 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • KILAWATT_BASE_URL Optional gateway endpoint override
  • KILAWATT_SITE_URL Optional site root for the discovery and resume tools
  • KILAWATT_X402_MAX_USD_PER_JOB Maximum USD spend per x402 job (default 0.25)
  • KILAWATT_X402_MAX_USD_PER_SESSION Maximum USD spend per server session (default 1.00)
  • KILAWATT_X402_URL Optional x402 execution endpoint override

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a Kilawatt MCP Server key (create it on the maker’s site) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Kilawatt MCP Server for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "kilawatt": { "type": "stdio", "command": "npx", "args": [ "-y", "kilawatt-mcp-server" ], "env": { "KILAWATT_API_KEY": "your-value", "KILAWATT_X402_PRIVATE_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For KILAWATT_API_KEY, KILAWATT_X402_PRIVATE_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Kilawatt MCP Server tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Kilawatt MCP Server key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  4. Fill in your key

    In the Kilawatt MCP Server settings, KILAWATT_API_KEY, KILAWATT_X402_PRIVATE_KEY is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in VS Code in Agent mode

  6. Try it

    Use Kilawatt MCP Server and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Kilawatt MCP Server or shows a Kilawatt MCP Server tool in the answer, you are connected

5 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • KILAWATT_BASE_URL Optional gateway endpoint override
  • KILAWATT_SITE_URL Optional site root for the discovery and resume tools
  • KILAWATT_X402_MAX_USD_PER_JOB Maximum USD spend per x402 job (default 0.25)
  • KILAWATT_X402_MAX_USD_PER_SESSION Maximum USD spend per server session (default 1.00)
  • KILAWATT_X402_URL Optional x402 execution endpoint override

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Kilawatt MCP Server💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user kilawatt --env KILAWATT_API_KEY=your-value --env KILAWATT_X402_PRIVATE_KEY=your-value -- npx -y kilawatt-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "kilawatt": {
      "command": "npx",
      "args": [
        "-y",
        "kilawatt-mcp-server"
      ],
      "env": {
        "KILAWATT_API_KEY": "your-value",
        "KILAWATT_X402_PRIVATE_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "kilawatt": {
      "command": "npx",
      "args": [
        "-y",
        "kilawatt-mcp-server"
      ],
      "env": {
        "KILAWATT_API_KEY": "your-value",
        "KILAWATT_X402_PRIVATE_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "kilawatt": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kilawatt-mcp-server"
      ],
      "env": {
        "KILAWATT_API_KEY": "your-value",
        "KILAWATT_X402_PRIVATE_KEY": "your-value"
      }
    }
  }
}

Values you fill in

  • KILAWATT_API_KEY secret required env
    Your API key for the service
  • KILAWATT_BASE_URL env
    Optional gateway endpoint override
  • KILAWATT_SITE_URL env
    Optional site root for the discovery and resume tools
  • KILAWATT_X402_PRIVATE_KEY secret required env
    Wallet private key for paying for x402 jobs
  • KILAWATT_X402_MAX_USD_PER_JOB env
    Maximum USD spend per x402 job (default 0.25)
  • KILAWATT_X402_MAX_USD_PER_SESSION env
    Maximum USD spend per server session (default 1.00)
  • KILAWATT_X402_URL env
    Optional x402 execution endpoint override

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
84/wk
Connection
Runs on your computer
Latest versioni
0.3.0
Categoryi
Other
Published to registryi
Oct 21, 2026
Code last changedi
Nov 14, 2026
Maker
KilaWattCloud
Packages
npm: kilawatt-mcp-server
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account KilaWattCloud, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 5 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for kilawatt-mcp-server@0.3.0

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/kilawattcloud-kilawatt-mcp-server.svg)](https://mcp.popnx.com/en/servers/kilawattcloud-kilawatt-mcp-server)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Otheri

  • More stars than 0% of the other 20613 servers in this category
  • Published to the registry more recently than 60% of the other 20613 servers in this category
  • Basic checks equal to or better than 99% of the other 20613 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Kilawatt MCP Server safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: KILAWATT_API_KEY, KILAWATT_X402_PRIVATE_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 5 days ago, and the latest version (0.3.0) reached the registry 29 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

by koala73Widely used★ 90.9KUpdated 3 days ago

Runs in the cloud✓ service owner · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

by openstatusHQWidely used★ 9.3KUpdated 2 months ago

Runs in the cloud✓ service owner · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

by JanDeDobbeleerWidely used★ 23.8K Stars for the whole repoUpdated 30 days ago

Runs in the cloud✓ service owner · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

by Klavis-AIGrowing★ 5.8KUpdated 14 months ago

Runs in the cloudRepo archived✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

by jitsucomWidely used★ 5.1KUpdated 4 months ago

Runs in the cloud✓ service owner · jitsu.com
Compared with similar ones
This one
Kilawatt MCP Server
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyYesNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks3/34/44/44/41/44/4
LicenseMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Kilawatt Cloud MCP Server

Model Context Protocol (MCP) server for requesting GPU compute capacity from Kilawatt Cloud, with account-based and x402 payment options.

This server calls the real Kilawatt gateways. Every response is an actual HTTP result from the Kilawatt public API or the x402 endpoint. There are no fabricated responses.

Table of contents

  • Works with
  • Endpoint
  • Installation
  • Configuration
  • Use with Claude Desktop / Cursor
  • Running the Server
  • Available Tools
  • Error Handling
  • Links
  • License

Works with

All examples are quote-only. See examples/README.md.

Client setup steps are in docs/clients.md.

Endpoint

The default endpoint is Kilawatt Cloud's gateway: https://www.kilawattcloud.dev/api/public/v1. Change it with the KILAWATT_BASE_URL environment variable.

The discovery and resume tools (get_capacity, get_platform_status, get_pricing, get_resume_info and resume_job) use the site root instead: https://www.kilawattcloud.dev. Change it with the optional KILAWATT_SITE_URL environment variable. A trailing slash is removed.

VariableUsed byDefault
KILAWATT_BASE_URLdeploy_gpu_nodehttps://www.kilawattcloud.dev/api/public/v1
KILAWATT_SITE_URLget_capacity, get_platform_status, get_pricing, get_resume_info, resume_jobhttps://www.kilawattcloud.dev

Installation

Install and run via npx:

npx -y kilawatt-mcp-server

Configuration

Set your Kilawatt API key to use deploy_gpu_node, get_resume_info or resume_job. It is not required to start the server, use the x402 tools, or use get_capacity, get_platform_status and get_pricing:

export KILAWATT_API_KEY=kw_live_YOUR_KEY_HERE

The API key must start with kw_live_. API keys are issued through your Kilawatt Cloud account. Contact hello@kilawattcloud.dev for assistance if you don't have access to generate keys yet.

Use with Claude Desktop / Cursor

Add this configuration to your MCP client settings:

{

"mcpServers": { "kilawatt": { "command": "npx", "args": ["-y", "kilawatt-mcp-server"], "env": { "KILAWATT_API_KEY": "kw_live_YOUR_KEY_HERE" } } } }

Replace kw_live_YOUR_KEY_HERE with your Kilawatt API key when using deploy_gpu_node. For x402-only use, omit KILAWATT_API_KEY.

Using goose? See GOOSE.md.

Running the Server

Start the MCP server:

npm start

Or directly:

node index.js

The server listens on stdio for MCP requests from your agent.

Available Tools

The server exposes nine tools: deploy_gpu_node, x402_quote, x402_run_job, x402_job_status, get_capacity, get_platform_status, get_pricing, get_resume_info and resume_job.

deploy_gpu_node

Provision real GPU compute on Kilawatt Cloud. This starts an actual machine and charges the caller's Kilawatt wallet. Set dry_run: true to check pricing and routing without provisioning or charging. Requires KILAWATT_API_KEY.

ParameterTypeRequiredDefaultAllowed valuesDescription
gpu_typestringNonvidia-h100Any non-empty string up to 64 characters (no enum is checked locally)GPU model identifier; the gateway decides what it accepts
card_countintegerNo11 to 64Number of GPUs
duration_secondsnumberNo6001 to 86400How long the node is needed. Billed up front.
routing_policystringNolowest_costlowest_cost, lowest_latency, zero_quotaHow the smart order router picks a node
dry_runbooleanNofalsetrue, falsePrice and pre-authorize only
{

"name": "deploy_gpu_node", "arguments": { "card_count": 2, "duration_seconds": 1800, "dry_run": true } }

x402_quote

Get the current price and Base USDC payment details for a GPU job without paying.

ParameterTypeRequiredDefaultAllowed valuesDescription
gpu_typestringNonvidia-h100nvidia-b300, nvidia-b200, nvidia-h200, nvidia-h100, nvidia-a100, nvidia-l40s, nvidia-l40, nvidia-a40, nvidia-a10, nvidia-rtx-a6000, nvidia-rtx-a5000, nvidia-rtx-a4500, nvidia-rtx-a4000, nvidia-rtx-5090, nvidia-rtx-4090, nvidia-rtx-3090GPU model
card_countintegerNo11 to 4 for nvidia-b200; 1 to 8 for nvidia-h100, nvidia-h200, nvidia-a100, nvidia-l40s; 1 to 16 for all othersNumber of GPUs
duration_secondsnumberNo60060 to 86400Job length in seconds
routing_policystringNonot sentlowest_cost, lowest_latency, zero_quotaRouting policy
workload_typestringNonot sentagent_exec, fine_tune, batch_inferenceWorkload type

The published input schema states a maximum of 16 for card_count. The tighter per-GPU limits above are enforced in code when the call is made.

x402_run_job

Quote and pay for one GPU job in Base USDC. Takes the same parameters as x402_quote, plus:

ParameterTypeRequiredDescription
max_usdnumberYesMust be greater than 0. Payment is refused above this amount or above either spend cap.
confirmbooleanYesMust be true or nothing is paid.
x402_job_status

Get the status of a job created through x402, using the API key saved locally by x402_run_job.

ParameterTypeRequiredDescription
job_idstringYes1 to 128 characters
get_capacity

Read current GPU capacity data. Read-only. No API key and no arguments. Calls GET {KILAWATT_SITE_URL}/api/capacity. If the data is not available right now (HTTP 503 with code unavailable), the tool says so.

{ "name": "get_capacity", "arguments": {} }
get_platform_status

Read the platform status. Read-only. No API key and no arguments. Calls GET {KILAWATT_SITE_URL}/api/status. The result has status (operational, degraded, incident or unknown), status_note, last_checked, status_page and latest_test_summary.

{ "name": "get_platform_status", "arguments": {} }
get_pricing

Read indicative USD prices per GPU hour for each GPU tier. Read-only. No API key and no arguments. Calls GET {KILAWATT_SITE_URL}/api/pricing. These prices are indicative only. The exact price for a job comes from an unpaid x402 request, for example x402_quote.

{ "name": "get_pricing", "arguments": {} }
get_resume_info

Check whether a job can be resumed from its last checkpoint. Read-only: nothing is started or charged. Requires KILAWATT_API_KEY. Calls GET {KILAWATT_SITE_URL}/api/jobs/{job_id}/resume-info.

ParameterTypeRequiredDescription
job_idstringYes36 characters, hex digits and dashes. Checked before any request is sent.

The result has job_id, checkpoint_count, last_checkpoint_at, can_resume, reason (null, no_checkpoint or job_still_running) and resume_action.

{ "name": "get_resume_info", "arguments": { "job_id": "YOUR_JOB_ID" } }
resume_job

Start a new paid run that resumes a job from its last checkpoint on a different supplier. This spends money. Requires KILAWATT_API_KEY. Call get_resume_info first and ask the user before confirming. Calls POST {KILAWATT_SITE_URL}/api/jobs/{job_id}/resume once and never retries it automatically.

ParameterTypeRequiredDescription
job_idstringYes36 characters, hex digits and dashes
confirmbooleanYesMust be exactly true
max_spend_usdnumberYesSpend cap for the new run. Must be greater than 0.
duration_secondsintegerNo60 to 86400. Sent only when given.

All of these are checked locally before any request is sent. If a check fails, nothing is sent.

{

"name": "resume_job", "arguments": { "job_id": "YOUR_JOB_ID", "confirm": true, "max_spend_usd": 5 } }

Differences between deploy_gpu_node and the x402 tools
  • gpu_type is free text (up to 64 characters) in deploy_gpu_node but a fixed list in the x402 tools.
  • card_count allows up to 64 in deploy_gpu_node but at most 16 (less for some GPUs) in the x402 tools.
  • duration_seconds allows 1 to 86400 in deploy_gpu_node but 60 to 86400 in the x402 tools.
  • deploy_gpu_node defaults routing_policy to lowest_cost; the x402 tools send no routing policy unless you set one.

Tool results are formatted from the real HTTP response returned by the Kilawatt gateway.

x402 settings

The x402 tools let you request capacity with Base USDC without a Kilawatt account or API key. Spend caps are enforced locally.

The server must be able to read the following environment variables when you use x402 payments:

VariablePurposeDefault
KILAWATT_X402_PRIVATE_KEYBase-compatible wallet key, needed only to pay with x402_run_jobNot set
KILAWATT_X402_MAX_USD_PER_JOBMaximum price for one paid job0.25
KILAWATT_X402_MAX_USD_PER_SESSIONMaximum cumulative spend in this server process1.00
KILAWATT_X402_URLOverride the x402 execution endpointKilawatt production endpoint

The returned API key is stored at ~/.config/kilawatt/x402-api-key with restrictive file permissions. It is never shown in tool output. Existing deploy_gpu_node still requires KILAWATT_API_KEY.

Use a separate small wallet for x402, and keep its private key out of prompts and shared configuration. The payer does not need ETH; the facilitator submits the transaction.

For x402 users: Check that your Base wallet has enough USDC and that your spend caps allow the amount.

Error Handling

All errors are descriptive and indicate whether anything was provisioned or charged. Common scenarios:

  • 400 Bad Request: Invalid arguments (e.g., card_count > 64). Fix and retry.
  • 401 Unauthorized: API key missing, malformed, or revoked. Issue a new key in your Kilawatt account or contact hello@kilawattcloud.dev.
  • 402 Payment Required: the payment was not accepted. Check your balance and spend caps, then retry.
  • 429 Rate Limited: Concurrency or rate limit hit. Retry after a delay.
  • 503 No Capacity: No nodes available matching your criteria. Try a different gpu_type or smaller card_count.
  • Timeout: Gateway did not respond within 60 seconds. No compute was provisioned; retry if needed.

Links

  • npm Package: https://www.npmjs.com/package/kilawatt-mcp-server
  • GitHub Repository: https://github.com/KilaWattCloud/kila

Only the beginning is shown; read the rest in the repo