KURV pour les développeurs

Intégrez les collections KURV dans vos propres apps, sites web et flux de travail d’agents. Des contrats publics conservent l’état des collections. L’API HTTP expose la configuration des collections et les lectures de la chaîne, le widget affiche une collection partout où vous l’intégrez, et MCP permet à un agent autorisé de préparer une collection générative pour son créateur.

Choisir votre intégration

Vous voulez	Commencez ici
Connecter un agent et préparer des collections	Connecter un agent avec MCP
Lire les collections, le nombre de mints et les informations des contrats	API publiques
Lire les chiffres de KURV avec une clé d’API : lancements, mints, volume, frais, inscriptions	API de données KURV
Mettre l’art d’une collection et un bouton Minter sur un autre site	Intégrations de collections
Mettre un bouton Minter bien à vous sur n’importe quelle page, sur Base ou sur Solana	Minter depuis votre page
Créer une expérience de mint avec votre propre connecteur de portefeuille	Minter depuis votre site

Points d’accès et réseau

Base Sepolia (ID de chaîne 84532) est le réseau par défaut. Les brouillons avec version: 2 et network explicites prennent aussi en charge les déploiements vérifiés sur Solana Devnet et en localnet. Lisez kurv_builder_spec pour le réseau choisi avant de préparer un brouillon. Le connecteur ne détient jamais la clé privée du créateur.

Point d’entrée	Adresse
Point d’accès MCP distant	https://mcp.kurv.fun/mcp
Découverte de l’API publique	https://testnet.kurv.fun/api/v1
Catalogue des collections	https://testnet.kurv.fun/api/v1/collections
ABI de KurvDrop	https://testnet.kurv.fun/api/v1/contracts/kurvdrop
Bac à sable d’intégration	KURV pour les développeurs

mcp.kurv.fun est le point d’accès du service machine. Cette documentation rassemble les instructions de connexion, le guide des outils et les exemples d’intégration. Les lectures par l’API et par iframe sont publiques et ne demandent ni compte ni clé d’API. Le connecteur pour agents utilise OAuth pour autoriser un compte KURV précis.

Créer avec un agent

1. Ajoutez https://mcp.kurv.fun/mcp dans un client MCP distant qui prend en charge OAuth.
2. Connectez-vous sur KURV et approuvez les autorisations demandées par le client. Une invitation existante est requise pour écrire des collections et préparer un lancement.
3. Demandez à l’agent de vérifier le schéma du builder, de valider la collection et de créer un brouillon qui vous appartient, avec une clé de nouvelle tentative stable.
4. Envoyez de vrais visuels d’attributs alignés : au plus 240 images sources, art unique compris, 20 Mio par image source dans un ZIP, ou 2 Mio par envoi individuel en ligne. La génération par calques prend en charge 1 000 pièces, uniques compris. Pour les œuvres finies, kurv_finished_art_limits donne les limites actuelles du web et du fournisseur.
5. Ouvrez review_url en tant que propriétaire, examinez l’art exact et les conditions de vente, puis choisissez explicitement Publier et lancer avant tout envoi public. Approuvez la signature du portefeuille pour cet instantané publié et immuable. Ouvrir un lien ne publie ni ne signe jamais rien ; toute modification ultérieure du brouillon demande une nouvelle vérification. studio_url ouvre uniquement l’éditeur.

Le connecteur compte 21 outils, la ressource kurv://builder-guide et le prompt build-kurv-collection. Un client en cache qui affiche 11 outils doit se reconnecter ou rafraîchir sa découverte. L’agent prépare les brouillons ; le propriétaire approuve la publication et la signature du portefeuille. Un lien renvoyé par kurv_prepare_launch n’est pas un déploiement confirmé.

Voir Connecter un agent avec MCP pour les autorisations, les entrées exactes des outils, le comportement des nouvelles tentatives et les modes d’art et de vente pris en charge.

Afficher et minter ailleurs

Le widget de collection affiche l’art réel ou son aperçu public et met à jour le nombre de mints confirmés. Son bouton Minter ouvre une fenêtre KURV pour le compte de l’acheteur et l’approbation de son portefeuille. Ce passage de relais fonctionne sans dépendre des cookies de compte dans une iframe. Le bouton Minter fait de même depuis n’importe quelle page et prévient cette page quand un mint est terminé.

Pour minter directement dans votre propre site, utilisez l’adresse du contrat de la collection et l’ABI publique avec votre propre connecteur de portefeuille. Lisez un devis récent, approuvez le jeton requis par la collection et tout jeton supplémentaire, simulez le mint et attendez le reçu de sa transaction. Minter depuis votre site montre l’appel exact et la façon dont il gère les phases publiques, les plafonds de coût et les modules d’enchères.

Les chiffres d’une collection portent l’horodatage de leur lecture. Un chiffre périmé est un instantané confirmé auparavant. Les métadonnées privées et les racines d’art d’une collection non révélée restent cachées. Les règles des contrats, les frais et les conditions de la collection s’appliquent à toute intégration ; lisez Frais et Risques et avertissement.