# flopsindex **Reference rates for compute economics** — public price indices for GPU rentals (spot, on-demand, DePIN). Every published value carries a verify URL your code can check against the public index. [![PyPI · flopsindex-mcp](https://img.shields.io/pypi/v/flopsindex-mcp?label=flopsindex-mcp)](https://pypi.org/project/flopsindex-mcp/) [![PyPI · flopsindex](https://img.shields.io/pypi/v/flopsindex?label=flopsindex)](https://pypi.org/project/flopsindex/) [![npm · @flopsindex/sdk](https://img.shields.io/npm/v/@flopsindex/sdk?label=%40flopsindex%2Fsdk)](https://www.npmjs.com/package/@flopsindex/sdk) [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE) --- ## Try it in one line ```bash # MCP server (Claude Code, Cursor, Windsurf, ChatGPT desktop, ...) pip install flopsindex-mcp && claude mcp add flopsindex -- flopsindex-mcp # Python REST SDK pip install flopsindex # TypeScript / JavaScript SDK npm i @flopsindex/sdk # Or skip install — hit the hosted MCP gateway # https://app.flopsindex.com/mcp (anonymous, zero-config) ``` Or to your agent: *"Get me the current FLOPS price for an H100 on-demand and show me the verify URL."* --- ## What's distinctive **Source-opaque by contract.** Every public payload returns a `value` plus citation and verify URLs — nothing about how the value was produced. **One surface, two access modes.** - **Anonymous** → delayed public price for the published FLOPS index family (`FLOPS-{model}-{OD|SPOT|DEPIN}`), delayed onto a ~6h grid (as_of snaps to 00/06/12/18 UTC). Indicative reference — not for settlement. The citation surface, designed for LLM/agent discovery and academic reference. The family spans many accelerator models (NVIDIA data-center and workstation GPUs plus AMD Instinct), not just H100 — enumerate the live set via [`/v2/catalog/public`](https://app.flopsindex.com/v2/catalog/public); it grows as coverage crosses the ≥3-source floor. - **Keyed** (`X-FLOPS-Api-Key`) → the same five tools at full precision. A **partner tier** with higher fidelity and expanded coverage is available — contact `team@flopsindex.com`. --- ## Features - **Five key-free tools** — `list_indices`, `search_indices`, `get_price`, `get_index`, `verify`. No API key, no signup, no configuration. - **Every value carries a verify URL** — check any published number against the index from your own code. `verify` returns whether a cited value matches. - **Spot, on-demand and DePIN** reference prices per chip and market type. - **Three vendors** — NVIDIA data-center and workstation GPUs, AMD MI300X, and Intel Gaudi 2. Enumerate the live set via [`/v2/catalog/public`](https://app.flopsindex.com/v2/catalog/public). - **Source-opaque by contract** — the value plus citation and verify links, never the inputs behind it. - **Delayed onto a ~6h grid** (00/06/12/18 UTC), 2dp values, banded 24h change, label confidence. Indicative reference — not for settlement. - **Zero install or local** — hosted MCP gateway at `https://app.flopsindex.com/mcp`, or `uvx flopsindex-mcp`. - **SDKs included** — Python (`flopsindex`), TypeScript (`@flopsindex/sdk`), and LangChain / LlamaIndex (`langchain-flopsindex`). --- ## What's in this repo | Path | What | |---|---| | [`mcp/`](mcp/) | The `flopsindex-mcp` server — stdio MCP, 5 public tools (`list_indices` · `search_indices` · `get_price` · `get_index` · `verify`) + a `flops://index/` resource. Published on PyPI. | | [`sdk/python/`](sdk/python/) | The `flopsindex` Python REST SDK — published on PyPI. | | [`sdk/typescript/`](sdk/typescript/) | The `@flopsindex/sdk` TypeScript / JavaScript REST SDK — published on npm. | | [`schema/`](schema/) | `compute-index-spec.v0.1` — the public payload schema (JSON Schema) + a worked example. | | [`openapi.json`](openapi.json) | OpenAPI 3 description of the public surface. | | [`llms-full.txt`](llms-full.txt) | Extended public-surface reference for LLM/agent discovery — source-opaque, 6 endpoints, 14-field envelope. Mirror of the hosted `/llms-full.txt`. | --- ## Verify a value yourself ```bash curl -s https://app.flopsindex.com/v1/price/FLOPS-H100-OD | jq # value: 2.95 (USD/GPU-hr, 2dp) # unit: USD/GPU-hr # as_of: 2026-07-13T12:00:00Z (delayed to a ~6h grid: 00/06/12/18 UTC) # data_tier: LIVE # confidence: HIGH (HIGH | MED, label only) # change_24h: FLAT (banded: UP | FLAT | DOWN) # disclaimer: indicative reference; not for settlement # methodology_url: /i/FLOPS-H100-OD/methodology # verify_url: /v1/verify?... # citation_url: /cite?... # permalink: /i/FLOPS-H100-OD # ... source-opaque public payload only. ``` The same value is reachable via the SDK and via the MCP `get_index` tool — every path returns the same source-opaque payload. --- ## Public surface | Endpoint | What | |---|---| | [`/mcp`](https://app.flopsindex.com/mcp) | Hosted MCP gateway — same 5 public tools, no install | | [`/v2/catalog/public`](https://app.flopsindex.com/v2/catalog/public) | Public catalog — every live index id (spot, on-demand and DePIN) | | [`/.well-known/agent.json`](https://app.flopsindex.com/.well-known/agent.json) | Agent2Agent (A2A) discovery card | | [`/llms.txt`](https://app.flopsindex.com/llms.txt) | LLM-discovery manifest | | [`/llms-full.txt`](https://app.flopsindex.com/llms-full.txt) | Deeper agent-context blob | | [`/cite`](https://app.flopsindex.com/cite) | Citation guide for AI answer engines | | [`/i/`](https://app.flopsindex.com/i/FLOPS-H100-OD) | Permalink page with schema.org JSON-LD | | [`/i//methodology`](https://app.flopsindex.com/i/FLOPS-H100-OD/methodology) | Public methodology page (linked from `methodology_url`) | | `/v1/verify` | Verify a published value against the index | --- ## License Apache License 2.0 — see [`LICENSE`](LICENSE) and [`NOTICE`](NOTICE). Apache 2.0 governs the **source code** in this repository (SDKs, MCP server, schema, examples). The underlying price data, the FLOPS trademark, and the hosted index methodology are the proprietary work of FLOPS Index; use of the published APIs is governed by the terms at [flopsindex.com](https://flopsindex.com). --- ## Contributing - Bug reports + small fixes welcome via Issues / PRs. - Contributions are welcome. **Use only the public index identifiers from `/v2/catalog/public`.** - For partner-tier access, contact **team@flopsindex.com**. --- ## Status | Package | Channel | |---|---| | `flopsindex-mcp` | [pypi.org/project/flopsindex-mcp/](https://pypi.org/project/flopsindex-mcp/) | | `flopsindex` (REST SDK) | [pypi.org/project/flopsindex/](https://pypi.org/project/flopsindex/) | | `@flopsindex/sdk` | [npmjs.com/package/@flopsindex/sdk](https://www.npmjs.com/package/@flopsindex/sdk) | Public surface, gateway, and catalog: [app.flopsindex.com](https://app.flopsindex.com).