El Collection Blueprint

KURV funciona hoy en Base Sepolia y Solana Devnet. Esta página es la guía de campo sacada de una construcción completa (HANI the Dog, 1.000 piezas, 20 únicas), escrita para un creador que trabaja con un agente de IA a través del conector de KURV en https://mcp.kurv.fun/mcp. El conector ofrece la misma guía a los agentes como el recurso kurv://blueprint, y la herramienta kurv_builder_spec es la fuente de verdad: si esta página y la herramienta no coinciden, fíate de la herramienta.

Conecta un agente

1. Añade https://mcp.kurv.fun/mcp como servidor MCP remoto en un cliente que admita MCP remoto con OAuth. Conecta un agente con MCP enumera los clientes y sus pasos.
2. Entra en KURV en el navegador y aprueba la conexión. Tú eliges lo que puede hacer (solo leer; leer y crear borradores; o leer, crear borradores y preparar lanzamientos) y cuánto dura.
3. Pide al agente que lea kurv://blueprint y que luego llame a kurv_account y kurv_builder_spec para tu red. El conector también ofrece el prompt build-kurv-collection, que lleva al agente por esta página con cada parada de aprobación en su sitio.

Quién hace qué

El agente planifica, valida, crea el borrador, sube el arte, genera vistas previas y prepara el lanzamiento. Tú apruebas el arte, las muestras y cada aviso, y luego abres el enlace de revisión y firmas el lanzamiento con tu propia cartera. El agente nunca despliega, nunca firma y nunca pide una clave privada ni una frase semilla. Una vez que el arte está terminado y aprobado, la parte de KURV (validar, crear, subir, previsualizar, preparar) lleva unos 20 minutos. Hacer buen arte lleva más tiempo, y así debe ser.

Los límites

Elemento	Límite
Tamaño de la colección	De 1 a 1.000 piezas, únicas incluidas: 980 piezas al azar y 20 únicas son un tamaño de 1.000.
Capas	Hasta 12.
Imágenes de atributos	Hasta 240 en total entre todas las capas, incluido el arte que solo usan las únicas. Una capa vacía no cuenta.
Únicas	Hasta 32.
Reglas	Hasta 48, las mismas en todas las redes.
Tamaño de archivo de imagen	Hasta 2 MiB por imagen enviada de una en una; hasta 20 MiB por imagen dentro de un zip.
Lienzo	Cuadrado, de hasta 2.048 por 2.048 píxeles. Cada archivo tiene exactamente el tamaño del lienzo.
Formatos	Fondo: PNG, JPEG o WebP. Cualquier otra capa: PNG con transparencia real.
El nombre None	Reservado, con cualquier combinación de mayúsculas y minúsculas. Nunca un atributo llamado None, nunca una imagen vacía: una capa se vuelve opcional con noneWeight.
Descripción	Trátala como obligatoria: de 1 a 2.000 caracteres. Va en los metadatos de cada pieza.
Borradores	20 activos por cuenta. kurv_archive_draft libera un hueco al momento; el arte del borrador archivado se guarda 30 días y luego se elimina.
Vistas previas	Hasta 9 muestras al azar por llamada, o hasta 9 números de pieza elegidos, de 64 a 512 píxeles.

El agente lee validCombinations después de cada validación: cuántas piezas distintas permiten las capas y las reglas. Se cuenta con exactitud en espacios de hasta unos 50 millones de combinaciones y, por encima, se marca como una estimación. Mantenlo con holgura por encima del tamaño de la colección.

El camino, paso a paso

Los pasos marcados con Aprobación significan que el agente se detiene y espera tu sí explícito.

