KURV für Entwickler

Hol KURV-Kollektionen in deine eigenen Apps, Websites und Agenten-Workflows. Öffentliche Verträge halten den Zustand der Kollektion. Die HTTP-API stellt die Konfiguration der Kollektion und Messwerte von der Chain bereit, das Widget zeigt eine Kollektion überall, wo du es einbettest, und MCP lässt einen autorisierten Agenten eine generative Kollektion für ihren Creator vorbereiten.

Wähle deine Integration

Du willst	Hier anfangen
Einen Agenten verbinden und Kollektionen vorbereiten	Einen Agenten per MCP verbinden
Kollektionen, Mint-Zahlen und Vertragsinformationen lesen	Öffentliche APIs
Die Zahlen von KURV mit einem API-Schlüssel lesen: Starts, Mints, Volumen, Gebühren, Anmeldungen	KURV-Daten-API
Kunst einer Kollektion und eine Mint-Schaltfläche auf eine andere Website bringen	Kollektions-Einbettungen
Eine eigene Mint-Schaltfläche auf jede Seite setzen, auf Base oder Solana	Von deiner Seite aus minten
Ein Mint-Erlebnis mit deinem eigenen Wallet-Connector bauen	Auf deiner Website minten

Endpunkte und Netzwerk

Base Sepolia (Chain-ID 84532) ist der Standard. Ausdrückliche Entwürfe mit version: 2 und network unterstützen außerdem verifizierte Deployments auf Solana Devnet und localnet. Lies kurv_builder_spec für das gewählte Netzwerk, bevor du einen Entwurf vorbereitest. Der Connector hält nie den privaten Schlüssel des Creators.

Einstiegspunkt	Adresse
Entfernter MCP-Endpunkt	https://mcp.kurv.fun/mcp
Discovery der öffentlichen API	https://testnet.kurv.fun/api/v1
Kollektionskatalog	https://testnet.kurv.fun/api/v1/collections
KurvDrop-ABI	https://testnet.kurv.fun/api/v1/contracts/kurvdrop
Integrations-Spielwiese	KURV für Entwickler

mcp.kurv.fun ist der Endpunkt des Maschinendienstes. In dieser Doku stehen die Verbindungsanleitung, der Tool-Leitfaden und die Integrationsbeispiele. Lesezugriffe über API und iframe sind öffentlich und brauchen weder Konto noch API-Schlüssel. Der Agenten-Connector nutzt OAuth, um ein bestimmtes KURV-Konto zu autorisieren.

Mit einem Agenten erstellen

1. Füge https://mcp.kurv.fun/mcp in einem entfernten MCP-Client hinzu, der OAuth unterstützt.
2. Melde dich bei KURV an und erlaube die Berechtigungen, die der Client anfragt. Für Schreibzugriffe auf Kollektionen und die Vorbereitung eines Starts brauchst du eine bestehende Einladung.
3. Bitte den Agenten, das Builder-Schema zu prüfen, die Kollektion zu validieren und einen eigenen Entwurf mit einem stabilen Wiederholungsschlüssel zu erstellen.
4. Lade echte, ausgerichtete Merkmalskunst hoch: höchstens 240 Quellbilder, Unikate eingeschlossen, 20 MiB pro Quellbild in einem ZIP oder 2 MiB pro einzelnem Inline-Upload. Die Generierung aus Ebenen unterstützt 1.000 Stücke, Unikate eingeschlossen. Für fertige Kunst gelten die aktuellen Grenzen für Web und Anbieter aus kurv_finished_art_limits.
5. Öffne review_url als Besitzer, prüfe die genaue Kunst und die Verkaufsbedingungen und wähle dann ausdrücklich Veröffentlichen und starten, bevor irgendetwas öffentlich hochgeladen wird. Bestätige die Wallet-Signatur für diesen unveränderlichen veröffentlichten Stand. Das Öffnen eines Links veröffentlicht oder signiert nie; spätere Änderungen am Entwurf brauchen eine neue Prüfung. studio_url öffnet nur den Editor.

Der Connector hat 21 Tools, die Ressource kurv://builder-guide und den Prompt build-kurv-collection. Ein Client mit Cache, der 11 Tools zeigt, muss sich neu verbinden oder seine Discovery erneuern. Der Agent bereitet Entwürfe vor; der Besitzer bestätigt das Veröffentlichen und die Wallet-Signatur. Ein Link aus kurv_prepare_launch ist kein bestätigtes Deployment.

Unter Einen Agenten per MCP verbinden findest du Berechtigungen, genaue Tool-Eingaben, das Verhalten bei Wiederholungen und die unterstützten Kunst- und Verkaufsarten.

Woanders anzeigen und minten

Das Kollektions-Widget zeigt echte Kunst oder ihren öffentlichen Teaser und aktualisiert bestätigte Mint-Zahlen. Seine Mint-Schaltfläche öffnet ein KURV-Fenster, damit der Käufer mit seinem Konto und seiner Wallet bestätigt. Diese Übergabe funktioniert, ohne sich auf Konto-Cookies in einem iframe zu verlassen. Die Mint-Schaltfläche tut dasselbe von jeder Seite aus und sagt dieser Seite Bescheid, wenn ein Mint durch ist.

Um direkt auf deiner eigenen Website zu minten, nutze die Vertragsadresse der Kollektion und die öffentliche ABI mit deinem eigenen Wallet-Connector. Lies ein frisches Angebot, gib den nötigen Coin der Kollektion und jeden zusätzlichen Coin frei, simuliere den Mint und warte auf den Beleg seiner Transaktion. Auf deiner Website minten zeigt den genauen Aufruf und wie er mit öffentlichen Phasen, Kostenobergrenzen und Auktionsmodulen umgeht.

Die Zahlen einer Kollektion tragen einen Zeitstempel ihrer Messung. Eine veraltete Zahl ist ein zuvor bestätigter Stand. Die privaten Metadaten und Kunst-Roots einer nicht aufgedeckten Kollektion bleiben zurückgehalten. Vertragsregeln, Gebühren und die Bedingungen der Kollektion gelten für jede Integration; lies Gebühren und Risiken und Haftungsausschluss.