flopsindex-mcp 0.1.0__tar.gz

flopsindex_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: flopsindex-mcp
+Version: 0.1.0
+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`). |
+| `verify` | Fetch the latest published value + audit receipt for a given `index_id`. |
+
+More tools (`get_methodology`, `get_forward_curve`, `get_settlement`) are tracked in the FLOPS Track D roadmap.
+
+## 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.1.0** — MVP. Scaffolded 2026-05-12. Not yet published to PyPI / smithery.ai / glama.ai.
+
+## License
+
+Proprietary. © 2026 FLOPS Index.

flopsindex_mcp-0.1.0/README.md

@@ -0,0 +1,62 @@
+# 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`). |
+| `verify` | Fetch the latest published value + audit receipt for a given `index_id`. |
+
+More tools (`get_methodology`, `get_forward_curve`, `get_settlement`) are tracked in the FLOPS Track D roadmap.
+
+## 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.1.0** — MVP. Scaffolded 2026-05-12. Not yet published to PyPI / smithery.ai / glama.ai.
+
+## License
+
+Proprietary. © 2026 FLOPS Index.

flopsindex_mcp-0.1.0/flopsindex_mcp/__init__.py

@@ -0,0 +1,10 @@
+"""FLOPS Compute Intelligence Platform — MCP server.
+
+Exposes the public FLOPS index catalog + verification endpoints as
+Model Context Protocol tools so AI agents (Claude Code, Cursor,
+Windsurf, etc.) can cite live FLOPS indices directly during sessions.
+
+Per Track D LLM-discoverability plan: one ship = FLOPS inside every
+Claude / Cursor / Windsurf session that installs this server.
+"""
+__version__ = "0.1.0"

flopsindex_mcp-0.1.0/flopsindex_mcp/server.py

@@ -0,0 +1,171 @@
+"""FLOPS MCP server.
+
+Tools (MVP):
+  list_indices   — Enumerate all public FLOPS indices (id, family, cadence)
+  get_index      — Fetch a single index's current value + methodology pointer
+  verify         — Cryptographic / receipt verification for a published value
+  get_catalog    — Full reference catalog (paginated)
+
+Backed by the dashboard's auth-free endpoints:
+  GET /v2/catalog/public
+  GET /v1/verify?index_id=...
+  GET /demo/all-indices  (requires basic auth; not exposed via MCP yet)
+
+Run locally:
+  uv tool install flopsindex-mcp
+  flopsindex-mcp
+
+Or wire into Claude Code:
+  claude mcp add flopsindex -- flopsindex-mcp
+"""
+from __future__ import annotations
+
+import json
+import os
+from typing import Any
+
+import httpx
+from mcp.server import Server
+from mcp.server.stdio import stdio_server
+from mcp.types import TextContent, Tool
+
+DEFAULT_BASE_URL = "https://app.flopsindex.com"
+BASE_URL = os.environ.get("FLOPS_API_URL", DEFAULT_BASE_URL).rstrip("/")
+HTTP_TIMEOUT_S = 15.0
+USER_AGENT = "flopsindex-mcp/0.1.0"
+
+server: Server = Server("flopsindex")
+
+
+# ---------------------------------------------------------------------------
+# Tool declarations (MCP `list_tools`)
+# ---------------------------------------------------------------------------
+
+@server.list_tools()
+async def list_tools() -> list[Tool]:
+    return [
+        Tool(
+            name="list_indices",
+            description=(
+                "List all public FLOPS compute-price indices. "
+                "Returns a JSON array of {index_id, family, cadence, unit}. "
+                "Use this to discover available indices before calling "
+                "get_index or verify. No auth required."
+            ),
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "family_filter": {
+                        "type": "string",
+                        "description": (
+                            "Optional family prefix to filter by "
+                            "(e.g. 'FLOPS-H100' or 'FLOPS-B300'). "
+                            "Case-sensitive substring match."
+                        ),
+                    },
+                },
+            },
+        ),
+        Tool(
+            name="verify",
+            description=(
+                "Verify a FLOPS index value: returns the latest published "
+                "value, methodology pointer, source-count, and audit "
+                "receipt for the given index_id. Use to cite a FLOPS "
+                "index with provenance."
+            ),
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "index_id": {
+                        "type": "string",
+                        "description": (
+                            "FLOPS index identifier "
+                            "(e.g. 'FLOPS-H100-OD-T1', 'FLOPS-B300-SPOT')."
+                        ),
+                    },
+                },
+                "required": ["index_id"],
+            },
+        ),
+    ]
+
+
+# ---------------------------------------------------------------------------
+# Tool implementations (MCP `call_tool`)
+# ---------------------------------------------------------------------------
+
+async def _get_json(path: str, params: dict[str, Any] | None = None) -> Any:
+    async with httpx.AsyncClient(
+        timeout=HTTP_TIMEOUT_S,
+        headers={"User-Agent": USER_AGENT, "Accept": "application/json"},
+    ) as c:
+        r = await c.get(f"{BASE_URL}{path}", params=params)
+        r.raise_for_status()
+        return r.json()
+
+
+async def _tool_list_indices(args: dict[str, Any]) -> str:
+    family = (args.get("family_filter") or "").strip() or None
+    data = await _get_json("/v2/catalog/public")
+    indices = data.get("indices") if isinstance(data, dict) else data
+    if not isinstance(indices, list):
+        indices = []
+    if family:
+        indices = [i for i in indices if family in (i.get("index_id") or "")]
+    return json.dumps({
+        "count": len(indices),
+        "family_filter": family,
+        "indices": indices,
+        "source": f"{BASE_URL}/v2/catalog/public",
+    }, indent=2)
+
+
+async def _tool_verify(args: dict[str, Any]) -> str:
+    index_id = (args.get("index_id") or "").strip()
+    if not index_id:
+        return json.dumps({"error": "index_id is required"})
+    data = await _get_json("/v1/verify", params={"index_id": index_id})
+    return json.dumps(data, indent=2)
+
+
+@server.call_tool()
+async def call_tool(name: str, args: dict[str, Any]) -> list[TextContent]:
+    try:
+        if name == "list_indices":
+            out = await _tool_list_indices(args)
+        elif name == "verify":
+            out = await _tool_verify(args)
+        else:
+            out = json.dumps({"error": f"unknown tool: {name}"})
+    except httpx.HTTPStatusError as exc:
+        out = json.dumps({
+            "error": "upstream_http_error",
+            "status": exc.response.status_code,
+            "url": str(exc.request.url),
+        })
+    except Exception as exc:  # noqa: BLE001
+        out = json.dumps({"error": "tool_failed", "detail": str(exc)})
+    return [TextContent(type="text", text=out)]
+
+
+# ---------------------------------------------------------------------------
+# Entry point
+# ---------------------------------------------------------------------------
+
+async def _run() -> None:
+    async with stdio_server() as (read_stream, write_stream):
+        await server.run(
+            read_stream,
+            write_stream,
+            server.create_initialization_options(),
+        )
+
+
+def main() -> None:
+    import asyncio
+    asyncio.run(_run())
+
+
+if __name__ == "__main__":
+    main()

