SpotGPU

2026年10月に提供終了：SpotGPU APIは停止しました。このパッケージは動作しなくなりました。

spotgpu-mcp

SpotGPU のスポットGPUレンタル料金を取得する MCP（Model Context Protocol）サーバーです。

次の1つのツールを公開します：spot_price → GET /v1/spot（VastとRunPodの最安値＋代替候補）。

クレジット ≠ レンタル料金。 SpotGPU APIのクレジットは、料金の検索に使用されます。
usd_per_hr は上流プロバイダーのレンタル料金であり、SpotGPUの手数料ではありません。

インストール／実行

Python 3.10以上とSpotGPU APIキーが必要です。

APIキーを取得する（無料トライアル、25クレジット）

curl -X POST https://spotgpu-api.fly.dev/v1/keys

認証もメールアドレスも不要です。レスポンスには25トライアルクレジット（検索成功1回につき1クレジット）付きの api_key が含まれます（一度だけ表示されるため、保存してください）。上限は24時間あたりIPごとに3キーです。MCPクライアントの設定で SPOTGPU_API_KEY に設定してください。残高を確認するには、次を実行します。

curl -H "Authorization: Bearer $SPOTGPU_API_KEY" https://spotgpu-api.fly.dev/v1/account

クレジット切れの場合（HTTP 402）

クレジットがなくなると、APIは 402 insufficient_credits を返し、ツールエラーにチャージページへのリンクが表示されます。https://spotgpu-api.fly.dev/topup でクレジットパック（$5／500、$10／1000、$50／5000）を購入するか、Bearerキーを使って POST /v1/checkout に {"pack_id": "credits_500"} を送信すると、Stripe CheckoutのURLを取得できます。401ツールエラーには、上記の登録用curlコマンドが含まれます。

一度だけ実行（PyPI）

uvx spotgpu-mcp

ローカル（このモノレポパッケージ）

cd packages/mcp-spotgpu
uv sync   # or: pip install -e .
export SPOTGPU_API_KEY=sk_…
spotgpu-mcp

環境変数：

変数	必須	デフォルト
SPOTGPU_API_KEY	はい	—
SPOTGPU_BASE_URL	いいえ	https://spotgpu-api.fly.dev

キーをハードコードしないでください。サーバーはMCPをstdioのみで扱います（標準出力には何も出力しないでください）。

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "spotgpu": {
      "command": "uvx",
      "args": ["spotgpu-mcp"],
      "env": {
        "SPOTGPU_API_KEY": "sk_…"
      }
    }
  }
}

uvx の代わりにローカルの編集可能インストールを使う場合：

{
  "mcpServers": {
    "spotgpu": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/spotgpu/packages/mcp-spotgpu", "spotgpu-mcp"],
      "env": {
        "SPOTGPU_API_KEY": "sk_…"
      }
    }
  }
}

Cursor

.cursor/mcp.json（またはユーザーのMCP設定）に追加します：

{
  "mcpServers": {
    "spotgpu": {
      "command": "uvx",
      "args": ["spotgpu-mcp"],
      "env": {
        "SPOTGPU_API_KEY": "sk_…"
      }
    }
  }
}

ツール：spot_price

パラメーター	型	デフォルト	備考
gpu	string	必須	例：RTX_4090
qty	int	1	≥ 1
markets	string	"vast,runpod"	カンマ区切り
fresh	bool	false	fresh=1 に対応

成功すると、APIレスポンス本文のJSONテキスト（best.usd_per_hr、alts など）を返します。

クレジット表記

リクエストには X-SpotGPU-Client: mcp-spotgpu が含まれます。

公開先

• PyPI：https://pypi.org/project/spotgpu-mcp/
• MCP Registry：io.github.flowtestpro-svg/spotgpu-mcp
• Glama：https://glama.ai/mcp/servers/flowtestpro-svg/spotgpu-mcp
• GitHub：https://github.com/flowtestpro-svg/spotgpu-mcp