1. Fotos. Reúne de 3 a 10 fotos nítidas de la mascota o el personaje real: la cara, los ojos, los dientes y la boca, las manchas, las orejas. Elige una foto principal con la cara de tres cuartos.
2. Dirección de arte. Un estilo, una pose (la de tres cuartos funciona mejor), un lienzo cuadrado (se recomienda 2.048 por 2.048) y una hoja de estilo breve: trazo, sombreado, paleta, ambiente. Aprobación: el personaje maestro, antes de hacer ningún atributo.
3. La base maestra. El personaje en su pose final sobre un fondo plano de un solo color, centrado, al tamaño completo del lienzo, reconocible al instante como la mascota real. Cada atributo es una edición de este maestro, con la misma pose, escala y encuadre.
4. Capas. Las capas se pintan de abajo arriba: Background, Skin (la capa base), Collar, Teeth, Eyes, Headwear (opcional). Unas seis capas; el personaje sostiene la colección, no los accesorios. El agente nombra la capa base en base_layer y da a cada capa una caja de anclaje donde tienen que quedar sus atributos.
5. Atributos. Cada atributo es una edición de una copia del maestro, recortada para que solo se vean los píxeles del propio atributo y todo lo demás sea transparente. Generar los atributos sobre una copia del cuerpo en color plano evita que se cuele el pelaje. Un atributo que se desvía en posición o en escala se rechaza.
6. Únicas. Cuerpos transformados por completo (diamante, cromo, lava, bronce), cada uno con un fondo a juego y sin collar. Su arte va en su capa como un atributo con un peso de 0, así que nunca aparece en piezas al azar; cuenta para las 240 imágenes.
7. Reglas. Hojas de contacto de cada piel con cada atributo de collar, dientes, ojos y tocado. Cada pareja mala (que se solapa, que no se ve, que queda fea) se convierte en una regla de exclusión agrupada con una nota que explica por qué.
8. Aprobación: las hojas de capas, al menos 9 muestras compuestas, la hoja de únicas, la configuración y las condiciones de venta, antes de crear el borrador.
9. Configuración y validación. kurv_builder_spec con la red, y luego kurv_validate_collection con la configuración hasta que su lista issues no tenga ningún error. Los avisos nombran lo que deberías saber. La respuesta trae required_assets, las claves exactas que hay que subir, y validCombinations.
10. El borrador. kurv_create_collection con version: 3, la red, la configuración, las condiciones de venta y una clave de idempotencia, primero con check_only en true y luego de verdad. Una llamada fallida se reintenta con la misma clave. Las condiciones de venta tienen una sola forma en todas las redes: consulta Condiciones de venta.
11. El arte. De una en una con kurv_upload_trait (primero el fondo, la base y un atributo por capa, luego una vista previa, luego el resto), o todo a la vez en el formato de carpeta de la web con kurv_upload_collection_zip. Una capa vacía es un noneWeight, nunca un PNG transparente.
12. Comprobación y vista previa. kurv_validate_collection con el borrador hace las comprobaciones del arte. kurv_preview_collection con 9 muestras después de la última subida, más los números de pieza de cada única y las combinaciones con más riesgo. El agente mira cada imagen. Una primera vista previa larga responde con retry_after y las muestras pendientes; el agente vuelve a llamar.
13. Correcciones sin un borrador nuevo. kurv_update_collection cambia sin moverlos las reglas, las únicas, los pesos, las pistas o la descripción; el lienzo no puede cambiar. kurv_replace_trait_image sustituye una imagen, kurv_rename_trait cambia el nombre de un atributo y actualiza sus reglas y sus únicas, kurv_delete_trait elimina un atributo al que nada hace referencia. Después, una vista previa nueva.
14. Aprobación: las muestras finales y cada aviso, leídos para ti.
15. Preparar. kurv_prepare_launch con el borrador. Ante warnings_need_review, el agente explica cada aviso; solo después de que los aceptes vuelve a llamar con acknowledge_warnings en true. Recibes un enlace para el navegador.
16. Tú firmas. Abre el único enlace, comprueba lo que aparece, elige Publicar y lanzar y firma con tu propia cartera en el último paso. Cada respuesta está a un Atrás de distancia. Ninguna herramienta firma por ti.

Reglas

Una regla mantiene separados o juntos los atributos de dos capas: {"type", "when", "target", "note"}, donde type es exclude o require, y when y target nombran cada uno una capa y, si quieres, un atributo: un nombre o una lista de nombres. Sin atributo significa la capa entera, y when y target tienen que ser capas distintas. La clave es trait: una regla escrita con traits se rechaza indicando la clave correcta, en lugar de aplicarse en silencio a toda la capa. None puede representar una capa vacía solo donde esa capa tiene un noneWeight mayor que 0. Agrupa las parejas en listas para no pasar de 48: una regla por grupo de pieles, con la lista de todos los collares que nunca deben llevar.

{"type": "exclude", "note": "Thick fur hides these collars", "when": {"layer": "Skin", "trait": ["Lion Mane", "Fire Fur"]}, "target": {"layer": "Collar", "trait": ["Bow Tie", "Name Tag"]}}

