corpusAI Cloud Pricing

Official35 tools

by JTraversa · JavaScript

Cloud, GPU and LLM token prices with index fixings. Pay per call over x402 or with a prepaid key.

This MCP server provides cloud pricing details, including spot, on-demand, reserved, and GPU rental prices. It also supports index fixings and is billed per call, over x402. The server description indicates pricing coverage across these categories with call-based usage.

🛠️ Key Features

Spot, on-demand, reserved cloud pricing
GPU rental prices
Index fixings
Paid per call, over x402

🚀 Use Cases

Looking up cloud price options across spot/on-demand/reserved
Retrieving GPU rental pricing
Applying or referencing index fixings for price calculations
Estimating cost based on per-call billing (over x402)

⚡ Developer Benefits

Focused pricing data retrieval across multiple cloud models
Supports additional pricing context via index fixings
Call-based usage model aligned with MCP integrations

⚠️ Limitations

Only pricing scope is described (no additional functions, tools, or endpoints provided)

Captured live from the server via tools/list.

health

Free. Liveness and store readiness. Returns 200 whenever the server is up. `ready` is false while the store is still ingesting after a restart; paid endpoints answer 503 (and take no payment) until it is true.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

catalog

Free. Providers, regions, coverage window and event counts. One row per (provider, region) with raw-event coverage (instance types, events, first/last event) and legacy-history coverage (daily and monthly date ranges), plus `sources`, the legend explaining every `source` value returned by /spot/daily and /spot/monthly. Use the `region` values here verbatim in every other call.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

instances

Free. Instance types available in a region. Exact type names with per-type coverage: raw events (`events`, `first_event`, `last_event`; zero/null for types that only exist in the legacy history) and legacy history ranges (`history_daily_from/to`, `history_monthly_from/to`). Optional `prefix` narrows the list (for example `c5.` or `n2-`).

Parameters3

