KURV for Developers

Build on KURV.

Bring collections to your site. Connect your agent. Create your own mint experience.

Bring your agent Developer docs

Your agent, your account.

Choose your agent client

MCP server URL

Remote HTTP MCP with OAuth.

Read and integrate

Public data. Your interface.

Read collection settings, mint counts and Vault figures. Public reads need no account or API key.

Collection catalogGET /api/v1/collections?limit=20

Collection detailsGET /api/v1/collections/84532/{address}

Collection contract ABIGET /api/v1/contracts/kurvdrop

Mint inside your own site.

Connect the visitor's wallet, get a fresh quote, approve the coin the mint costs and confirm the transaction receipt.

API capabilities Contract ABI

Direct mint integration

Amounts use decimal strings. API responses include reading timestamps.

Show it anywhere

Your collection, on your site.

This live example is Woof Pack. The widget fits desktop and mobile. Mint opens KURV in a new tab for wallet approval.

Live collection preview

Embed code

<iframe
  src="https://testnet.kurv.fun/embed/84532/0x8354d02d8022f455db9acb235c6f6655c8adabd3"
  title="Woof Pack on KURV"
  width="100%" height="420" loading="lazy"
  style="max-width:660px;border:0;border-radius:18px"
  sandbox="allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox"
></iframe>

Replace the contract address with your collection.

Read this collection Embed guide

MCP reference.

Eleven tools, a builder guide and a collection prompt. No model training required.

Tools, limits and account permissions

kurv_account
Check your connected wallet, permissions and invitation.
kurv_builder_spec
Get the generative layers schema and limits.
kurv_validate_collection
Check collection settings and trait requirements.
kurv_create_collection
Store your collection draft with a stable retry key.
kurv_list_drafts
Find drafts owned by your connected account.
kurv_upload_trait
Upload a real PNG, JPEG or WebP trait image.
kurv_preview_collection
Inspect trait recipes, rarity and required art.
kurv_prepare_launch
Get the creator review and wallet approval link.
kurv_list_collections
Read the public collection catalog.
kurv_get_collection
Read a collection, chain figures and contract links.
kurv_embed_code
Get a collection widget and integration links.

Up to 1,000 pieces, 12 layers and 120 traits. Still PNG, JPEG or WebP traits must match the canvas and stay within 2 MiB each. Fixed price, mystery and rising price sales are supported. Auctions and animated art are outside this connector version.

The KURV account flow creates or connects your wallet. Creating collections, uploading traits and preparing launches require an invitation. Access lasts one hour; the connection grant expires seven days after its initial authorization-code exchange.

Reuse the same idempotency key when retrying a draft request. Approve only the permissions you need, and revoke access when finished, from your MCP client or from My pieces under Connected agents.

Full MCP documentation