Metadata-Version: 2.4
Name: flopsindex-mcp
Version: 0.11.2
Summary: MCP server for the FLOPS Compute Intelligence Platform — gives Claude / Cursor / Windsurf agents direct access to public GPU compute + inference token price indices 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

<!-- mcp-name: io.github.zeroatflops/flopsindex-mcp -->

[![PyPI version](https://img.shields.io/pypi/v/flopsindex-mcp.svg)](https://pypi.org/project/flopsindex-mcp/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/flopsindex-mcp.svg)](https://pypi.org/project/flopsindex-mcp/)
[![PyPI Downloads](https://img.shields.io/pypi/dm/flopsindex-mcp.svg)](https://pypi.org/project/flopsindex-mcp/)
[![Live API](https://img.shields.io/website?label=app.flopsindex.com&url=https%3A%2F%2Fapp.flopsindex.com%2Fv2%2Fcatalog%2Fpublic)](https://app.flopsindex.com/v2/catalog/public)
[![Spec](https://img.shields.io/badge/JSON--LD-v0.1-blue)](https://schema.flopsindex.com/compute-index-spec/v0.1/)
[![Test matrix](https://img.shields.io/badge/test--matrix-post--R7.5-success)](https://github.com/zeroatflops/Flops_Unicron/blob/main/Flops_Unicron/docs/mcp/post-r7.5-test-matrix.md)
[![Docs](https://img.shields.io/badge/docs-docs.flopsindex.com-blue)](https://docs.flopsindex.com/)
[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-mcp--publisher%20ready-success)](https://registry.modelcontextprotocol.io/)

**See also** — full docs [docs.flopsindex.com/sdk/mcp](https://docs.flopsindex.com/sdk/mcp) · agent citation guide [docs.flopsindex.com/integrations/llm-agent-citation-guide](https://docs.flopsindex.com/integrations/llm-agent-citation-guide) · public read SDK [`flopsindex`](https://pypi.org/project/flopsindex/) · partner write SDK [`flopsindex-partner`](https://pypi.org/project/flopsindex-partner/) · spec [schema.flopsindex.com](https://schema.flopsindex.com/) · adopters [schema.flopsindex.com/adopters](https://schema.flopsindex.com/adopters)

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

Five public, key-free tools:

| Tool | Description |
|---|---|
| `list_indices` | Enumerate all public FLOPS indices. Optional `family_filter` substring (e.g. `FLOPS-H100`). |
| `search_indices` | Free-text / natural-language search across the public catalog (resolves to slugs). |
| `get_price` | Latest published price + tier + confidence for one index. |
| `get_index` | Resolve an index to its **source-opaque public payload** — the canonical citation shape (`index_id, value, unit, as_of, data_tier, confidence, methodology_url, verify_url, citation_url, permalink`). No provider/source identities by design. Prefer this when you intend to **cite** a value. |
| `verify` | Fetch the latest published value + audit receipt for a given `index_id`. |

## Resources

Every public index is also exposed as an MCP **resource** so hosts can browse + read values without a tool call:

| URI | Returns |
|---|---|
| `flops://index/<INDEX_ID>` | The same **source-opaque C3 payload** as `get_index` (`value` + `verify_url`/`citation_url`/`permalink`, no provider identities), `mimeType: application/json`. |

`list_resources` enumerates one entry per public catalog index; `read_resource("flops://index/FLOPS-H100-OD")` resolves the live value. The payload is a whitelist projection of the published [§C3 contract](https://github.com/zeroatflops/Flops_Unicron/blob/main/Flops_Unicron/docs/architecture/r15-contracts-v1.0.md) — `providers` / `sources` / `num_sources` / `num_providers` / `computation_proof` are dropped by construction.

## 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"
    }
  }
}
```

## Auth tiers

All five tools are **public / key-free** — `list_indices`, `search_indices`, `get_price`, `get_index`, `verify`. Key-free, they return the delayed source-opaque GLOBAL price.

An optional `FLOPS_API_KEY` upgrades these same five tools from the delayed GLOBAL price to **real-time, full-precision** values. The client forwards the key as the `X-FLOPS-Api-Key` header on every request. No key is required to use the server.

Two ways to consume — both serve the same five public tools:

- **Hosted gateway** `https://app.flopsindex.com/mcp` — zero-install, anonymous, delayed GLOBAL price.
- **pip client `flopsindex-mcp`** — set `FLOPS_API_KEY` to upgrade the same five tools to real-time.

A separate partner/pilot programmatic tier exists — contact team@flopsindex.com.

## Environment

| Var | Default | Purpose |
|---|---|---|
| `FLOPS_API_URL` | `https://app.flopsindex.com` | Override for staging / self-host |
| `FLOPS_API_KEY` | _(none)_ | Optional. Forwarded as `X-FLOPS-Api-Key`. Upgrades the five public tools from the delayed GLOBAL price to real-time, full precision. |

## 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.11.0** — the public package is trimmed to the **five public tools** (`list_indices`, `search_indices`, `get_price`, `get_index`, `verify`). Tooling beyond the public surface has been removed from this distribution and is moving to a separate future partner package. `FLOPS_API_KEY` now only upgrades these five tools from the delayed GLOBAL price to real-time, full precision. Supersedes 0.10.0.

**v0.7.0** — `get_index` tool + `flops://index/<id>` MCP **resource** added, both returning the source-opaque [§C3](https://github.com/zeroatflops/Flops_Unicron/blob/main/Flops_Unicron/docs/architecture/r15-contracts-v1.0.md) citation payload (value + verify/citation/permalink, **no** provider/source identities). `USER_AGENT` now derives from `__version__`. R15 Track-D launch round.

**v0.2.x** — `get_price`, `search_indices` added on top of the initial `list_indices` / `verify` surface.

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

## License

Proprietary. © 2026 FLOPS Index.
