# KURV for agents

KURV is an NFT launchpad. Read this before calling tools.

MCP URL: https://mcp.kurv.fun/mcp
Chain: Base Sepolia
Chain ID: 84532

## Account access

The connection uses browser OAuth. The agent opens KURV so the person can log in and approve access in the browser. Never ask for a seed phrase or a private key.

Access tokens expire after one hour. A grant lasts up to seven days. The person can revoke it from My pieces on KURV.

Creator tools need an invitation on the account. If the account has no invitation, creator authorization is refused with this message:

This account has no KURV invitation, so the connection was refused. Ask for an invitation, then connect again from your agent.

If the connection has no active authorization, or authorization fails before a token is issued, the server answers:

This connection is not logged in. Start the KURV login from your agent and approve access in the browser. If that login fails, start it again from your agent.

A read-only grant (kurv:read) can connect without an invitation. Creating a draft, uploading art and preparing a launch need an invitation. Those calls answer:

This account has no KURV invitation. Creating or launching a collection stays closed until an invitation is on the account.

An account with authorized agent access and no invitation reports:

This account is connected and has no KURV invitation. Reads are available. Creating or launching a collection needs an invitation.

## Tools

- kurv_account: Wallet, scopes, invitation status and chain. Call this first.
- kurv_builder_spec: Schema and limits for a collection.
- kurv_validate_collection: Check a layers config. Stores nothing.
- kurv_create_collection: Store a draft. Needs an invitation.
- kurv_list_drafts: List drafts that belong to this account.
- kurv_upload_trait: Upload one PNG, JPEG or WebP trait. Needs an invitation.
- kurv_preview_collection: Recipes, rarity and missing art.
- kurv_prepare_launch: A review link for the person to approve. Sends no transaction. Needs an invitation.
- kurv_list_collections: Public collections.
- kurv_get_collection: One public collection.
- kurv_embed_code: An iframe for a launched collection.

## Builder guide

https://mcp.kurv.fun/guide

kurv_builder_spec returns the same limits. The resource kurv://builder-guide returns the full workflow.
People can also read https://docs.kurv.fun/developers/mcp/ and connect a client at https://testnet.kurv.fun/agents.

## A working check

Call kurv_account and kurv_builder_spec. Success reports the wallet, whether the account is invited, Base Sepolia, chain 84532, and a short builder guide. Do not create a draft, upload art, prepare a launch or send a transaction.