ComputeNexa

io.github.computenexa-gpuInfrastructurePublished by GitHub account computenexa-gpuInfrastructurev0.1.0Updated Nov 1, 2026

Find, launch and stop private GPUs on ComputeNexa, with a quote before anything is charged.

VerifiedSTDIODesktop onlyCloud & InfrastructureFinance

Overview

AI-generated overview

Lets an assistant browse, launch, extend and stop private GPU machines on ComputeNexa, with a price quote before anything is charged.

What you can do
  • Check the API key's identity, team balance, GPU limit and permissions
  • List GPUs with live hourly prices and stock, and the apps and models each can run
  • List machines and inspect one for connection details, time left and costs
  • Review spending, GPU-hours, finished sessions and saved projects
  • Launch, extend or auto-renew machines, and stop them
  • Create endpoints and retrieve their keys
When to use it
Useful when you rent GPU capacity on ComputeNexa and want an assistant to compare prices and stock, start a machine with a chosen app, or check and stop running machines without leaving the chat.
Requirements
Runs locally over stdio via uvx, so uv must be installed. Requires a ComputeNexa API key in CNX_API_KEY, created in the dashboard as look-only or launch-and-stop. Optional CNX_MCP_MAX_LAUNCH_USD caps per-call spending (default 25). Network access to the ComputeNexa API.
Before you install
Launching, extending and keep-running spend money from the team's prepaid balance; the server quotes first and needs a second confirmed call, and assistants should never confirm on their own. stop_machine cannot be undone and deletes files outside a project. Endpoint keys grant access to your own server and are shown on request. The API key stays in local settings and is not returned in tool results.

Installation

In SourceWeft

  1. Open ComputeNexa in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

ComputeNexa MCP server

Let your AI assistant find, launch and stop private GPUs on ComputeNexa. Ask it "Which GPUs with 48 GB or more are in stock?", "Launch the cheapest one with Data Science for two hours" or "Stop it": it uses your team's API key, shows you what each launch costs, and only spends money after you agree.

Works with Claude Desktop, Claude Code, Cursor, VS Code and other assistants that support the Model Context Protocol. It runs on your computer and talks to the ComputeNexa API; your key stays in your own settings.

Set up

  1. In the ComputeNexa dashboard, open API keys and create a key:
    • Look only to browse GPUs, machines and spending;
    • Launch and stop to also launch, extend and stop machines.
  2. Install uv (it runs the server with uvx, no separate install needed).
  3. Add the server to your assistant (below), with your key as CNX_API_KEY.

Claude Code

bash
claude mcp add --env CNX_API_KEY=cnxk_... --transport stdio computenexa -- uvx computenexa-mcp

Add --scope user to use it in every project.

Claude Desktop

Settings → Developer → Edit config (claude_desktop_config.json):

json
{  "mcpServers": {    "computenexa": {      "command": "uvx",      "args": ["computenexa-mcp"],      "env": { "CNX_API_KEY": "cnxk_..." }    }  }}

Cursor

~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project): the same mcpServers entry as Claude Desktop.

VS Code

.vscode/mcp.json; VS Code asks for the key once and keeps it out of the file:

json
{  "inputs": [    { "type": "promptString", "id": "cnx-key", "description": "ComputeNexa API key", "password": true }  ],  "servers": {    "computenexa": {      "type": "stdio",      "command": "uvx",      "args": ["computenexa-mcp"],      "env": { "CNX_API_KEY": "${input:cnx-key}" }    }  }}

What it can do

ToolWhat it doesKey
whoamiYour email, team, balance, GPU limit and the key's permissionsany
list_gpusGPUs with live prices and stock, cheapest first; filter by app, region, memoryany
list_appsThe apps a GPU starts with, their models, and what's installedany
list_machines · get_machineYour machines; how to connect (SSH, browser apps, API or endpoint address)any
get_usage · list_receiptsSpending and GPU-hours; finished sessions and their costany
list_projects · list_endpointsSaved projects; Endpoints and the machine each points atany
launch_machineLaunch a GPU (quote first, then launch when you agree)launch and stop
extend_machineAdd time (quote first)launch and stop
set_keep_runningRenew a machine automatically until stopped (quote first)launch and stop
stop_machineEnd a machine now; unused time is refundedlaunch and stop
create_endpoint · get_endpoint_keyA stable HTTPS address for your own server; its keylaunch and stop

A look-only key only gets the read tools (the first six rows).

