How do I install Kilawatt?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Kilawatt need an API key?

The publisher lists these environment variables: KILAWATT_API_KEY, KILAWATT_BASE_URL, KILAWATT_SITE_URL, KILAWATT_X402_PRIVATE_KEY, KILAWATT_X402_MAX_USD_PER_JOB, KILAWATT_X402_MAX_USD_PER_SESSION, KILAWATT_X402_URL.

What transport does Kilawatt use?

Kilawatt runs locally over stdio.

When was Kilawatt last checked?

Last checked 2026-11-09. Kilawatt Cloud MCP server: request GPU compute with account or x402 payments.

Kilawatt MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

KILAWATT_API_KEY — Your API key for the service
KILAWATT_BASE_URL — Optional gateway endpoint override
KILAWATT_SITE_URL — Optional site root for the discovery and resume tools
KILAWATT_X402_PRIVATE_KEY — Wallet private key for paying for x402 jobs
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

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1KILAWATT_API_KEY=<secret> KILAWATT_BASE_URL=<value> KILAWATT_SITE_URL=<value> KILAWATT_X402_PRIVATE_KEY=<secret> KILAWATT_X402_MAX_USD_PER_JOB=<value> KILAWATT_X402_MAX_USD_PER_SESSION=<value> KILAWATT_X402_URL=<value> claude mcp add io.github.kilawattcloud-kilawatt-mcp-server -- npx -y kilawatt-mcp-server@0.3.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.kilawattcloud-kilawatt-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "KILAWATT_API_KEY": "<secret>",11        "KILAWATT_BASE_URL": "<value>",12        "KILAWATT_SITE_URL": "<value>",13        "KILAWATT_X402_PRIVATE_KEY": "<secret>",14        "KILAWATT_X402_MAX_USD_PER_JOB": "<value>",15        "KILAWATT_X402_MAX_USD_PER_SESSION": "<value>",16        "KILAWATT_X402_URL": "<value>"17      }18    }19  }20}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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.

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

Works with

goose (step-by-step guide: docs/GOOSE_TUTORIAL.md)
Claude Desktop
Cursor
LangChain and LangGraph (example)
CrewAI (example)
SkyPilot (example)
Node.js client (example)
MCP Python SDK (example)

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.

Installation

Install and run via npx:

npx -y kilawatt-mcp-server

Configuration

Set your Kilawatt API key to use deploy_gpu_node. It is not required to start the server or use the x402 tools:

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 [email protected] 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 four tools: deploy_gpu_node, x402_quote, x402_run_job and x402_job_status.

`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.

Parameter	Type	Required	Default	Allowed values	Description
`gpu_type`	string	No	`nvidia-h100`	Any non-empty string up to 64 characters (no enum is checked locally)	GPU model identifier; the gateway decides what it accepts
`card_count`	integer	No	`1`	1 to 64	Number of GPUs
`duration_seconds`	number	No	`600`	1 to 86400	How long the node is needed. Billed up front.
`routing_policy`	string	No	`lowest_cost`	`lowest_cost`, `lowest_latency`, `zero_quota`	How the smart order router picks a node
`dry_run`	boolean	No	`false`	`true`, `false`	Price 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.

Parameter	Type	Required	Default	Allowed values	Description
`gpu_type`	string	No	`nvidia-h100`	`nvidia-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-3090`	GPU model
`card_count`	integer	No	`1`	1 to 4 for `nvidia-b200`; 1 to 8 for `nvidia-h100`, `nvidia-h200`, `nvidia-a100`, `nvidia-l40s`; 1 to 16 for all others	Number of GPUs
`duration_seconds`	number	No	`600`	60 to 86400	Job length in seconds
`routing_policy`	string	No	not sent	`lowest_cost`, `lowest_latency`, `zero_quota`	Routing policy
`workload_type`	string	No	not sent	`agent_exec`, `fine_tune`, `batch_inference`	Workload 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:

Parameter	Type	Required	Description
`max_usd`	number	Yes	Must be greater than 0. Payment is refused above this amount or above either spend cap.
`confirm`	boolean	Yes	Must 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.

Parameter	Type	Required	Description
`job_id`	string	Yes	1 to 128 characters

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:

Variable	Purpose	Default
`KILAWATT_X402_PRIVATE_KEY`	Base-compatible wallet key, needed only to pay with `x402_run_job`	Not set
`KILAWATT_X402_MAX_USD_PER_JOB`	Maximum price for one paid job	`0.25`
`KILAWATT_X402_MAX_USD_PER_SESSION`	Maximum cumulative spend in this server process	`1.00`
`KILAWATT_X402_URL`	Override the x402 execution endpoint	Kilawatt 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 [email protected].
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.

License

MIT

Kilawatt

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Kilawatt?

Does Kilawatt need an API key?

What transport does Kilawatt use?

When was Kilawatt last checked?

Documentation

Kilawatt Cloud MCP Server

Table of contents

Works with

Endpoint

Installation

Configuration

Use with Claude Desktop / Cursor

Running the Server

Available Tools

`deploy_gpu_node`

`x402_quote`

`x402_run_job`

`x402_job_status`

Differences between `deploy_gpu_node` and the x402 tools

x402 settings

Error Handling

Links

License

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Kilawatt?

Does Kilawatt need an API key?

What transport does Kilawatt use?

When was Kilawatt last checked?

Documentation

Kilawatt Cloud MCP Server

Table of contents

Works with

Endpoint

Installation

Configuration

Use with Claude Desktop / Cursor

Running the Server

Available Tools

deploy_gpu_node

x402_quote

x402_run_job

x402_job_status

Differences between deploy_gpu_node and the x402 tools

x402 settings

Error Handling

Links

License

`deploy_gpu_node`

`x402_quote`

`x402_run_job`

`x402_job_status`

Differences between `deploy_gpu_node` and the x402 tools