KURV para desarrolladores

Lleva las colecciones de KURV a tus propias apps, sitios web y flujos de trabajo con agentes. Los contratos públicos guardan el estado de las colecciones. La API HTTP expone la configuración de las colecciones y las lecturas de la cadena, el widget muestra una colección dondequiera que lo incrustes, y MCP permite que un agente autorizado prepare una colección generativa para su creador.

Elige tu integración

Quieres	Empieza aquí
Conectar un agente y preparar colecciones	Conecta un agente con MCP
Leer colecciones, número de acuñaciones e información de los contratos	API públicas
Leer las cifras de KURV con una clave de API: lanzamientos, acuñaciones, volumen, comisiones, registros	API de datos de KURV
Poner el arte de una colección y un botón de acuñar en otro sitio	Colecciones incrustadas
Poner un botón de acuñar propio en cualquier página, en Base o en Solana	Acuña desde tu página
Crear una experiencia de acuñación con tu propio conector de carteras	Acuña desde tu sitio

Endpoints y red

Base Sepolia (chain ID 84532) es la opción por defecto. Los borradores con version: 2 y network explícitos también admiten despliegues verificados en Solana Devnet y localnet. Lee kurv_builder_spec para la red seleccionada antes de preparar un borrador. El conector nunca guarda la clave privada del creador.

Punto de entrada	Dirección
Endpoint MCP remoto	https://mcp.kurv.fun/mcp
Descubrimiento de la API pública	https://testnet.kurv.fun/api/v1
Catálogo de colecciones	https://testnet.kurv.fun/api/v1/collections
ABI de KurvDrop	https://testnet.kurv.fun/api/v1/contracts/kurvdrop
Espacio de integración interactivo	KURV para desarrolladores

mcp.kurv.fun es el endpoint del servicio para máquinas. Esta documentación es donde están las instrucciones de conexión, la guía de herramientas y los ejemplos de integración. Las lecturas de la API y del iframe son públicas y no necesitan cuenta ni clave de API. El conector de agentes usa OAuth para autorizar una cuenta de KURV concreta.

Crea con un agente

1. Añade https://mcp.kurv.fun/mcp en un cliente MCP remoto que admita OAuth.
2. Entra en KURV y aprueba los permisos que pide el cliente. Hace falta tener ya una invitación para escribir colecciones y preparar lanzamientos.
3. Pide al agente que revise el esquema del constructor, valide la colección y cree un borrador propio con una clave de reintento estable.
4. Sube arte de atributos real y alineado: como mucho 240 imágenes de origen, incluido el arte de piezas únicas, 20 MiB por imagen de origen en un ZIP, o 2 MiB por cada subida individual en línea. La generación por capas admite 1.000 piezas, incluidas las únicas. El arte terminado usa kurv_finished_art_limits para los límites actuales de la web y de los proveedores.
5. Abre review_url como dueño, revisa el arte exacto y las condiciones de venta, y luego elige expresamente Publicar y lanzar antes de cualquier subida pública. Aprueba la firma de la cartera para esa instantánea publicada e inmutable. Abrir un enlace nunca publica ni firma; los cambios posteriores en el borrador exigen una nueva revisión. studio_url solo abre el editor.

El conector tiene 21 herramientas, el recurso kurv://builder-guide y el prompt build-kurv-collection. Un cliente con caché que muestra 11 herramientas necesita reconectarse o actualizar el descubrimiento. El agente prepara borradores; el dueño aprueba la publicación y la firma de la cartera. Un enlace de kurv_prepare_launch no es un despliegue confirmado.

Consulta Conecta un agente con MCP para los permisos, las entradas exactas de las herramientas, el comportamiento de los reintentos y los métodos de arte y de venta admitidos.

Muestra y acuña en otro sitio

El widget de la colección muestra el arte real o su avance público y actualiza el número de acuñaciones confirmadas. Su botón de acuñar abre una ventana de KURV para que el comprador apruebe con su cuenta y su cartera. Este traspaso funciona sin depender de las cookies de la cuenta dentro de un iframe. El botón de acuñar hace lo mismo desde cualquier página y avisa a esa página cuando se completa una acuñación.

Para acuñar dentro de tu propio sitio, usa la dirección del contrato de la colección y la ABI pública con tu propio conector de carteras. Lee una cotización reciente, aprueba la moneda de la colección que haga falta y cualquier moneda adicional, simula la acuñación y espera al recibo de su transacción. Acuña desde tu sitio muestra la llamada exacta y cómo maneja las fases públicas, los límites de coste y los módulos de subasta.

Las cifras de una colección llevan una marca de tiempo de lectura. Una cifra desactualizada es una instantánea confirmada anteriormente. Los metadatos privados y las raíces del arte de una colección sin revelar se siguen reservando. Las reglas de los contratos, las comisiones y las condiciones de la colección se aplican a todas las integraciones; lee Comisiones y Riesgos y aviso legal.