provider	string	required	Cloud provider. One of `aws`, `gcp`, `azure`.
region	string	required	Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1
prefix	string	optional	Case-sensitive prefix filter on the type name.

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "aws",
        "gcp",
        "azure"
      ],
      "description": "Cloud provider. One of `aws`, `gcp`, `azure`."
    },
    "region": {
      "type": "string",
      "description": "Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1"
    },
    "prefix": {
      "type": "string",
      "description": "Case-sensitive prefix filter on the type name."
    }
  },
  "required": [
    "provider",
    "region"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

spot_events

Paid (0.01 USDC per call). Raw spot price-change events for one instance type. Every price change for the type in the window, with exact timestamp, availability zone and product (OS). Sorted by time. Repeated identical prices are dropped by default (`include_repeats=true` keeps them). Up to `limit` rows; when `truncated` is true, continue with `from` = `next_from`.

Parameters9

provider	string	required	Cloud provider. One of `aws`, `gcp`, `azure`.
region	string	required	Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1
instance	string	required	Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large
from	string	optional	Start of the window (inclusive), ISO 8601 UTC. Default: 7 days before `to`.
to	string	optional	End of the window (exclusive), ISO 8601 UTC. Default: now.
az	string	optional	Restrict to one availability zone / zone id (for example `use1-az1`). Default: all zones.
product	string	optional	Restrict to one product / OS string (for example `Linux/UNIX`, `Spot`, `Linux`). Default: all.
include_repeats	boolean	optional	Keep events whose price equals the previous event of the same (az, product) series. Default false.
limit	integer	optional	Maximum rows to return (1 to 10000). Default 5000.

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "aws",
        "gcp",
        "azure"
      ],
      "description": "Cloud provider. One of `aws`, `gcp`, `azure`."
    },
    "region": {
      "type": "string",
      "description": "Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1"
    },
    "instance": {
      "type": "string",
      "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large"
    },
    "from": {
      "type": "string",
      "description": "Start of the window (inclusive), ISO 8601 UTC. Default: 7 days before `to`."
    },
    "to": {
      "type": "string",
      "description": "End of the window (exclusive), ISO 8601 UTC. Default: now."
    },
    "az": {
      "type": "string",
      "description": "Restrict to one availability zone / zone id (for example `use1-az1`). Default: all zones."
    },
    "product": {
      "type": "string",
      "description": "Restrict to one product / OS string (for example `Linux/UNIX`, `Spot`, `Linux`). Default: all."
    },
    "include_repeats": {
      "type": "boolean",
      "description": "Keep events whose price equals the previous event of the same (az, product) series. Default false."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum rows to return (1 to 10000). Default 5000."
    }
  },
  "required": [
    "provider",
    "region",
    "instance"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

spot_hourly

Paid (0.01 USDC per call). Hourly time-weighted OHLC bars for one instance type. Per-zone series are bucketed by UTC hour with time weighting (a price counts for as long as it was in force), then collapsed across zones: open/close/avg are the median across zones, high is the max, low is the min. Window is capped at 366 days.

Parameters5

provider	string	required	Cloud provider. One of `aws`, `gcp`, `azure`.
region	string	required	Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1
instance	string	required	Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large
from	string	optional	Start of the window (inclusive), ISO 8601 UTC. Default: 30 days before `to`.
to	string	optional	End of the window (exclusive), ISO 8601 UTC. Default: now.

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "aws",
        "gcp",
        "azure"
      ],
      "description": "Cloud provider. One of `aws`, `gcp`, `azure`."
    },
    "region": {
      "type": "string",
      "description": "Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1"
    },
    "instance": {
      "type": "string",
      "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large"
    },
    "from": {
      "type": "string",
      "description": "Start of the window (inclusive), ISO 8601 UTC. Default: 30 days before `to`."
    },
    "to": {
      "type": "string",
      "description": "End of the window (exclusive), ISO 8601 UTC. Default: now."
    }
  },
  "required": [
    "provider",
    "region",
    "instance"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

spot_daily

Paid (0.05 USDC per call). Full daily history for one instance type, all eras stitched. One row per UTC day from the earliest data for the type to now. Rows dated before the type's first raw event come from the legacy history (`source` = `pauley`: measured 2022-05 to 2024-01 AWS, open/high/low/close present on days the price moved; `titans`: daily average only, 2024 to 2026). Rows from `direct_from` on are time-weighted, zone-collapsed bars from the raw event store (`source` = `direct`, same method as /spot/hourly; `avg` equals the public dashboard value). open/high/low/close are null where the source only has an average.

Parameters5

provider	string	required	Cloud provider. One of `aws`, `gcp`, `azure`.
region	string	required	Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1
instance	string	required	Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large
from	string	optional	Start of the window (inclusive), ISO 8601 UTC. Default: the earliest row for the type.
to	string	optional	End of the window (exclusive), ISO 8601 UTC. Default: now.

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "aws",
        "gcp",
        "azure"
      ],
      "description": "Cloud provider. One of `aws`, `gcp`, `azure`."
    },
    "region": {
      "type": "string",
      "description": "Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1"
    },
    "instance": {
      "type": "string",
      "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large"
    },
    "from": {
      "type": "string",
      "description": "Start of the window (inclusive), ISO 8601 UTC. Default: the earliest row for the type."
    },
    "to": {
      "type": "string",
      "description": "End of the window (exclusive), ISO 8601 UTC. Default: now."
    }
  },
  "required": [
    "provider",
    "region",
    "instance"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

spot_monthly

Paid (0.05 USDC per call). Full monthly history for one instance type, back to 2014 for legacy AWS types. Calendar months from the earliest data to now. `months` is the curated series: `uscisi-adjusted` months (2017 to 2022-04, AWS types with a stable correction factor, average only), then months rolled up from the daily series (`pauley`, `titans`, `direct`: `avg` = median of daily averages, open/close from the first/last day, high/low the extremes, `days` = days covered, `source` = the source covering most days). `archive` (AWS, default on) is the USC/ISI monthly dataset 2014-02 to 2023-12 as published, with open/high/low/close, for 51 legacy types: third-party, mixes OS products, provenance partly unverified; returned separately so it never silently blends into the curated series.

Parameters6

provider	string	required	Cloud provider. One of `aws`, `gcp`, `azure`.
region	string	required	Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1
instance	string	required	Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large
from	string	optional	First month (inclusive), YYYY-MM-DD (use the 1st). Default: earliest.
to	string	optional	Last month (inclusive), YYYY-MM-DD. Default: latest.
include_archive	boolean	optional	Include the raw USC/ISI archive rows in `archive`. Default true.

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "aws",
        "gcp",
        "azure"
      ],
      "description": "Cloud provider. One of `aws`, `gcp`, `azure`."
    },
    "region": {
      "type": "string",
      "description": "Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1"
    },
    "instance": {
      "type": "string",
      "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large"
    },
    "from": {
      "type": "string",
      "description": "First month (inclusive), YYYY-MM-DD (use the 1st). Default: earliest."
    },
    "to": {
      "type": "string",
      "description": "Last month (inclusive), YYYY-MM-DD. Default: latest."
    },
    "include_archive": {
      "type": "boolean",
      "description": "Include the raw USC/ISI archive rows in `archive`. Default true."
    }
  },
  "required": [
    "provider",
    "region",
    "instance"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

spot_latest

Paid (0.01 USDC per call). Price currently in force per zone and product for one instance type. The most recent event of every (zone, product) series of the type, with its timestamp and age. A price is only meaningful while the provider still offers the type; AWS series older than ~10 days are likely retired, GCP/Azure reprice rarely so old timestamps are normal. For every type in a region at once use /spot/snapshot.

Parameters3

provider	string	required	Cloud provider. One of `aws`, `gcp`, `azure`.
region	string	required	Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1
instance	string	required	Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "aws",
        "gcp",
        "azure"
      ],
      "description": "Cloud provider. One of `aws`, `gcp`, `azure`."
    },
    "region": {
      "type": "string",
      "description": "Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1"
    },
    "instance": {
      "type": "string",
      "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large"
    }
  },
  "required": [
    "provider",
    "region",
    "instance"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

spot_snapshot

Paid (0.10 USDC per call). Current price of every instance type, zone and product in a whole region, in one call. Bulk snapshot: the most recent event of every series in the region (about 6,000 rows for an AWS region), with timestamp and age per row. Same semantics as /spot/latest. Priced higher because one call returns the entire current price surface of the region.

Parameters2

provider	string	required	Cloud provider. One of `aws`, `gcp`, `azure`.
region	string	required	Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "aws",
        "gcp",
        "azure"
      ],
      "description": "Cloud provider. One of `aws`, `gcp`, `azure`."
    },
    "region": {
      "type": "string",
      "description": "Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1"
    }
  },
  "required": [
    "provider",
    "region"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ondemand

Paid (0.01 USDC per call). On-demand list-price history of one instance type. Change-point series: one row per day the on-demand (pay-as-you-go) hourly list price changed; `current` is the price in force. AWS: Linux, shared tenancy, from the AWS Price List API, refreshed weekly, since 2024-01 (every AWS region in /catalog). Azure: every Linux VM SKU from the public Retail Prices API, refreshed daily, since 2026-09-13 (every Azure region in /catalog). GCP: the TITANS-era series (2024 to 2026-08), not refreshed.

Parameters3

provider	string	required	Cloud provider. One of `aws`, `gcp`, `azure`.
region	string	required	Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1
instance	string	required	Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "aws",
        "gcp",
        "azure"
      ],
      "description": "Cloud provider. One of `aws`, `gcp`, `azure`."
    },
    "region": {
      "type": "string",
      "description": "Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1"
    },
    "instance": {
      "type": "string",
      "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large"
    }
  },
  "required": [
    "provider",
    "region",
    "instance"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ondemand_snapshot

Paid (0.10 USDC per call). Current on-demand list price of every instance type in a region.

Parameters2

provider	string	required	Cloud provider. One of `aws`, `gcp`, `azure`.
region	string	required	Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "aws",
        "gcp",
        "azure"
      ],
      "description": "Cloud provider. One of `aws`, `gcp`, `azure`."
    },
    "region": {
      "type": "string",
      "description": "Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1"
    }
  },
  "required": [
    "provider",
    "region"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reserved

Paid (0.01 USDC per call). Reserved / reservation price history of one instance type (AWS standard RIs 1y/3y no-upfront/all-upfront; Azure reservations 1y/3y). Effective hourly USD with any upfront amortized over the term, as change-point series per `ri_type` (`ri_1y_no_upfront_standard`, `ri_1y_all_upfront_standard`, `ri_3y_no_upfront_standard`, `ri_3y_all_upfront_standard`; GCP `cud_1y`, `cud_3y`). AWS: Linux, shared tenancy, history back to 2016 for the original three regions, weekly refresh from the AWS Price List API. Azure: all-upfront reservations from the public Retail Prices API, daily, since 2026-09-13. GCP: resource-based committed-use discounts from the Cloud Billing Catalog (vCPU, RAM and GPU commitment SKUs), daily, since 2026-09-13.

Parameters4

provider	string	optional	Provider: `aws` (default), `azure` or `gcp`.
region	string	required	Region slug (for example `us-east-1`, `us-east` for Azure, `us-central1` for GCP). Example: us-east-1
instance	string	required	Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large
ri_type	string	optional	Restrict to one ri_type.

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "aws",
        "azure",
        "gcp"
      ],
      "description": "Provider: `aws` (default), `azure` or `gcp`."
    },
    "region": {
      "type": "string",
      "description": "Region slug (for example `us-east-1`, `us-east` for Azure, `us-central1` for GCP). Example: us-east-1"
    },
    "instance": {
      "type": "string",
      "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large"
    },
    "ri_type": {
      "type": "string",
      "enum": [
        "ri_1y_no_upfront_standard",
        "ri_1y_all_upfront_standard",
        "ri_3y_no_upfront_standard",
        "ri_3y_all_upfront_standard",
        "cud_1y",
        "cud_3y"
      ],
      "description": "Restrict to one ri_type."
    }
  },
  "required": [
    "region",
    "instance"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reserved_snapshot

Paid (0.10 USDC per call). Current reserved effective hourly price of every instance type and ri_type in a region (AWS or Azure).

Parameters2

provider	string	optional	Provider: `aws` (default), `azure` or `gcp`.
region	string	required	Region slug (for example `us-east-1`, `us-east` for Azure, `us-central1` for GCP). Example: us-east-1

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "aws",
        "azure",
        "gcp"
      ],
      "description": "Provider: `aws` (default), `azure` or `gcp`."
    },
    "region": {
      "type": "string",
      "description": "Region slug (for example `us-east-1`, `us-east` for Azure, `us-central1` for GCP). Example: us-east-1"
    }
  },
  "required": [
    "region"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

gpu_models

Free. GPU models with rental quotes, and which providers quote them. Normalized model names (use verbatim as `gpu`), number of providers quoting each, quote counts, first/last snapshot day, the lowest observed USD per GPU-hour, and which hyperscaler spot instance families map to the model.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

gpu_quotes

Paid (0.01 USDC per call). Latest rental quotes for one GPU model across neo-clouds, marketplaces and other clouds. One row per quote in each provider's latest daily snapshot: provider, market (`ondemand`, `spot` = interruptible, `bid` = marketplace minimum bid, `secure`/`community` = RunPod tiers), GPUs in the quoted unit, USD per GPU-hour, quoted unit price, region where the provider exposes one, and provider-specific detail in `extra` (marketplace host reliability, VRAM, stock status). Sources are each provider's public price feed or page (Vast.ai: the cheapest 64 offers per model, on-demand and bid); /gpu/models lists who quotes each model. Snapshots are taken several times a day.

Parameters3

gpu	string	required	Normalized GPU model from /gpu/models, e.g. `H100 SXM`, `H200`, `B200`, `A100 SXM 80GB`, `L40S`, `RTX 4090`. Example: H100 SXM
provider	string	optional	Restrict to one provider slug as listed by /gpu/models (for example `runpod`, `vast`, `lambda`).
market	string	optional	Restrict to one market (`ondemand`, `spot`, `bid`, `secure`, `community`, `network`, `lease`, `executed`).

Raw schema

{
  "type": "object",
  "properties": {
    "gpu": {
      "type": "string",
      "description": "Normalized GPU model from /gpu/models, e.g. `H100 SXM`, `H200`, `B200`, `A100 SXM 80GB`, `L40S`, `RTX 4090`. Example: H100 SXM"
    },
    "provider": {
      "type": "string",
      "description": "Restrict to one provider slug as listed by /gpu/models (for example `runpod`, `vast`, `lambda`)."
    },
    "market": {
      "type": "string",
      "description": "Restrict to one market (`ondemand`, `spot`, `bid`, `secure`, `community`, `network`, `lease`, `executed`)."
    }
  },
  "required": [
    "gpu"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

gpu_index

Paid (0.05 USDC per call). Daily USD per GPU-hour index per provider and market for one GPU model, with hyperscaler spot legs. For each snapshot day and (provider, market): number of quotes and the lowest, median, mean and highest USD per GPU-hour. Rows with provider `aws-spot` or `gcp-spot` are computed from our own spot price events for the instance family that carries the GPU (time-weighted daily bar divided by GPUs per node, per region), so the neo-cloud market and hyperscaler spot are comparable in one series. Quote history starts 2026-09-13; hyperscaler spot legs reach back to the start of our event data.

Parameters3

gpu	string	required	Normalized GPU model from /gpu/models. Example: H100 SXM
from	string	optional	First day (inclusive), YYYY-MM-DD. Default: earliest.
to	string	optional	Last day (inclusive), YYYY-MM-DD. Default: latest.

Raw schema

{
  "type": "object",
  "properties": {
    "gpu": {
      "type": "string",
      "description": "Normalized GPU model from /gpu/models. Example: H100 SXM"
    },
    "from": {
      "type": "string",
      "description": "First day (inclusive), YYYY-MM-DD. Default: earliest."
    },
    "to": {
      "type": "string",
      "description": "Last day (inclusive), YYYY-MM-DD. Default: latest."
    }
  },
  "required": [
    "gpu"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

gpu_snapshot

Paid (0.10 USDC per call). Every GPU model × provider × market: lowest and median USD per GPU-hour in the latest snapshot, plus hyperscaler spot per region.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

status

Free. Freshness of every data source. Per source: last successful snapshot or event, staleness in days, and the public URL it is read from. Use it to decide whether a fixing or quote is current before paying for it.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

index_tickers

Free. Every index ticker, its segment and definition. Tickers are CX.<MODEL>.<SEGMENT> (for example CX.H100SXM.NEO) or CX.<MODEL>.SPOT.<REGION>. Includes the segment membership lists and the methodology version.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

index_fixing

Paid (0.01 USDC per call). One day's fixing for a ticker: median USD per GPU-hour of eligible quotes, with low, high and count. Quote segments (MKT, AGG, NEO, INT, EXE, HYP) fix from that day's snapshots; the default day is the latest snapshot. SPOT fixes from the full UTC day of spot events, so the default is yesterday; SPOT composites carry per-region values and spread_vs_neo. See /methodology for eligibility and aggregation.

Parameters2

ticker	string	required	Ticker from /index/tickers, e.g. `CX.H100SXM.NEO` or `CX.H100SXM.SPOT.US-EAST-1`. Example: CX.H100SXM.NEO
day	string	optional	Fixing day, YYYY-MM-DD. Default: latest available.

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Ticker from /index/tickers, e.g. `CX.H100SXM.NEO` or `CX.H100SXM.SPOT.US-EAST-1`. Example: CX.H100SXM.NEO"
    },
    "day": {
      "type": "string",
      "description": "Fixing day, YYYY-MM-DD. Default: latest available."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

index_history

Paid (0.05 USDC per call). Daily fixings for a ticker over a date range. Quote segments start 2026-09-13. SPOT tickers reach back to the start of the spot series (AWS daily from 2022-05-31 for A100, V100, T4, A10; from 2023-07 for H100), each row carrying its data source.

Parameters3

ticker	string	required	Ticker from /index/tickers. Example: CX.H100SXM.NEO
from	string	optional	First day, YYYY-MM-DD. Default: earliest.
to	string	optional	Last day, YYYY-MM-DD. Default: today.

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Ticker from /index/tickers. Example: CX.H100SXM.NEO"
    },
    "from": {
      "type": "string",
      "description": "First day, YYYY-MM-DD. Default: earliest."
    },
    "to": {
      "type": "string",
      "description": "Last day, YYYY-MM-DD. Default: today."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

index_board

Paid (0.10 USDC per call). Every ticker's fixing for one day in one call.

Parameters1

day

string

optional

Fixing day, YYYY-MM-DD. Default: latest.

Raw schema

{
  "type": "object",
  "properties": {
    "day": {
      "type": "string",
      "description": "Fixing day, YYYY-MM-DD. Default: latest."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

attestations

Free. Daily on-chain attestations of the fixing set. One record per store day: the keccak256 of the day's signed fixings file (served at /attest/<day>.json), the Ethereum Attestation Service UID and transaction on Base (eip155:8453), the publisher address and the schema UID. Re-hash the file bytes and compare with fixingsHash to verify; every row inside the file carries its own EIP-712 signature. See /governance.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

capacity_headline

Free. Capacity stress score per GPU model for the latest day, score only. Rounded score from 0 (slack) to 100 (tight) per GPU with at least two signals, tightest first, cached ten minutes. The components and their inputs are in the paid /capacity/stress and /capacity/board.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

capacity_stress

Paid (0.01 USDC per call). Capacity stress score, 0 (slack) to 100 (tight), for one GPU model on one day, with every component. Mean of the components available that day: availability (share of Shadeform and Lambda listings flagged available), ionet (deployable ÷ total units on io.net regional SKUs), supply (Vast on-demand offers vs the trailing 30-day median) and spot_ratio (hyperscaler SPOT fixing ÷ HYP fixing, 0.3 → 0 and 0.9 → 100). Each component carries its inputs.

Parameters2

gpu	string	required	Normalized GPU model, e.g. `H100 SXM`. Example: H100 SXM
day	string	optional	YYYY-MM-DD; default latest.

Raw schema

{
  "type": "object",
  "properties": {
    "gpu": {
      "type": "string",
      "description": "Normalized GPU model, e.g. `H100 SXM`. Example: H100 SXM"
    },
    "day": {
      "type": "string",
      "description": "YYYY-MM-DD; default latest."
    }
  },
  "required": [
    "gpu"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

capacity_history

Paid (0.05 USDC per call). Daily capacity stress scores for one GPU model.

Parameters3

gpu	string	required	Normalized GPU model. Example: H100 SXM
from	string	optional	YYYY-MM-DD.
to	string	optional	YYYY-MM-DD.

Raw schema

{
  "type": "object",
  "properties": {
    "gpu": {
      "type": "string",
      "description": "Normalized GPU model. Example: H100 SXM"
    },
    "from": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "to": {
      "type": "string",
      "description": "YYYY-MM-DD."
    }
  },
  "required": [
    "gpu"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

capacity_board

Paid (0.10 USDC per call). Every GPU model's capacity stress score for one day, tightest first.

Parameters1

day

string

optional

YYYY-MM-DD; default latest.

Raw schema

{
  "type": "object",
  "properties": {
    "day": {
      "type": "string",
      "description": "YYYY-MM-DD; default latest."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tokens_models

Free. Every LLM with a token price fixing, its ticker codes and today's price range. Canonical model slugs (for example `claude-sonnet-5`, `gpt-6-astra`, `llama-4-maverick`), their ticker codes, how many sources and hosts list them, and the min/max input and output price seen today. Also lists the frontier basket.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tokens_quotes

Paid (0.01 USDC per call). Every listed price for one model on one day: each source and hosting provider, USD per million tokens. Rows from the OpenRouter catalog, OpenRouter per-host endpoints (Azure, Amazon Bedrock, Google, Together, DeepInfra, …), the LiteLLM price table and DeepInfra. Includes cache-read price and context length where known; variants such as batch tiers are marked in `extra.variant`.

Parameters2

model	string	required	Canonical model slug from /tokens/models. Example: deepseek-v3
day	string	optional	YYYY-MM-DD; default latest.

Raw schema

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string",
      "description": "Canonical model slug from /tokens/models. Example: deepseek-v3"
    },
    "day": {
      "type": "string",
      "description": "YYYY-MM-DD; default latest."
    }
  },
  "required": [
    "model"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tokens_fixing

Paid (0.01 USDC per call). One day's token price fixing for a ticker such as CX.TOK.CLAUDESONNET5.IN. Median across every source and host at the standard tier (batch and free variants excluded). `.IN` and `.OUT` are input and output USD per million tokens; `.BLEND` is (3·input + output) / 4. `CX.TOK.FRONTIER.<side>` is the median across the frontier basket listed by /tokens/models.

Parameters2

ticker	string	required	CX.TOK.<MODELCODE>.IN \| OUT \| BLEND, or CX.TOK.FRONTIER.<side>. Example: CX.TOK.FRONTIER.BLEND
day	string	optional	YYYY-MM-DD; default latest.

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "CX.TOK.<MODELCODE>.IN | OUT | BLEND, or CX.TOK.FRONTIER.<side>. Example: CX.TOK.FRONTIER.BLEND"
    },
    "day": {
      "type": "string",
      "description": "YYYY-MM-DD; default latest."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tokens_history

Paid (0.05 USDC per call). Daily fixings for a token ticker, from the first snapshot (2026-09-14).

Parameters3

ticker	string	required	Token ticker. Example: CX.TOK.FRONTIER.BLEND
from	string	optional	YYYY-MM-DD.
to	string	optional	YYYY-MM-DD.

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Token ticker. Example: CX.TOK.FRONTIER.BLEND"
    },
    "from": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "to": {
      "type": "string",
      "description": "YYYY-MM-DD."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tokens_board

Paid (0.10 USDC per call). Every model's input, output and blended fixing for one day, plus the frontier basket.

Parameters1

day

string

optional

YYYY-MM-DD; default latest.

Raw schema

{
  "type": "object",
  "properties": {
    "day": {
      "type": "string",
      "description": "YYYY-MM-DD; default latest."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

term_instance

Paid (0.01 USDC per call). Price ladder for one instance type: spot, on-demand, 1-year and 3-year commitments, with discounts. Current prices from our series: spot median across zones (where spot events exist), on-demand list price, and reserved/reservation terms as effective hourly with upfront amortized. `discount_pct` is relative to on-demand. AWS carries four reserved terms (1y/3y × no/all upfront), Azure two (1y/3y all upfront), GCP two resource-based committed-use terms (`cud_1y`, `cud_3y`, no upfront).

Parameters3

provider	string	required	Cloud provider. One of `aws`, `gcp`, `azure`.
region	string	required	Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1
instance	string	required	Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "aws",
        "gcp",
        "azure"
      ],
      "description": "Cloud provider. One of `aws`, `gcp`, `azure`."
    },
    "region": {
      "type": "string",
      "description": "Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`. Example: us-east-1"
    },
    "instance": {
      "type": "string",
      "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`). Example: c5.large"
    }
  },
  "required": [
    "provider",
    "region",
    "instance"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

term

Paid (0.05 USDC per call). Term structure per hyperscaler for one GPU model, USD per GPU-hour: spot, on-demand, 1y, 3y. For each hyperscaler with a mapped instance family (see /gpu/models hyperscaler_spot_legs), the median across regions of each term's price divided by GPUs per node, with lo/hi across regions and the discount to on-demand. Answers "what does a committed H100 cost against spot and on-demand, per cloud". Neo-cloud commitment prices are quote-only and excluded.

Parameters1

gpu

string

required

Normalized GPU model with a hyperscaler mapping, e.g. `H100 SXM`, `A100 SXM 80GB`, `L4`, `T4`. Example: H100 SXM

Raw schema

{
  "type": "object",
  "properties": {
    "gpu": {
      "type": "string",
      "description": "Normalized GPU model with a hyperscaler mapping, e.g. `H100 SXM`, `A100 SXM 80GB`, `L4`, `T4`. Example: H100 SXM"
    }
  },
  "required": [
    "gpu"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

azure_eviction

Paid (0.01 USDC per call). Azure spot eviction-rate history (28-day buckets, sampled daily). Daily samples of the eviction-rate bucket Azure reports per SKU (`0-5`, `5-10`, `10-15`, `15-20`, `20+` percent over the trailing 28 days). Collected daily since 2026-09-05; there is no history before the first sample.

Parameters4

region	string	required	Azure region slug: `us-east`, `us-west-2` or `eu-west`.
sku	string	optional	Optional SKU name (for example `D2s_v5`). Default: every SKU.
from	string	optional	First sample date (inclusive), YYYY-MM-DD. Default: earliest.
to	string	optional	Last sample date (inclusive), YYYY-MM-DD. Default: latest.

Raw schema

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "enum": [
        "us-east",
        "us-west-2",
        "eu-west"
      ],
      "description": "Azure region slug: `us-east`, `us-west-2` or `eu-west`."
    },
    "sku": {
      "type": "string",
      "description": "Optional SKU name (for example `D2s_v5`). Default: every SKU."
    },
    "from": {
      "type": "string",
      "description": "First sample date (inclusive), YYYY-MM-DD. Default: earliest."
    },
    "to": {
      "type": "string",
      "description": "Last sample date (inclusive), YYYY-MM-DD. Default: latest."
    }
  },
  "required": [
    "region"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md3 KBView on GitHub

corpus-cloud-pricing-mcp

MCP server (stdio) for corpusAI Cloud Pricing: AWS, GCP and Azure spot price history at event resolution, on-demand and reserved list prices, GPU rental quotes from neo-clouds and marketplaces, LLM token prices, and daily index fixings per GPU and segment (CX.H100SXM.NEO, CX.H100SXM.SPOT, ...). Free tools need nothing. Paid tools pay per call in USDC over x402 through Circle Gateway, from a wallet you configure.

The API also takes MPP (USDC on Tempo) and prepaid keys. To use a prepaid key from an agent, connect to the hosted MCP server at https://cloud.trycorpus.ai/mcp instead of this package (see the docs).

Install

Claude Code:

code

claude mcp add corpus-cloud-pricing -e CORPUS_PAYER_KEY=0x... -- npx -y corpus-cloud-pricing-mcp

Claude Desktop, Cursor or any MCP client (mcp.json):

json

{
  "mcpServers": {
    "corpus-cloud-pricing": {
      "command": "npx",
      "args": ["-y", "corpus-cloud-pricing-mcp"],
      "env": { "CORPUS_PAYER_KEY": "0x...", "CORPUS_CHAIN": "base", "CORPUS_MAX_USDC": "0.10" }
    }
  }
}

Without CORPUS_PAYER_KEY the free tools work and the paid tools return the price and accepted networks instead of data.

Paying

Paid calls are settled gaslessly from a Circle Gateway USDC balance held by the payer wallet. Fund it once:

code

CORPUS_PAYER_KEY=0x... npx corpus-cloud-pricing-mcp balance
CORPUS_PAYER_KEY=0x... CORPUS_CHAIN=base npx corpus-cloud-pricing-mcp deposit 2.00   # needs USDC and a little gas on that chain

CORPUS_CHAIN takes a Circle Gateway chain name as the Gateway SDK spells it (base, ethereum, arbitrum, worldChain, hyperEvm, ...). CORPUS_MAX_USDC (default 0.10) refuses any single call priced above it. Prices: 0.01 USDC for single-type or single-fixing calls, 0.05 for full histories, 0.10 for region or market snapshots.

Tools

Free: catalog, instances, gpu_models, index_tickers, status, tokens_models. Paid: spot_daily, spot_hourly, spot_events, spot_latest, spot_snapshot, spot_monthly, ondemand, reserved, gpu_quotes, gpu_index, index_fixing, index_history, index_board, term_instance, term_curve, tokens_quotes, tokens_fixing, tokens_history, tokens_board, capacity_stress, capacity_history, capacity_board.

The hosted server generates its tools from the OpenAPI document, so its set is larger and a few names differ (its GPU term structure tool is term, where this package says term_curve).

Methodology for the index fixings: https://cloud.trycorpus.ai/methodology. Data license: https://cloud.trycorpus.ai/license. Contact: hello@trycorpus.ai.

Install

Tools (35)

healthcataloginstancesspot_eventsspot_hourlyspot_dailyspot_monthlyspot_latest

Configuration

Environment variables

CORPUS_PAYER_KEYsecret

EVM private key of a wallet with a Circle Gateway USDC balance; paid tools pay for themselves. Omit to use only the free tools.

CORPUS_CHAINdefault base

Circle Gateway chain to pay on, as the Gateway SDK names it: base, ethereum, arbitrum, optimism, polygon, avalanche, unichain, sonic, worldChain, sei, hyperEvm or arc.

CORPUS_MAX_USDCdefault 0.10

Spend cap per call in USDC; calls priced above it are refused.

CORPUS_BASE_URL

API origin; leave unset for https://cloud.trycorpus.ai.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "corpus-cloud-pricing-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "corpus-cloud-pricing-mcp@0.1.6"
      ],
      "env": {
        "CORPUS_PAYER_KEY": "<YOUR_CORPUS_PAYER_KEY>",
        "CORPUS_CHAIN": "base",
        "CORPUS_MAX_USDC": "0.10",
        "CORPUS_BASE_URL": "<YOUR_CORPUS_BASE_URL>"
      }
    }
  }
}

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

health

catalog

instances

spot_events

spot_hourly

spot_daily

spot_monthly

spot_latest

spot_snapshot

ondemand

ondemand_snapshot

reserved

reserved_snapshot

gpu_models

gpu_quotes

gpu_index

gpu_snapshot

status

index_tickers

index_fixing

index_history

index_board

attestations

capacity_headline

capacity_stress

capacity_history

capacity_board

tokens_models

tokens_quotes

tokens_fixing

tokens_history

tokens_board

term_instance

term

azure_eviction

corpus-cloud-pricing-mcp

Install

Paying

Tools

Install

Configuration

Related servers