MCP server for FLOPS public compute indices — catalog, search, price, verify. Works with Claude, Cursor, Windsurf, or any MCP host.
Project description
flopsindex-mcp
PyPI release mirror. Source of truth:
flopsindexmonorepo (mcp/). Refresh withflopsindex/scripts/sync-publish.ps1before publishing.
See also — Python SDK flopsindex · TypeScript SDK @flopsindex/sdk · live catalog app.flopsindex.com/v2/catalog/public
MCP server for the FLOPS public compute price indices — catalog, search, price lookup, and verification over stdio. Works with Claude, Cursor, Windsurf, or any MCP-capable host.
Monorepo — flopsindex · Public access overview
Public access
This package exposes the public FLOPS index surface only: citeable reference rates with verify and permalink URLs. Index construction methodology is not published in this repository — see flopsindex.com and the public access overview.
| Access | What you get | How (this package) |
|---|---|---|
| Anonymous (default) | Delayed public price (~6h grid; indicative, not for settlement) for the FLOPS family (FLOPS-SPOT, FLOPS-OD, FLOPS-DEPIN). Built for agents, citation, and lookup. | No API key — stdio server or hosted /mcp |
| Keyed | Same five tools at real-time, full precision. | Set FLOPS_API_KEY (forwarded as X-FLOPS-Api-Key) |
| Partner | Higher fidelity, expanded coverage, and additional detail beyond the public delayed surface. | team@flopsindex.com |
If you need more than delayed public rates — e.g. production-grade latency, broader index families, or deeper commercial terms — reach out to team@flopsindex.com to discuss partner options.
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 search across the public catalog (resolves to slugs). |
get_price |
Latest published price + confidence for one index. |
get_index |
Source-opaque public payload — the citation shape (index_id, value, unit, as_of, data_tier, confidence, change_24h, disclaimer, methodology_url, verify_url, citation_url, permalink, upgrade). Use this when you intend to cite a value. |
verify |
Latest published value + verify metadata for a given index_id. |
Resources
Every public index is also exposed as an MCP resource:
| URI | Returns |
|---|---|
flops://index/<INDEX_ID> |
Same source-opaque payload as get_index, mimeType: application/json. |
list_resources enumerates one entry per catalog index; read_resource("flops://index/FLOPS-H100-OD") resolves the live value.
Install
uv tool install flopsindex-mcp
# or
pip install flopsindex-mcp
Setup
Point your MCP host at the server. Config file location depends on the client (Claude Code, Cursor, Windsurf, etc.):
{
"mcpServers": {
"flopsindex": {
"command": "flopsindex-mcp"
}
}
}
Or use the hosted gateway at https://app.flopsindex.com/mcp — same five tools, no local install.
Environment
| Var | Default | Purpose |
|---|---|---|
FLOPS_API_URL |
https://app.flopsindex.com |
Override base URL |
FLOPS_API_KEY |
(none) | Optional. Upgrades the five public tools to full precision. |
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file flopsindex_mcp-0.12.1.tar.gz.
File metadata
- Download URL: flopsindex_mcp-0.12.1.tar.gz
- Upload date:
- Size: 17.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
51a3ff45be897b174835e0388e4c02cf7c64fbef8d9a14638b54474846b36afa
|
|
| MD5 |
72b3606783c6b07d5f9a9c1a5e374f4a
|
|
| BLAKE2b-256 |
eeec92a407273442b8b41ec1d9f71395c54ca6492cc15bcab3835c091c762925
|
File details
Details for the file flopsindex_mcp-0.12.1-py3-none-any.whl.
File metadata
- Download URL: flopsindex_mcp-0.12.1-py3-none-any.whl
- Upload date:
- Size: 13.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6ceb064b9703348fa0cb32f76021cbbce9222c03676ae91b2421da88f675ef53
|
|
| MD5 |
4c486b4f395fd340697c1f5ec5f81d4e
|
|
| BLAKE2b-256 |
f37ab364ef73cc100fedd20d51bf8ba1b9accc578c9583f631a82ecb3ed008e1
|