KURV para desenvolvedores

Leve as coleções do KURV para os seus próprios apps, 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 blockchain, o widget mostra uma coleção onde quer que você o incorpore, e o MCP permite que um agente autorizado prepare uma coleção generativa para o criador dela.

Escolha a sua integração

Você quer	Comece aqui
Conectar um agente e preparar coleções	Conecte um agente com MCP
Ler coleções, contagens de cunhagem e informações de contrato	APIs públicas
Ler os números do KURV com uma chave de API: lançamentos, cunhagens, volume, taxas, cadastros	API de dados do KURV
Colocar a arte de uma coleção e um botão de cunhagem em outro site	Coleções incorporadas
Colocar um botão de cunhar próprio em qualquer página, na Base ou na Solana	Cunhe pela sua página
Criar uma experiência de cunhagem com o seu próprio conector de carteira	Cunhe pelo seu site

Endpoints e rede

Base Sepolia (chain ID 84532) é o padrão. Rascunhos com version: 2 e network explícitos também aceitam implantações verificadas na Solana Devnet e em localnet. Leia kurv_builder_spec da rede escolhida 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 desenvolvedores

mcp.kurv.fun é o endpoint do serviço para máquinas. Esta documentação é onde ficam as instruções de conexão, o guia das ferramentas e os exemplos de integração. As leituras pela API e por iframe 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 específica do KURV.

Criar com um agente

1. Adicione https://mcp.kurv.fun/mcp em um cliente MCP remoto que aceite OAuth.
2. Entre no KURV e aprove as permissões que o cliente pede. É preciso ter um convite para gravar coleções e preparar lançamentos.
3. Peça ao agente que confira o esquema do builder, valide a coleção e crie um rascunho seu com uma chave de nova tentativa estável.
4. Envie a arte real dos atributos, já alinhada: no máximo 240 imagens de origem, incluindo a arte só de peças únicas, 20 MiB por imagem de origem em ZIP, ou 2 MiB por envio individual inline. A geração por camadas aceita 1.000 peças, incluindo as únicas. A arte final usa kurv_finished_art_limits para os limites atuais da web e do provedor.
5. Abra review_url como dono, confira a arte exata e as condições de venda e, depois, escolha explicitamente Publicar e lançar antes de qualquer envio público. Aprove a assinatura da carteira para esse retrato publicado e imutável. Abrir um link nunca publica nem assina; edições posteriores no rascunho exigem uma nova revisão. studio_url só abre o editor.

O conector tem 21 ferramentas, o recurso kurv://builder-guide e o prompt build-kurv-collection. Um cliente com cache que mostra 11 ferramentas precisa se reconectar ou atualizar a descoberta. O agente prepara os rascunhos; o dono aprova a publicação e a assinatura da carteira. Um link de kurv_prepare_launch não é uma implantação confirmada.

Veja Conecte um agente com MCP para as permissões, as entradas exatas das ferramentas, o comportamento nas novas tentativas e os métodos de arte e de venda aceitos.

Mostrar e cunhar em outro lugar

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

Para cunhar direto 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 nova, aprove a moeda da coleção exigida e qualquer moeda adicional, simule a cunhagem e espere o recibo da transação. Cunhe pelo seu site mostra a chamada exata e como ela lida com as fases públicas, os tetos de custo e os módulos de leilão.

Os números da coleção trazem o horário da leitura. Um número desatualizado é um retrato confirmado anteriormente. Os metadados privados e as raízes de arte de uma coleção não revelada continuam retidos. As regras do contrato, as taxas e as condições da coleção valem para toda integração; leia Taxas e Riscos e isenção de responsabilidade.