KURV для розробників

Додавайте колекції KURV у власні застосунки, сайти й робочі процеси агентів. Стан колекцій зберігають публічні контракти. HTTP API надає конфігурацію колекцій і дані з мережі, віджет показує колекцію там, де ви його вбудуєте, а MCP дає змогу авторизованому агенту підготувати генеративну колекцію для її автора.

Оберіть інтеграцію

Що ви хочете	З чого почати
Підключити агента й готувати колекції	Підключіть агента через MCP
Читати колекції, кількість мінтів і дані контрактів	Публічні API
Читати показники KURV за API-ключем: запуски, мінти, обсяг, комісії, реєстрації	API даних KURV
Показати арт колекції й кнопку мінту на іншому сайті	Вбудовування колекцій
Розмістити власну кнопку мінту на будь-якій сторінці, на Base або Solana	Мінт із вашої сторінки
Створити мінт із власним конектором гаманця	Мінт із вашого сайту

Ендпоінти й мережа

Типова мережа Base Sepolia (chain ID 84532). Чернетки з явними version: 2 і network також підтримують перевірені розгортання в Solana Devnet і localnet. Перш ніж готувати чернетку, прочитайте kurv_builder_spec для обраної мережі. Конектор ніколи не тримає приватний ключ автора.

Точка входу	Адреса
Віддалений MCP-ендпоінт	https://mcp.kurv.fun/mcp
Опис публічного API	https://testnet.kurv.fun/api/v1
Каталог колекцій	https://testnet.kurv.fun/api/v1/collections
ABI KurvDrop	https://testnet.kurv.fun/api/v1/contracts/kurvdrop
Пісочниця для інтеграцій	KURV для розробників

mcp.kurv.fun це ендпоінт сервісу для машин. Інструкції з підключення, посібник з інструментів і приклади інтеграцій містить ця документація. Читання через API та iframe публічні й не потребують ні акаунта, ні API-ключа. Конектор для агентів використовує OAuth, щоб авторизувати конкретний акаунт KURV.

Створення з агентом

1. Додайте https://mcp.kurv.fun/mcp у віддалений MCP-клієнт, який підтримує OAuth.
2. Увійдіть у KURV і схваліть дозволи, які запитує клієнт. Для запису колекцій і підготовки запуску потрібне чинне запрошення.
3. Попросіть агента перевірити схему білдера, перевірити колекцію і створити власну чернетку зі стабільним ключем повтору.
4. Завантажте справжній арт атрибутів, вирівняний між собою: не більше 240 вихідних зображень разом з унікальним артом, 20 MiB на вихідне зображення в ZIP або 2 MiB на окреме вбудоване завантаження. Генерація з шарів підтримує 1 000 NFT разом з унікальними. Для готового арту поточні обмеження вебу й провайдерів дає kurv_finished_art_limits.
5. Відкрийте review_url як власник, перевірте точний арт і умови продажу, а потім явно оберіть Опублікувати й запустити, перш ніж щось буде публічно завантажено. Схваліть підпис гаманця для цього незмінного опублікованого знімка. Відкриття посилання ніколи нічого не публікує й не підписує; пізніші зміни чернетки потребують нової перевірки. studio_url лише відкриває редактор.

Конектор має 21 інструмент, ресурс kurv://builder-guide і промпт build-kurv-collection. Клієнт із кешем, що показує 11 інструментів, треба перепідключити або оновити його discovery. Агент готує чернетки; публікацію й підпис гаманцем схвалює власник. Посилання від kurv_prepare_launch не є підтвердженим розгортанням.

Про дозволи, точні вхідні дані інструментів, поведінку повторів і підтримувані способи арту й продажу читайте на сторінці Підключіть агента через MCP.

Показ і мінт деінде

Віджет колекції показує справжній арт або його публічний тизер і оновлює підтверджену кількість мінтів. Його кнопка мінту відкриває вікно KURV, де покупець використовує свій акаунт і схвалює дію в гаманці. Така передача працює без покладання на кукі акаунта всередині iframe. Кнопка мінту робить те саме з будь-якої сторінки й повідомляє їй, коли мінт завершено.

Щоб мінтити просто на своєму сайті, використовуйте адресу контракту колекції та публічний ABI з власним конектором гаманця. Отримайте свіжу ціну, схваліть потрібну монету колекції та будь-яку додаткову монету, симулюйте мінт і дочекайтеся квитанції транзакції. На сторінці Мінт із вашого сайту показано точний виклик і як він працює з публічними фазами, стелею вартості та модулями аукціонів.

Показники колекцій мають позначку часу зчитування. Застарілий показник це раніше підтверджений знімок. Приватні метадані й корені арту нерозкритої колекції лишаються прихованими. Правила контракту, комісії та умови колекції стосуються кожної інтеграції; прочитайте Комісії і Ризики та застереження.