KURV voor ontwikkelaars

Breng collecties van KURV naar je eigen apps, websites en agent-workflows. Openbare contracten bevatten de status van de collectie. De HTTP-API geeft de configuratie van collecties en metingen van de chain vrij, de widget toont een collectie waar je haar ook insluit, en met MCP kan een gemachtigde agent een generatieve collectie voorbereiden voor haar maker.

Kies je koppeling

Je wilt	Begin hier
Een agent koppelen en collecties voorbereiden	Een agent koppelen met MCP
Collecties, mintaantallen en contractgegevens lezen	Openbare API’s
De cijfers van KURV lezen met een API-sleutel: lanceringen, mints, volume, vergoedingen, aanmeldingen	Data-API van KURV
Collectiekunst en een Mint-knop op een andere site zetten	Collectie-embeds
Een eigen Mint-knop op elke pagina zetten, op Base of Solana	Minten vanaf je eigen pagina
Een mintervaring bouwen met je eigen walletconnector	Minten vanaf je eigen site

Endpoints en netwerk

Base Sepolia (chain-ID 84532) is de standaard. Concepten met een expliciete version: 2 en network ondersteunen ook geverifieerde implementaties op Solana Devnet en localnet. Lees kurv_builder_spec voor het gekozen netwerk voordat je een concept voorbereidt. De connector heeft nooit de privésleutel van de maker in handen.

Toegangspunt	Adres
Externe MCP-endpoint	https://mcp.kurv.fun/mcp
Overzicht van de openbare API	https://testnet.kurv.fun/api/v1
Collectiecatalogus	https://testnet.kurv.fun/api/v1/collections
KurvDrop-ABI	https://testnet.kurv.fun/api/v1/contracts/kurvdrop
Speeltuin voor koppelingen	KURV voor ontwikkelaars

mcp.kurv.fun is de endpoint voor machines. Deze documentatie is waar de koppelingsinstructies, de toolgids en de voorbeelden van koppelingen staan. Lezen via de API en via een iframe is openbaar en vraagt geen account of API-sleutel. De agentconnector gebruikt OAuth om een specifiek KURV-account te machtigen.

Maken met een agent

1. Voeg https://mcp.kurv.fun/mcp toe in een externe MCP-client die OAuth ondersteunt.
2. Log in op KURV en keur de rechten goed die de client vraagt. Voor schrijven naar collecties en het voorbereiden van een lancering is een bestaande uitnodiging nodig.
3. Vraag de agent het builder-schema te controleren, de collectie te valideren en een eigen concept te maken met een vaste sleutel voor nieuwe pogingen.
4. Upload echte, uitgelijnde kenmerkkunst: hoogstens 240 bronafbeeldingen, unieke kunst inbegrepen, 20 MiB per bronafbeelding in een zip, of 2 MiB per losse inline upload. Generatie uit lagen ondersteunt 1.000 stukken, unieke stukken inbegrepen. Afgewerkte kunst gebruikt kurv_finished_art_limits voor de huidige limieten van het web en de opslagdienst.
5. Open review_url als eigenaar, controleer de precieze kunst en verkoopvoorwaarden en kies dan uitdrukkelijk Publiceren en lanceren voordat er iets openbaar wordt geüpload. Keur de walletsignatuur goed voor die onveranderlijke gepubliceerde momentopname. Een link openen publiceert of ondertekent nooit; latere wijzigingen aan het concept vragen een nieuwe controle. studio_url opent alleen de editor.

De connector heeft 21 tools, de resource kurv://builder-guide en de prompt build-kurv-collection. Een client met een oude cache die 11 tools toont, moet opnieuw koppelen of de tools opnieuw ophalen. De agent bereidt concepten voor; de eigenaar keurt het publiceren en de walletsignatuur goed. Een link van kurv_prepare_launch is geen bevestigde implementatie.

Zie Een agent koppelen met MCP voor rechten, de precieze invoer van elke tool, het gedrag bij nieuwe pogingen en de ondersteunde kunst en verkoopmethoden.

Elders tonen en minten

De collectiewidget toont echte kunst of haar openbare teaser en werkt bevestigde mintaantallen bij. De Mint-knop opent een KURV-venster, waar de koper zijn account en de goedkeuring in zijn wallet regelt. Deze overdracht werkt zonder te leunen op accountcookies binnen een iframe. De Mint-knop doet hetzelfde vanaf elke pagina en laat die pagina weten wanneer een mint klaar is.

Wil je inline minten op je eigen site, gebruik dan het contractadres van de collectie en de openbare ABI met je eigen walletconnector. Lees een verse prijsopgave, keur de vereiste munt van de collectie en een eventuele extra munt goed, simuleer de mint en wacht op het ontvangstbewijs van de transactie. Minten vanaf je eigen site toont de precieze aanroep en hoe die omgaat met openbare fases, kostenplafonds en veilingmodules.

Getallen van een collectie hebben een tijdstempel van hun meting. Een verouderd getal is een eerder bevestigde momentopname. De privémetadata en kunstroots van een niet-onthulde collectie blijven achtergehouden. De regels van het contract, de vergoedingen en de voorwaarden van de collectie gelden voor elke koppeling; lees Kosten en Risico’s en disclaimer.