KURV per sviluppatori

Porta le collezioni di KURV nelle tue app, nei tuoi siti web e nei flussi di lavoro dei tuoi agenti. I contratti pubblici custodiscono lo stato delle collezioni. L’API HTTP espone la configurazione delle collezioni e le letture dalla blockchain, il widget mostra una collezione ovunque tu lo incorpori, e MCP permette a un agente autorizzato di preparare una collezione generativa per il suo creator.

Scegli la tua integrazione

Vuoi	Inizia da qui
Collegare un agente e preparare collezioni	Collega un agente con MCP
Leggere collezioni, conteggi dei mint e informazioni sui contratti	API pubbliche
Leggere i numeri di KURV con una chiave API: lanci, mint, volume, commissioni, iscrizioni	API dei dati di KURV
Mettere le opere di una collezione e un pulsante per mintare su un altro sito	Collezioni da incorporare
Mettere un pulsante Minta tutto tuo su qualsiasi pagina, su Base o su Solana	Minta dalla tua pagina
Creare un’esperienza di mint con il tuo connettore di wallet	Minta dal tuo sito

Endpoint e rete

Base Sepolia (chain ID 84532) è la rete predefinita. Le bozze con version: 2 e network espliciti supportano anche deployment verificati su Solana Devnet e localnet. Leggi kurv_builder_spec per la rete scelta prima di preparare una bozza. Il connettore non custodisce mai la chiave privata del creator.

Punto di accesso	Indirizzo
Endpoint MCP remoto	https://mcp.kurv.fun/mcp
Scoperta dell’API pubblica	https://testnet.kurv.fun/api/v1
Catalogo delle collezioni	https://testnet.kurv.fun/api/v1/collections
ABI di KurvDrop	https://testnet.kurv.fun/api/v1/contracts/kurvdrop
Ambiente interattivo per le integrazioni	KURV per sviluppatori

mcp.kurv.fun è l’endpoint del servizio per le macchine. Questa documentazione è il posto in cui trovi le istruzioni di collegamento, la guida agli strumenti e gli esempi di integrazione. Le letture tramite API e iframe sono pubbliche e non richiedono un account né una chiave API. Il connettore per agenti usa OAuth per autorizzare un account KURV specifico.

Crea con un agente

1. Aggiungi https://mcp.kurv.fun/mcp in un client MCP remoto che supporti OAuth.
2. Accedi su KURV e approva i permessi richiesti dal client. Per scrivere collezioni e preparare lanci serve un invito già esistente.
3. Chiedi all’agente di controllare lo schema del builder, convalidare la collezione e creare una bozza di tua proprietà con una chiave di ripetizione stabile.
4. Carica opere reali dei trait, allineate tra loro: al massimo 240 immagini sorgente, opere uniche comprese, 20 MiB per immagine sorgente in uno ZIP, oppure 2 MiB per singolo caricamento diretto. La generazione a livelli supporta 1.000 pezzi, unici compresi. Per le opere finite, kurv_finished_art_limits riporta i limiti attuali del web e del provider.
5. Apri review_url come proprietario, controlla le opere e le condizioni di vendita esatte, poi scegli esplicitamente Pubblica e lancia prima di qualsiasi caricamento pubblico. Approva la firma del wallet per quell’istantanea pubblicata e immutabile. Aprire un link non pubblica né firma mai nulla; le modifiche successive alla bozza richiedono un nuovo controllo. studio_url apre solo l’editor.

Il connettore ha 21 strumenti, la risorsa kurv://builder-guide e il prompt build-kurv-collection. Un client con una cache che mostra 11 strumenti va ricollegato o deve aggiornare la scoperta. L’agente prepara le bozze; il proprietario approva la pubblicazione e la firma del wallet. Un link da kurv_prepare_launch non è un deployment confermato.

Vedi Collega un agente con MCP per i permessi, gli input esatti degli strumenti, il comportamento delle ripetizioni e i metodi supportati per le opere e la vendita.

Mostra e minta altrove

Il widget della collezione mostra le opere reali o la loro anteprima pubblica e aggiorna i conteggi dei mint confermati. Il suo pulsante Minta apre una finestra di KURV, dove l’acquirente usa il suo account e approva con il suo wallet. Questo passaggio funziona senza dipendere dai cookie dell’account dentro un iframe. Il pulsante Minta fa lo stesso da qualsiasi pagina e avvisa quella pagina quando un mint è andato a buon fine.

Per mintare direttamente nel tuo sito, usa l’indirizzo del contratto della collezione e l’ABI pubblica con il tuo connettore di wallet. Leggi una quotazione aggiornata, autorizza il token della collezione richiesto ed eventuali token aggiuntivi, simula il mint e attendi la ricevuta della transazione. Minta dal tuo sito mostra la chiamata esatta e come gestisce le fasi pubbliche, i tetti di costo e i moduli d’asta.

I dati delle collezioni riportano l’orario della lettura. Un dato non aggiornato è un’istantanea confermata in precedenza. I metadati privati e le radici delle opere di una collezione non ancora rivelata restano riservati. Le regole del contratto, le commissioni e le condizioni della collezione si applicano a ogni integrazione; leggi Commissioni e Rischi e avvertenze.