flopsindex_mcp-0.1.0/flopsindex_mcp.egg-info/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: flopsindex-mcp
+Version: 0.1.0
+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`). |
+| `verify` | Fetch the latest published value + audit receipt for a given `index_id`. |
+
+More tools (`get_methodology`, `get_forward_curve`, `get_settlement`) are tracked in the FLOPS Track D roadmap.
+
+## 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.1.0** — MVP. Scaffolded 2026-05-12. Not yet published to PyPI / smithery.ai / glama.ai.
+
+## License
+
+Proprietary. © 2026 FLOPS Index.

flopsindex_mcp-0.1.0/flopsindex_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+flopsindex_mcp/__init__.py
+flopsindex_mcp/server.py
+flopsindex_mcp.egg-info/PKG-INFO
+flopsindex_mcp.egg-info/SOURCES.txt
+flopsindex_mcp.egg-info/dependency_links.txt
+flopsindex_mcp.egg-info/entry_points.txt
+flopsindex_mcp.egg-info/requires.txt
+flopsindex_mcp.egg-info/top_level.txt

flopsindex_mcp-0.1.0/flopsindex_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

flopsindex_mcp-0.1.0/flopsindex_mcp.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+flopsindex-mcp = flopsindex_mcp.server:main

flopsindex_mcp-0.1.0/flopsindex_mcp.egg-info/requires.txt

@@ -0,0 +1,6 @@
+mcp>=1.0.0
+httpx>=0.26.0
+
+[dev]
+pytest>=8.0.0
+pytest-asyncio>=0.23.0

flopsindex_mcp-0.1.0/flopsindex_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+flopsindex_mcp

flopsindex_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "flopsindex-mcp"
+version = "0.1.0"
+description = "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."
+readme = "README.md"
+requires-python = ">=3.11"
+license = {text = "Proprietary"}
+authors = [{name = "Ash Chary", email = "ash@flopsindex.com"}]
+keywords = ["mcp", "flops", "gpu", "compute", "pricing", "claude", "agents"]
+
+dependencies = [
+    "mcp>=1.0.0",
+    "httpx>=0.26.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+]
+
+[project.scripts]
+flopsindex-mcp = "flopsindex_mcp.server:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["flopsindex_mcp*"]

flopsindex_mcp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+