estimate_provider_earnings

Estimate what a provider earns per month on Lium by listing GPUs of a model, as the rewards calculator does: rental income (95% of the renter price) and rented extra at the last 30 days' utilisation, plus idle pay at the validator's rate for every unrented hour; with what those GPUs actually earned and the middle-half range across providers. Use when someone asks what their GPUs could earn on Lium; for renting GPUs use search_gpus. An estimate, not a guarantee.

read-only

Argument	Type	Description
gpu*	string	GPU model, e.g. H100, B200, RTX 4090 (case and spacing ignored)
count	integer	How many GPUs of that model (default 1)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "gpu"
  ],
  "properties": {
    "gpu": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "GPU model, e.g. H100, B200, RTX 4090 (case and spacing ignored)"
    },
    "count": {
      "type": "integer",
      "default": 1,
      "maximum": 64,
      "minimum": 1,
      "description": "How many GPUs of that model (default 1)"
    }
  }
}

get_balance

Your Lium balance in USD.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_gpu_prices

Live price range (min, median, max USD per GPU-hour) and free GPU count for each GPU model rentable on Lium right now. Use for "what does an H100 cost" or comparing models; use search_gpus to pick a node to rent. Pass count for multi-GPU quotes: a 1-GPU price can come from a node with one free GPU.

read-only

Argument	Type	Description
gpu	string	GPU model, e.g. H100, H200, B200, RTX 4090 (case and spacing ignored)
count	integer	GPUs needed on one node: prices only nodes that can rent that many
country	string	Two-letter country code, e.g. US, DE

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "gpu": {
      "type": "string",
      "description": "GPU model, e.g. H100, H200, B200, RTX 4090 (case and spacing ignored)"
    },
    "count": {
      "type": "integer",
      "maximum": 64,
      "minimum": 1,
      "description": "GPUs needed on one node: prices only nodes that can rent that many"
    },
    "country": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "Two-letter country code, e.g. US, DE"
    }
  }
}

get_pod

One pod: status, ssh command (once RUNNING), price per hour and spend so far.

read-only

Argument	Type	Description
pod_id*	string	Pod id from rent_pod or list_pods

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "pod_id"
  ],
  "properties": {
    "pod_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Pod id from rent_pod or list_pods"
    }
  }
}

list_pods

Your Lium pods with status, ssh command and price per hour.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_templates

Docker templates a pod can start from (official ones, your own and other users' public ones; official and yours mark which), for rent_pod template_id.

read-only

Argument	Type	Description
search	string	Filter by name or image, e.g. pytorch, vllm

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "search": {
      "type": "string",
      "description": "Filter by name or image, e.g. pytorch, vllm"
    }
  }
}

read_page

Return the raw Markdown source for a documentation page. Accepts a full URL, absolute slug (e.g. /providers/quickstart), or basename (e.g. quickstart). On tie among basenames, prefers pages in audience order: Providers > Validators > Renters > Developers.

read-only

Argument	Type	Description
url_or_slug*	string	Full URL (https://docs.lium.io/providers/quickstart), absolute slug (/providers/quickstart), or basename (quickstart)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url_or_slug"
  ],
  "properties": {
    "url_or_slug": {
      "type": "string",
      "description": "Full URL (https://docs.lium.io/providers/quickstart), absolute slug (/providers/quickstart), or basename (quickstart)"
    }
  }
}

remove_pod

Request pod deletion. Billing stops when accepted; deletion may finish asynchronously (get_pod shows DELETING). Data on the pod is lost.

destructive

Argument	Type	Description
pod_id*	string	Pod id from rent_pod or list_pods

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "pod_id"
  ],
  "properties": {
    "pod_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Pod id from rent_pod or list_pods"
    }
  }
}

rent_pod

Rent a GPU pod on Lium with your API key and wait until it runs; returns the pod id and the ssh command. Spends money from your Lium balance: the pod is billed per second until remove_pod, also when idle. Give gpu (and count, optional max_price_per_gpu_hour and country) to let Lium pick the cheapest matching node, or node_id from search_gpus alone for that node. idempotency_key is required: if a call fails or times out, retry with the same key within 24 hours so it cannot rent twice.

Argument	Type	Description
gpu	string	GPU model, e.g. H100, RTX 4090; Lium picks the cheapest node that fits
name	string	Pod name
count	integer	GPUs on one node (default: 1 with gpu, every free GPU with node_id)
country	string	Two-letter country code (with gpu, not node_id)
node_id	string	A node id from search_gpus, to rent that node
template_id	string	From list_templates; default: Lium's PyTorch image for the node
wait_seconds	integer	How long to wait for the pod to run (default 25, max 50)
ssh_public_key	string	OpenSSH public key to log in with (e.g. ~/.ssh/id_ed25519.pub); default: the keys saved on your Lium account

search

Search the Lium documentation for pages matching the query. Use for how-to questions (renting, SSH, templates, providing GPUs); for live GPU availability or prices use search_gpus or get_gpu_prices instead. Optionally filter by audience (providers, validators, pod-users, developers); without one, pages for the other side (renter or provider, guessed from the query) rank lower.

read-only

Argument	Type	Description
limit	integer	Maximum number of results to return (default 10, max 50)
query*	string	Search query
audience	string	Filter results to a specific audience section

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of results to return (default 10, max 50)"
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "audience": {
      "enum": [
        "providers",
        "validators",
        "pod-users",
        "developers"
      ],
      "type": "string",
      "description": "Filter results to a specific audience section"
    }
  }
}

search_gpus

List GPU nodes that can be rented on Lium right now, cheapest per GPU-hour first, with live USD prices and a rent link for each. Use when the user wants a specific machine (GPU model, count, country, price cap); use get_gpu_prices for a price overview. Each node has tier (secure or spot), reliability_score and min_gpus_per_rental (some nodes rent only whole). Read-only: next_step says how to rent one.

read-only

Argument	Type	Description
gpu	string	GPU model, e.g. H100, H200, B200, RTX 4090 (case and spacing ignored)
count	integer	GPUs needed on one node
limit	integer	Max nodes to return (default 10, max 50)
country	string	Two-letter country code, e.g. US, DE
max_price_per_gpu_hour	number	Price cap in USD per GPU-hour

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "gpu": {
      "type": "string",
      "description": "GPU model, e.g. H100, H200, B200, RTX 4090 (case and spacing ignored)"
    },
    "count": {
      "type": "integer",
      "maximum": 64,
      "minimum": 1,
      "description": "GPUs needed on one node"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Max nodes to return (default 10, max 50)"
    },
    "country": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "Two-letter country code, e.g. US, DE"
    },
    "max_price_per_gpu_hour": {
      "type": "number",
      "description": "Price cap in USD per GPU-hour",
      "exclusiveMinimum": 0
    }
  }
}

Lium GPU Cloud: live GPU prices and rent links

Try it

estimate_provider_earnings Read-only

Lium GPU Cloud: live GPU prices and rent links

Try it

estimate_provider_earnings Read-only

Tools (11)