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 исходных изображений, включая арт только для уникальных NFT, 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 инструментов, его нужно переподключить или обновить обнаружение. Агент готовит черновики; публикацию и подпись кошелька одобряет владелец. Ссылка из kurv_prepare_launch не означает подтверждённое развёртывание.

Разрешения, точные входные данные инструментов, поведение при повторах и поддерживаемые виды арта и способы продажи описаны на странице Подключите агента через MCP.

Показ и минт в другом месте

Виджет коллекции показывает настоящий арт или его публичный тизер и обновляет подтверждённые счётчики минтов. Его кнопка минта открывает окно KURV, где покупатель входит в аккаунт и одобряет действие в кошельке. Такая передача работает без опоры на куки аккаунта внутри iframe. Кнопка минта делает то же самое с любой страницы и сообщает ей, когда минт завершён.

Для минта прямо на своём сайте используйте адрес контракта коллекции и публичный ABI со своим коннектором кошелька. Получите свежую котировку, одобрите нужную монету коллекции и любую дополнительную монету, смоделируйте минт и дождитесь квитанции транзакции. На странице Минт с вашего сайта показан точный вызов и то, как он работает с публичными фазами, потолками стоимости и модулями аукционов.

У цифр коллекции есть отметка времени чтения. Устаревшая цифра это ранее подтверждённый снимок. Приватные метаданные и корни арта нераскрытой коллекции по-прежнему скрыты. Правила контракта, комиссии и условия коллекции применяются к любой интеграции; прочитайте Комиссии и Риски и отказ от ответственности.