{
  "markdown": "# flopsindex\n\n**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.\n\n[![PyPI · flopsindex-mcp](https://img.shields.io/pypi/v/flopsindex-mcp?label=flopsindex-mcp)](https://pypi.org/project/flopsindex-mcp/)\n[![PyPI · flopsindex](https://img.shields.io/pypi/v/flopsindex?label=flopsindex)](https://pypi.org/project/flopsindex/)\n[![npm · @flopsindex/sdk](https://img.shields.io/npm/v/@flopsindex/sdk?label=%40flopsindex%2Fsdk)](https://www.npmjs.com/package/@flopsindex/sdk)\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)\n\n---\n\n## Try it in one line\n\n```bash\n# MCP server (Claude Code, Cursor, Windsurf, ChatGPT desktop, ...)\npip install flopsindex-mcp && claude mcp add flopsindex -- flopsindex-mcp\n\n# Python REST SDK\npip install flopsindex\n\n# TypeScript / JavaScript SDK\nnpm i @flopsindex/sdk\n\n# Or skip install — hit the hosted MCP gateway\n# https://app.flopsindex.com/mcp   (anonymous, zero-config)\n```\n\nOr to your agent: *\"Get me the current FLOPS price for an H100 on-demand and show me the verify URL.\"*\n\n---\n\n## What's distinctive\n\n**Source-opaque by contract.** Every public payload returns a `value` plus citation and verify URLs — nothing about how the value was produced.\n\n**One surface, two access modes.**\n- **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.\n- **Keyed** (`X-FLOPS-Api-Key`) → the same five tools at full precision.\n\nA **partner tier** with higher fidelity and expanded coverage is available — contact `team@flopsindex.com`.\n\n---\n\n## Features\n\n- **Five key-free tools** — `list_indices`, `search_indices`, `get_price`, `get_index`, `verify`. No API key, no signup, no configuration.\n- **Every value carries a verify URL** — check any published number against the index from your own code. `verify` returns whether a cited value matches.\n- **Spot, on-demand and DePIN** reference prices per chip and market type.\n- **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).\n- **Source-opaque by contract** — the value plus citation and verify links, never the inputs behind it.\n- **Delayed onto a ~6h grid** (00/06/12/18 UTC), 2dp values, banded 24h change, label confidence. Indicative reference — not for settlement.\n- **Zero install or local** — hosted MCP gateway at `https://app.flopsindex.com/mcp`, or `uvx flopsindex-mcp`.\n- **SDKs included** — Python (`flopsindex`), TypeScript (`@flopsindex/sdk`), and LangChain / LlamaIndex (`langchain-flopsindex`).\n\n---\n\n## What's in this repo\n\n| Path | What |\n|---|---|\n| [`mcp/`](mcp/) | The `flopsindex-mcp` server — stdio MCP, 5 public tools (`list_indices` · `search_indices` · `get_price` · `get_index` · `verify`) + a `flops://index/<INDEX_ID>` resource. Published on PyPI. |\n| [`sdk/python/`](sdk/python/) | The `flopsindex` Python REST SDK — published on PyPI. |\n| [`sdk/typescript/`](sdk/typescript/) | The `@flopsindex/sdk` TypeScript / JavaScript REST SDK — published on npm. |\n| [`schema/`](schema/) | `compute-index-spec.v0.1` — the public payload schema (JSON Schema) + a worked example. |\n| [`openapi.json`](openapi.json) | OpenAPI 3 description of the public surface. |\n| [`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`. |\n\n---\n\n## Verify a value yourself\n\n```bash\ncurl -s https://app.flopsindex.com/v1/price/FLOPS-H100-OD | jq\n#   value:            2.95            (USD/GPU-hr, 2dp)\n#   unit:             USD/GPU-hr\n#   as_of:            2026-07-13T12:00:00Z   (delayed to a ~6h grid: 00/06/12/18 UTC)\n#   data_tier:        LIVE\n#   confidence:       HIGH            (HIGH | MED, label only)\n#   change_24h:       FLAT            (banded: UP | FLAT | DOWN)\n#   disclaimer:       indicative reference; not for settlement\n#   methodology_url:  /i/FLOPS-H100-OD/methodology\n#   verify_url:       /v1/verify?...\n#   citation_url:     /cite?...\n#   permalink:        /i/FLOPS-H100-OD\n#   ... source-opaque public payload only.\n```\n\nThe same value is reachable via the SDK and via the MCP `get_index` tool — every path returns the same source-opaque payload.\n\n---\n\n## Public surface\n\n| Endpoint | What |\n|---|---|\n| [`/mcp`](https://app.flopsindex.com/mcp) | Hosted MCP gateway — same 5 public tools, no install |\n| [`/v2/catalog/public`](https://app.flopsindex.com/v2/catalog/public) | Public catalog — every live index id (spot, on-demand and DePIN) |\n| [`/.well-known/agent.json`](https://app.flopsindex.com/.well-known/agent.json) | Agent2Agent (A2A) discovery card |\n| [`/llms.txt`](https://app.flopsindex.com/llms.txt) | LLM-discovery manifest |\n| [`/llms-full.txt`](https://app.flopsindex.com/llms-full.txt) | Deeper agent-context blob |\n| [`/cite`](https://app.flopsindex.com/cite) | Citation guide for AI answer engines |\n| [`/i/<INDEX_ID>`](https://app.flopsindex.com/i/FLOPS-H100-OD) | Permalink page with schema.org JSON-LD |\n| [`/i/<INDEX_ID>/methodology`](https://app.flopsindex.com/i/FLOPS-H100-OD/methodology) | Public methodology page (linked from `methodology_url`) |\n| `/v1/verify` | Verify a published value against the index |\n\n---\n\n## License\n\nApache License 2.0 — see [`LICENSE`](LICENSE) and [`NOTICE`](NOTICE).\n\nApache 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).\n\n---\n\n## Contributing\n\n- Bug reports + small fixes welcome via Issues / PRs.\n- Contributions are welcome. **Use only the public index identifiers from `/v2/catalog/public`.**\n- For partner-tier access, contact **team@flopsindex.com**.\n\n---\n\n## Status\n\n| Package | Channel |\n|---|---|\n| `flopsindex-mcp` | [pypi.org/project/flopsindex-mcp/](https://pypi.org/project/flopsindex-mcp/) |\n| `flopsindex` (REST SDK) | [pypi.org/project/flopsindex/](https://pypi.org/project/flopsindex/) |\n| `@flopsindex/sdk` | [npmjs.com/package/@flopsindex/sdk](https://www.npmjs.com/package/@flopsindex/sdk) |\n\nPublic surface, gateway, and catalog: [app.flopsindex.com](https://app.flopsindex.com).\n",
  "bytes": 6964,
  "sha": "afee64a90ab18e8b4bfc5662cbeb73f58331ea72c9a5d15e1eba5757150fe4f7",
  "repo_slug": "zeroatflops/flopsindex",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_zeroatflops_flopsindex_mcp_5e478189/readme"
}