Las reglas llegan a las piezas: el mismo motor genera la vista previa y los archivos publicados, y la acuñación reparte esos archivos. Una única puede saltarse las reglas con ignoreRules en true; la unicidad se mantiene igualmente.

Únicas

Las únicas son specials: un nombre, cada capa con su atributo o None, un número de pieza fijado opcional y una descripción opcional. Una única que deja fuera una capa recibe esa capa al azar, y la validación avisa de qué capas son. null se rechaza, y también un nombre de atributo que no existe.

{"name": "Diamond Grail", "tokenId": 1, "traits": {"Background": "Diamond Vault", "Skin": "Pave Diamond", "Collar": "None", "Teeth": "Diamond Grill", "Eyes": "None"}}

Arte que la gente quiere

• Arte muy trabajado y pulido. Nada de un aspecto plano, turbio o claramente generado.
• Fondos potentes: colores intensos o escenas ricas. Evita temas de lugares (ciudades, playas) salvo que sean intencionados.
• Pose de tres cuartos y un parecido reconocible con la mascota real: manchas, color de ojos, forma de las orejas.
• Atributos llamativos ajustados al cuerpo del personaje, dibujados sobre la forma del maestro. Los dientes encajan exactamente en la boca.
• Nada de tocados flotando. Los sombreros se apoyan en la cabeza con una sombra de contacto; las orejas grandes pasan por encima del ala.
• La ropa suele quedar mal en los animales. Mejor collares, cadenas y prendas para el cuello, y compruébalos en cada piel.
• Las únicas premium están transformadas por completo, con fondos a juego y sin collar.

El conector comprueba el arte a medida que llega. Los errores rechazan una subida: un tamaño de lienzo distinto, una capa por encima del fondo que no es un PNG con transparencia, una imagen sin ningún píxel visible. Los avisos vuelven para que los revises: un atributo fuera de su anclaje, un atributo a otra escala que su capa, un atributo fuera de la cuadrícula de píxeles de la base, un atributo que todavía lleva la imagen base entera o en parte, un atributo que cubre todo el lienzo. Un aviso puede ser falso: unos ojos naturales en la misma capa que unas gafas de sol tienen otro tamaño a propósito. El agente pone mixedScales en esa capa, o acknowledge en el atributo una vez que estás de acuerdo, y el arte se queda como debe estar.

Lo que el agente recibe de vuelta

Cada herramienta de validación responde a todos los problemas a la vez en una sola lista issues, cada uno con una ruta, un código, una gravedad, un mensaje y una solución. Una clave desconocida se rechaza por su nombre, junto con la válida más parecida. La red se nombra (base-sepolia, solana-devnet, solana-localnet), y un borrador sin red usa Base Sepolia y lo dice. Los métodos de venta usan los nombres de la web (fixed, mystery, rising, falling, auction): a través del conector, Base ofrece fixed, mystery y rising, Solana ofrece fixed y rising, y las ventas falling y auction se configuran en la web. Un campo de venta que la red no tiene, como un símbolo en Solana, se rechaza por su nombre. Una comprobación automática demuestra los metadatos: cada pieza respeta las reglas, una única cae en la pieza a la que está fijada y una capa vacía se escribe como {"trait_type": "<layer>", "value": "None"}.

Piezas terminadas

Las piezas que ya existen como imágenes terminadas se saltan las capas: kurv_finished_art_limits, luego kurv_upload_finished_file_part para cada imagen y el metadata.json, y luego kurv_import_finished_collection. Los bytes se guardan tal como llegan, animación incluida, y los límites por capas no se aplican; los límites de publicación actuales de la web, sí. Arte terminado explica los archivos.

Límites conocidos de esta versión

• Los valores de una venta de Solana en versión 2 los comprueba el propio analizador de la app después de las claves, de uno en uno; una venta en versión 3 responde a todos los problemas a la vez.
• Un borrador de arte terminado no se puede editar sin más; una corrección es una subida nueva y una clave nueva.
• Un borrador archivado no se puede restaurar a través del conector; su arte se guarda 30 días.
• Robinhood Chain no está disponible a través del conector: no hay configuración de red ni esquema de venta. Llega después de los lanzamientos de Base y Solana.

Las cifras de las colecciones son instantáneas y un lanzamiento mueve valor real en su red; lee Riesgos y aviso legal antes de aconsejar a nadie sobre dinero.