estimate_job_cost
Cost of one GPU job (not cost per hour) among tracked providers, cheapest current compute subtotal first.
gpu_family (e.g. 'H100', 'A100 80GB') or its alias gpu (same name compare_gpu_prices uses) is required; if both are given they must match, else invalid_argument. gpus_per_job defaults to 1. Ranking matches compare_gpu_prices' default: fresh rows first (a degraded price, older than 48 h, is shown and flagged but never ranked first while a fresh one exists), fresh on-demand before community/marketplace rows, then compute subtotal ascending; the summary names any cheaper fresh rate ranked lower. If no fresh price exists, stale_fallback=true and the summary says the top row is not a current price.
You supply the duration: job_hours, OR work_units plus throughput_units_per_gpu_hour from your own benchmark (job_hours = work_units / (throughput x gpus_per_job)). If you give workload + work_units but no throughput, a directly applicable published figure (closed-division MLPerf Inference, exact GPU variant, inference only) is used: throughput_basis='published_benchmark' with throughput_source {url, quote, date, benchmark, derived, caveats}; your throughput always wins. Otherwise not_found 'missing: throughput for {gpu}'. Whole-instance billing: instances = ceil(gpus_per_job / gpus_per_instance), all allocated GPUs billed (9 GPUs on an 8-GPU-only offer bill 16). Reserved and held-stale rates are never ranked; spot/interruptible only if allow_interruptible. Each result has rate_id, source_url, verified_at, data_age_hours/degraded/stale. Response has assumptions, citations, missing_costs, budget_verdict (unresolved: extras unknown) and a quote_id. Compute subtotal only.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "estimate_job_cost"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gpu | No | ||
| mode | No | full | |
| top_n | No | ||
| region | No | ||
| workload | No | ||
| job_hours | No | ||
| gpu_family | No | ||
| work_units | No | ||
| min_vram_gb | No | ||
| gpus_per_job | No | ||
| runs_per_month | No | ||
| max_data_age_hours | No | ||
| allow_interruptible | No | ||
| throughput_units_per_gpu_hour | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| mode | No | ||
| error | No | ||
| receipt | No | ||
| results | No | ||
| quote_id | No | ||
| issued_at | No | ||
| quote_basis | No | ||
| budget_verdict | No | ||
| referral_disclosure | No | One-line referral disclosure, present whenever the result names a provider; each provider-naming item then has tracked_url (tagged /go/ redirect). |