Safety

  • Nothing is charged without you. launch_machine, extend_machine and set_keep_running first return a quote, e.g. "NVIDIA RTX A6000 with the datascience app for 2 h: $1.44 charged now ($0.72/h); unused time is refunded if it stops early." Only a second call with confirm=true and the quoted total goes ahead; if the price went up in between, it's refused.
  • A limit per call: a launch, extension or keep-running renewal costing more than $25 is refused. Change it with CNX_MCP_MAX_LAUNCH_USD (in dollars) in the server's env. Your team's GPU limit and prepaid balance still apply on top.
  • Your API key never appears in a tool result. Endpoint keys are shown only when you create an endpoint or ask for its key.
  • Tools that spend money or end a machine are marked as such, so your assistant asks before using them.

Settings

Variable
CNX_API_KEYRequired. A ComputeNexa API key (cnxk_…)
CNX_MCP_MAX_LAUNCH_USDMost one call may spend, in US dollars. Default 25
CNX_API_URLOnly for testing against another ComputeNexa API

Develop

bash
uv syncuv run pytestuv run ruff check src tests

Built on the ComputeNexa Python SDK and the official MCP Python SDK.

Questions: [email protected] · Security issues: see SECURITY.md.

Source: README.md at commit d0cf599

Tools

15

whoami

Who am I

Who this server's API key acts as: email, team and role, the team's balance and GPU limit, and whether the key may launch and stop machines.

Takes no parameters.

list_gpus

List GPUs

GPUs with live prices (US dollars per GPU per hour) and stock, cheapest first.

Parametersappregionmin_memory_gbinclude_sold_out

list_apps

List apps

The apps a GPU can start with (basic, datascience, chat, imagegen, modelapi, voice): what each is for, the models it offers and which model we recommend per GPU memory. Give `app` for the software installed.

Parametersapppackage

list_machines

List machines

Your machines, newest first: state, GPU, app, price, time left and cost so far.

Parameterslimitwhole_teamactive_only

get_machine

Get a machine

One machine: its state, how to connect (SSH command, browser apps, API or endpoint address), time left, keep-running status and costs. Never its keys.

Parametersmachine_idrequired

get_usage

Get usage

Spending and GPU-hours over the last N days, by GPU, app, day and project.

Parametersdays

list_receipts

List receipts

Finished sessions and what each cost in the end (charged minus refunded).

Parametersdayslimit

list_projects

List projects

Saved projects (files restored into ~/work on machines launched with them) and their size.

Takes no parameters.

list_endpoints

List endpoints

Endpoints: stable HTTPS addresses for your own server on a machine's port 8000, and the machine each points at now. Never their keys.

Takes no parameters.

launch_machine

Launch a machine

Launch a GPU machine. Costs money: call first with confirm=false to get a quote (nothing happens), show it to the person, and only after they agree call again with the same arguments, confirm=true and expected_total_usd. The booked time is charged up front from the team's balance.

Parametersapprequiredgpurequiredhoursrequiredlabelmodelregionconfirmprojectendpointgpu_countexpected_total_usdkeep_running_hours

extend_machine

Extend a machine

Add time to a machine at the price it launched with. Costs money: quote first (confirm=false), then confirm=true with expected_total_usd once the person agrees.

Parametershoursrequiredconfirmmachine_idrequiredexpected_total_usd

set_keep_running

Keep a machine running

Keep running: the machine renews itself `hours` at a time from the team's balance, at its launch price, until it's stopped. Turning it on spends money at every renewal: quote first, then confirm=true with expected_renewal_usd. Turning it off (hours=null) needs no confirmation.

Parametershoursrequiredconfirmmachine_idrequiredexpected_renewal_usd

stop_machine

Stop a machine

End a machine now: stopped if running, cancelled with a full refund if still starting. Files outside a project are deleted; a project is saved first. Unused time is refunded. Can't be undone.

Parametersmachine_idrequired

create_endpoint

Create an endpoint

A new Endpoint (owners and admins): a stable HTTPS address and key for your own server on port 8000, e.g. one per customer you serve. Launch machines for it with launch_machine(endpoint=...). Free. Its key is shown once here; get_endpoint_key shows it again.

Parametersnamerequired

get_endpoint_key

Get an endpoint's key

An Endpoint's key (owners and admins). Only when the person asks for it: it gives access to their server.

Parametersendpointrequired

Version history

1
  1. v0.1.0LatestNov 1, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts