prime-intellect-mcp
prime-intellect-mcp
Lassen Sie Claude Code Prime Intellect GPU-Pods selbstständig mieten, steuern und beenden — mit festen Ausgabenobergrenzen, die Sie kontrollieren.
Was ist das?
Ein MCP-Server, der Claude Code (oder jeden anderen MCP-Client) mit Ihrem Prime Intellect-Konto verbindet. Damit kann der Agent:
🔍 Finden: Den günstigsten GPU-Pod, der Ihren Anforderungen entspricht.
💸 Angebot einholen: Einen Preis abfragen, bevor Geld ausgegeben wird.
🛒 Bereitstellen: Den Pod provisionieren (nur nachdem Sie
confirm=Truebestätigt haben).🖥️ SSH: Sich per SSH verbinden (der Verbindungs-String wird an das
Bash-Tool des Agenten übergeben).🛑 Beenden: Den Pod beenden, wenn die Arbeit erledigt ist — und laut warnen, falls Sie es vergessen.
Entwickelt für einen Workflow: Sagen Sie Claude: „Miete die günstigste H100, führe mein Trainingsskript aus und beende sie dann“, ohne dass Sie am nächsten Morgen mit einer Rechnung über 400 $ aufwachen.
Related MCP server: claude-colab
Installation in 60 Sekunden
Sie benötigen nur so viel, um mit dem Mieten von GPUs über Claude Code zu beginnen:
1. Einen Prime Intellect API-Schlüssel abrufen
Klicken Sie hier, um einen zu generieren → Berechtigungen festlegen:
Bereich | Ebene |
Instances | Lesen und Schreiben |
Availability | Nur Lesen |
Billing | Nur Lesen |
SSH Keys | Nur Lesen |
Kopieren Sie den Schlüssel — er beginnt mit pit_….
2. Den Server zu Claude Code hinzufügen
Öffnen Sie ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder die .mcp.json Ihres Projekts und fügen Sie Folgendes ein:
{
"mcpServers": {
"prime-intellect": {
"command": "uvx",
"args": ["prime-intellect-mcp"],
"env": {
"PRIME_API_KEY": "pit_PASTE_YOURS_HERE",
"PRIME_MAX_HOURLY_USD": "5",
"PRIME_MAX_TOTAL_USD": "40"
}
}
}
}Das war's. Starten Sie Claude Code neu und fragen Sie: „Welche GPUs sind aktuell für unter 1 $/Std. verfügbar?“
Sie haben kein
uvx? Installieren Sie es mitcurl -LsSf https://astral.sh/uv/install.sh | sh(oderbrew install uv). Es ist ein Einzeilen-Installer für denuv-Paketmanager, und Sie müssen sich nie wieder um eine virtuelle Umgebung (virtualenv) kümmern.
✨ SSH hinzufügen (optional, +2 Min.) — erforderlich, damit Claude tatsächlich Code auf dem Pod ausführen kann
Der obige Server kann bereits Pods bereitstellen, inspizieren und beenden. Damit Claude Code sich jedoch per SSH mit einem laufenden Pod verbinden und Befehle darauf ausführen kann, muss Prime Intellect den öffentlichen SSH-Schlüssel Ihres Computers kennen.
3. Einen SSH-Schlüssel auf Ihrem Computer finden oder generieren
ls ~/.ssh/*.pub # if you have id_ed25519.pub or similar, you're set
# otherwise:
ssh-keygen -t ed25519 -C "you@example.com" # press Enter through the prompts4. Den öffentlichen Schlüssel bei Prime Intellect registrieren
cat ~/.ssh/id_ed25519.pub # or whichever .pub file you haveKopieren Sie die Ausgabe (eine Zeile, die mit ssh-ed25519 … beginnt) und fügen Sie sie in das Formular Add SSH key unter app.primeintellect.ai/dashboard/ssh-keys ein.
Das war's. Zukünftige Pods werden Ihren öffentlichen Schlüssel in der Datei authorized_keys haben, und das Bash-Tool von Claude Code kann sich direkt per SSH verbinden:
ssh ubuntu@<pod-ip-from-pod_status> "nvidia-smi"Kommt in v0.2: ein
register_ssh_keyMCP-Tool, das Schritt 4 direkt aus Claude heraus erledigt (kein Browser-Besuch nötig). Folgen Sie dem Issue-Tracker, um auf dem Laufenden zu bleiben.
Was Claude jetzt tun kann (die 9 Tools)
Tool | Anwendungsfall |
| „Welche GPU-Typen bietet Prime Intellect an?“ |
| „Zeige mir 1×H100 Pods, die für unter 3 $/Std. verfügbar sind.“ |
| „Wie viel Guthaben habe ich noch?“ |
| „Erstelle ein Angebot für eine 1×A100 mit 200 GB Festplatte.“ (kostenlos) |
| „Stelle den Pod aus diesem Angebot bereit.“ (erfordert |
| „Zeige mir meine laufenden Pods.“ |
| „Ist Pod X bereit? Warte, bis SSH-Informationen verfügbar sind.“ |
| „Beende Pod X.“ (erfordert |
| „Habe ich vergessen, etwas zu beenden?“ |
Sicherheit: Nichts wird stillschweigend bereitgestellt
Drei Ebenen, in dieser Reihenfolge:
Zuerst ein Angebot.
pod_quotegibt einen Preis + ein 60-Sekunden-Token zurück. Keine Nebenwirkungen. Der Dollarbetrag befindet sich nun im Kontext des Agenten.Explizite Bestätigung.
pod_create(undpod_terminate) erfordertconfirm=True. Ohne dies erhalten Sie eine Trockenübung (Dry-Run-Vorschau).Feste Umgebungsvariablen-Obergrenzen.
PRIME_MAX_HOURLY_USDblockiert jeden Pod, der über diesem Satz liegt.PRIME_MAX_TOTAL_USDblockiert jeden Pod, dessen (Satz × max_Laufzeit_Stunden) das Budget übersteigt. Das Wallet-Guthaben wird ebenfalls durchgesetzt. Keine dieser Obergrenzen kann durch Tool-Argumente außer Kraft gesetzt werden — sie werden bei jedem Aufruf gelesen.
Standardwerte: PRIME_MAX_HOURLY_USD=5, PRIME_MAX_TOTAL_USD=40. Legen Sie diese im env-Block Ihrer Konfiguration fest.
Jedes pod_create / pod_terminate wird als JSON an ~/.prime-intellect-mcp/audit.log angehängt, sodass Sie eine vollständige Historie darüber haben, was der Agent mit Ihrem Geld gemacht hat.
Beispiel-Prompts (fügen Sie diese in Claude Code ein)
List the cheapest 1×H100 pods available right now. Show me the top 3 by hourly price.Quote a 1×A100 80GB with 100GB disk, 8 vCPU, 64GB RAM. Don't provision yet —
just show me what it would cost.I need to fine-tune a 7B model overnight. Find the cheapest 1×H100 with 200GB
disk, max $40 total budget, max 12 hours. Provision it, give me the SSH command,
and remind me to terminate when I'm done.Check if I have any running pods I forgot about and show me their hourly cost.Terminate pod abc123. Confirm before doing it.Fehlerbehebung
Entweder hat Ihre Claude Code-Konfiguration den env-Block nicht übernommen, oder Sie haben PRIME_API_KEY als eine andere Variable eingegeben. Überprüfen Sie dies mit:
$ env | grep PRIMEim selben Terminal, das Claude Code startet, oder fügen Sie den Schlüssel direkt in den JSON env-Block ein (anstatt ${PRIME_API_KEY} zu verwenden).
Der Agent hat einen Pod ausgewählt, der über Ihrer festen Obergrenze liegt. Entweder:
Wählen Sie eine günstigere GPU (
list_availabilitymit einem Regionsfilter zeigt oft günstigere Community-Preise an), oderErhöhen Sie
PRIME_MAX_HOURLY_USDin Ihrer Konfiguration und starten Sie Claude Code neu.
Angebote sind 60 Sekunden gültig; der Agent hat zu lange zwischen pod_quote und pod_create gewartet. Rufen Sie einfach erneut pod_quote auf — das verursacht keine Kosten.
Die Bereitstellung ist noch nicht vollständig abgeschlossen. Der Pod ist aktiv, führt aber noch sein Installationsskript aus. Rufen Sie pod_status(pod_id, wait_for_ssh=True) auf, und es wird blockiert (mit Abfrage alle 5 Sekunden), bis SSH verfügbar ist.
Sie haben Prime Intellect Ihren öffentlichen Schlüssel nicht mitgeteilt (oder der Pod wurde bereitgestellt, bevor Sie ihn registriert haben). Lösung:
Überprüfen Sie, ob Ihr öffentlicher Schlüssel unter app.primeintellect.ai/dashboard/ssh-keys registriert ist.
Erneute Bereitstellung — die
authorized_keysdes Pods werden zum Zeitpunkt der Erstellung festgelegt, daher übernehmen bestehende Pods keine Schlüssel, die Sie nachträglich registriert haben.Wenn Ihr privater Schlüssel eine Passphrase hat, führen Sie einmalig
ssh-add --apple-use-keychain ~/.ssh/your_keyauf macOS aus, damit der Agent ihn ab jetzt stillschweigend entsperrt.
Laden Sie Ihr Guthaben unter app.primeintellect.ai/wallet auf und versuchen Sie es erneut.
Warum noch eine Lösung?
Es gibt einen prime-mcp-server 0.1.2 auf PyPI. Dies ist ein einfacher Proof-of-Concept; dies ist kein Fork. Unterschiede für den unbeaufsichtigten Betrieb über Nacht:
|
| |
Zwei-Schritte-Angebot → Bestätigung | ✅ | ❌ |
Feste Ausgabenobergrenzen (Env-Var) | ✅ | ❌ |
Wallet-Vorabprüfung | ✅ | ❌ |
Erkennung von "Runaway"-Pods | ✅ | ❌ |
SSH-Übergabe an Agent | ✅ | ❌ |
Tests | 32 Unit + optional Live | Keine |
Lokale Entwicklung
git clone https://github.com/kvrancic/prime-intellect-mcp
cd prime-intellect-mcp
uv sync
uv run pytest -m "not live" # 32 fast tests, no network, no spend
uv run ruff check .
uv run mypy srcLive-Rauchtest (stellt die günstigste verfügbare GPU bereit, führt nvidia-smi aus, beendet sie; ca. 0,05 $ Kosten):
PRIME_API_KEY=pit_... PRIME_LIVE_TEST=1 PRIME_LIVE_MAX_HOURLY=0.60 \
PRIME_MAX_HOURLY_USD=0.60 PRIME_MAX_TOTAL_USD=2.00 \
uv run pytest tests/test_smoke_live.py -v -sRoadmap
v0.2 —
register_ssh_keyMCP-Tool (Dashboard-Schritt entfällt), Sandboxes (prime-sandboxesSDK), Environments Hubv0.3 — Optionaler Auto-Terminate-Daemon (serverseitige Durchsetzung von
max_lifetime_hours); Kosten-Telemetriev1.0+ — Gehostete/OAuth-Bereitstellung, sobald Prime Intellect OAuth anbietet; Einreichung beim Anthropic Connector-Verzeichnis
Danksagungen
Prime Intellect für das
primePython SDK, das 90 % der Arbeit erledigtMIT 6.8610 (Advanced NLP) für die Prime Intellect-Guthaben, die das Testen ermöglicht haben
FastMCP für das Framework
Lizenz
MIT — siehe LICENSE.
Mitwirken
Issues und PRs sind willkommen. Bitte führen Sie uv run pytest -m "not live" und uv run ruff check . aus, bevor Sie etwas einreichen.
Available Tools
9 toolsget_wallet_balanceA
Return the current Prime Intellect wallet balance and recent billings.
Use this to estimate how long a quoted pod can run, or to check why pod_create returned an insufficient-funds error.
Inputs: no named parameters. Returns: object
list_availabilityA
List currently-available GPU pods that match the filters.
Returns the SDK's GPUAvailability rows (cloud_id, gpu_type, gpu_count, prices, disk/vcpu/memory bounds, stock_status, ...). Use this to pick a target before pod_quote, or to show the user options.
Inputs: gpu_type, gpu_count, regions. Returns: object
list_gpu_typesA
List every GPU type Prime Intellect currently offers (e.g. "H100_80GB", "A100_80GB").
Use this when the user is vague about what they want. Pass the result into list_availability or pod_quote.
Inputs: no named parameters. Returns: result
pod_check_runawayA
Return locally-tracked pods that have run past max_lifetime_hours OR whose accumulated cost is approaching PRIME_MAX_TOTAL_USD.
Call this at the start of long-running sessions to catch forgotten pods.
Inputs: no named parameters. Returns: result
pod_createA
Provision a Prime Intellect GPU pod (or preview the provisioning).
With confirm=False: returns a dry-run preview describing what would happen. With confirm=True: validates spend caps + quote freshness, then provisions.
The server enforces:
quote_token must be fresh (TTL 60s)
hourly_usd ≤ PRIME_MAX_HOURLY_USD
hourly_usd × max_lifetime_hours ≤ PRIME_MAX_TOTAL_USD
estimated total ≤ wallet balance
On success, the pod is recorded in local state.json so pod_check_runaway can warn about overdue pods later.
Inputs: quote_token (required), name (required), max_lifetime_hours, confirm, +1 more. Returns: object
pod_listA
List every pod the API key can see (active + provisioning + stopped).
Inputs: no named parameters. Returns: result
pod_quoteA
Get a non-binding price quote + reserved provisioning payload.
Returns a quote_token (TTL=60s) that you pass to pod_create with confirm=True to actually provision. This tool has NO side effects.
The server picks the cheapest matching GPUAvailability row that satisfies the requested disk/vcpu/memory. If none matches, returns an error explaining what's available.
Inputs: gpu_type (required), gpu_count, disk_size_gb, vcpus, +2 more. Returns: object
pod_statusA
Get the current status (provisioning / active / failed) for a pod.
With wait_for_ssh=True, blocks (polls every 5s) until ssh_connection is
available — that's when you can SSH in. Returns the SSH connection string
in ssh_connection (e.g. "root@1.2.3.4 -p 22000"). Use it from your Bash
tool: ssh -o StrictHostKeyChecking=no <ssh_connection> "<cmd>".
Inputs: pod_id (required), wait_for_ssh, timeout_s. Returns: object
pod_terminateA
Destroy (terminate) a pod. Idempotent on already-deleted pods.
Without confirm=True, returns a no-op preview so you can re-read your decision.
Inputs: pod_id (required), confirm. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool has a unique and clearly distinct purpose, from wallet balance and GPU availability listing to pod creation, quoting, and termination. There is no overlap that could cause an agent to select the wrong tool.
Tool names follow a consistent pattern: utility functions use verb_noun (e.g., get_wallet_balance, list_availability) and pod operations all start with pod_ (e.g., pod_create, pod_terminate). The naming is predictable and easily understood.
With 9 tools covering wallet, GPU types, availability, pod lifecycle (create, list, status, quote, terminate), and runaway monitoring, the count is well-scoped for the server's purpose. Each tool earns its place with no redundancy.
The tool surface covers the full lifecycle of GPU pod management: discovering availability, quoting, creating, monitoring status, listing, terminating, and checking for runaway pods. The inclusion of wallet balance and wait-for-SSH functionality addresses common operational needs.
Maintenance
Related MCP Connectors
Rent GPUs at live prices and serve any Hugging Face model, with spend caps for AI agents.
AI cloud for agents: launch GPUs, run jobs that stop their own billing, schedule runs.
Rent cloud GPUs from AI agents: live prices, VRAM estimates, launch, logs and stop.
Rent A100 and H100 GPUs by the minute from your agent, within a spending limit you set.
Related MCP Servers
- AlicenseAqualityFmaintenanceA server that allows LLMs to run Claude Code with all permissions bypassed automatically, enabling code execution and file editing without permission interruptions.1793 npm1,315MIT
- AlicenseNot gradedqualityFmaintenanceEnables Claude Code to execute shell commands, Python code, and file transfers on a Google Colab T4 GPU via an MCP server, bridging the GPU gap for AI coding agents.6MIT
- AlicenseAqualityDmaintenanceThis MCP server enables remote control and management of Claude Code agents, allowing you to execute missions, configure agent personalities, and integrate with other MCP tools.715 npm1MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server that lets any MCP-capable agent spawn and drive Claude Code sessions — effectively turning Claude Code into an orchestratable sub-agent fleet.107 npmMIT