Metadata-Version: 2.4
Name: flopsindex-mcp
Version: 0.4.2
Summary: MCP server for the FLOPS Compute Intelligence Platform — gives Claude / Cursor / Windsurf agents direct access to GPU compute price indices, methodology, and per-index verification.
Author-email: Ash Chary <ash@flopsindex.com>
License: Proprietary
Keywords: mcp,flops,gpu,compute,pricing,claude,agents
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0.0
Requires-Dist: httpx>=0.26.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"

# flopsindex-mcp

Model Context Protocol server for the **FLOPS Compute Intelligence Platform**.

Gives AI agents (Claude Code, Cursor, Windsurf, ChatGPT desktop, any MCP host) direct access to live FLOPS GPU-compute price indices with verifiable provenance.

## Tools

| Tool | Description |
|---|---|
| `list_indices` | Enumerate all public FLOPS indices. Optional `family_filter` substring (e.g. `FLOPS-H100`). |
| `get_price` | Latest published price + tier + confidence for one index. |
| `get_timeseries` | Decimated history (≤200 points) for one index. Range: 24h / 7d / 30d / 90d / 1y. |
| `search_indices` | Free-text search across the public catalog. |
| `verify` | Fetch the latest published value + audit receipt for a given `index_id`. |
| `list_methodologies` | List every published methodology version (FLCI / ITPI / FLOPS-*). |
| `get_methodology` | Fetch a single methodology document — markdown or frontmatter JSON. Citeable. |
| `compute_margin` | Hydrahost spark-spread: `margin = price − chip_power × PUE × $/kWh − rack_amortization`. |
| `recompute_audit` | Receipt for a published value — IOSCO Principle 9+17 substrate. Variance bands green / yellow / red. |

`get_forward_curve` and `get_settlement` are still tracked in the Track D roadmap (CLRI-FWD / CLRI-SETTLED families).

## Install

```bash
uv tool install flopsindex-mcp
# or
pip install flopsindex-mcp
```

## Wire into Claude Code

```bash
claude mcp add flopsindex -- flopsindex-mcp
```

## Wire into Cursor / Windsurf

Add to your MCP config (`~/.cursor/mcp.json` or equivalent):

```json
{
  "mcpServers": {
    "flopsindex": {
      "command": "flopsindex-mcp"
    }
  }
}
```

## Environment

| Var | Default | Purpose |
|---|---|---|
| `FLOPS_API_URL` | `https://app.flopsindex.com` | Override for staging / self-host |

## Example agent prompts

> "Use the flopsindex MCP server to list all H100 on-demand indices and report their latest values."

> "Verify FLOPS-B300-OD-T1 and cite the receipt."

## Status

**v0.4.1** — `gpu_capex` tool added (per-SKU reference street price for a single GPU module — chip + carrier, quarterly-refreshed from GRVCI v0_benchmark + OEM channel reporting). 11 tools total. Backed by the public `/v1/refdata/gpu-capex` endpoint; no auth.

**v0.4.0** — `spread` tool added (time-aligned spread between two index legs with z-score / percentile-rank stats). 10 tools total. Registry listings expanded to 5 channels (added mcp.so + wong2/awesome-mcp-servers) in `LISTINGS.md`. PyPI publish still gated on operator.

**v0.3.0** — `list_methodologies` / `get_methodology` / `compute_margin` / `recompute_audit` added on top of the 5-tool v0.2.0 surface. Registry listings (smithery.ai, glama.ai, modelcontextprotocol/servers) tracked in `LISTINGS.md`. PyPI publish gated on operator (token in keyring).

**v0.1.0** — Published to PyPI 2026-05-13.

## License

Proprietary. © 2026 FLOPS Index.
