KURV para programadores

Leve as coleções do KURV para as suas próprias aplicações, sites e fluxos de agentes. Os contratos públicos guardam o estado das coleções. A API HTTP expõe a configuração das coleções e as leituras da cadeia, o widget mostra uma coleção onde quer que seja incorporado, e o MCP permite que um agente autorizado prepare uma coleção generativa para o seu criador.

Escolher a integração

Pretende	Comece aqui
Ligar um agente e preparar coleções	Ligar um agente com MCP
Ler coleções, contagens de cunhagens e informação dos contratos	APIs públicas
Ler os números do KURV com uma chave de API: lançamentos, cunhagens, volume, comissões, registos	API de dados do KURV
Pôr a arte de uma coleção e um botão Cunhar noutro site	Coleções incorporadas
Colocar um botão de cunhar próprio em qualquer página, na Base ou na Solana	Cunhar a partir da sua página
Criar uma experiência de cunhagem com o seu próprio conector de carteira	Cunhar a partir do seu site

Endpoints e rede

Base Sepolia (chain ID 84532) é a predefinição. Os rascunhos com version: 2 e network explícitos também suportam implementações verificadas em Solana Devnet e localnet. Leia kurv_builder_spec para a rede selecionada antes de preparar um rascunho. O conector nunca guarda a chave privada do criador.

Ponto de entrada	Endereço
Endpoint MCP remoto	https://mcp.kurv.fun/mcp
Descoberta da API pública	https://testnet.kurv.fun/api/v1
Catálogo de coleções	https://testnet.kurv.fun/api/v1/collections
ABI do KurvDrop	https://testnet.kurv.fun/api/v1/contracts/kurvdrop
Ambiente de integração	KURV para programadores

mcp.kurv.fun é o endpoint do serviço para máquinas. É nesta documentação que estão as instruções de ligação, o guia das ferramentas e os exemplos de integração. As leituras da API e dos iframes são públicas e não precisam de conta nem de chave de API. O conector de agentes usa OAuth para autorizar uma conta KURV específica.

Criar com um agente

1. Adicione https://mcp.kurv.fun/mcp num cliente MCP remoto que suporte OAuth.
2. Inicie sessão no KURV e aprove as permissões pedidas pelo cliente. É necessário um convite já existente para escrever coleções e preparar lançamentos.
3. Peça ao agente que verifique o esquema do construtor, valide a coleção e crie um rascunho próprio com uma chave de repetição estável.
4. Carregue a arte real dos atributos, alinhada: no máximo 240 imagens de origem, incluindo a arte só de peças únicas, 20 MiB por imagem de origem num ZIP, ou 2 MiB por cada carregamento individual em linha. A geração por camadas suporta 1000 peças, incluindo as únicas. A arte acabada usa kurv_finished_art_limits para os limites atuais da web e do fornecedor.
5. Abra review_url como proprietário, verifique a arte exata e as condições de venda, e escolha explicitamente Publicar e lançar antes de qualquer carregamento público. Aprove a assinatura da carteira para esse instantâneo publicado e imutável. Abrir uma ligação nunca publica nem assina; edições posteriores ao rascunho exigem uma nova revisão. studio_url abre apenas o editor.

O conector tem 21 ferramentas, o recurso kurv://builder-guide e o prompt build-kurv-collection. Um cliente em cache que mostre 11 ferramentas precisa de voltar a ligar-se ou de atualizar a descoberta. O agente prepara rascunhos; o proprietário aprova a publicação e a assinatura da carteira. Uma ligação de kurv_prepare_launch não é uma implementação confirmada.

Consulte Ligar um agente com MCP para as permissões, os parâmetros exatos das ferramentas, o comportamento das repetições e os métodos de arte e de venda suportados.

Mostrar e cunhar noutro lado

O widget da coleção mostra a arte real ou a sua pré-visualização pública e atualiza as contagens de cunhagens confirmadas. O seu botão Cunhar abre uma janela do KURV para a conta do comprador e a aprovação na carteira. Esta passagem funciona sem depender de cookies de conta dentro de um iframe. O botão Cunhar faz o mesmo a partir de qualquer página e avisa essa página quando uma cunhagem termina.

Para cunhar diretamente no seu próprio site, use o endereço do contrato da coleção e a ABI pública com o seu próprio conector de carteira. Leia uma cotação atualizada, aprove a moeda da coleção necessária e qualquer moeda adicional, simule a cunhagem e aguarde o recibo da transação. Cunhar a partir do seu site mostra a chamada exata e como lida com fases públicas, limites de custo e módulos de leilão.

Os números das coleções têm um carimbo de data e hora da leitura. Um número desatualizado é um instantâneo confirmado anteriormente. Os metadados privados e as raízes da arte de uma coleção por revelar continuam retidos. As regras do contrato, as comissões e as condições da coleção aplicam-se a todas as integrações; leia Comissões e Riscos e aviso legal.