# Konv for AI agents

> Konv is a Brazilian AI platform that generates UGC-style videos, product images, and high-conversion sales pages for e-commerce. This page tells AI agents how to read Konv content efficiently and how to act on a Konv account.

## Reading Konv content

- Site directory (Markdown): https://konvlabs.com/llms.txt
- Full content in one file (Markdown): https://konvlabs.com/llms-full.txt
- Markdown of a page: append `/index.md` to a path, or send `Accept: text/markdown`. Example: https://konvlabs.com/index.md
- Sitemap: https://konvlabs.com/sitemap.xml

Facts such as pricing live in plain server-rendered HTML (all marketing routes are prerendered). You do not need to execute JavaScript to read them.

## Acting on a Konv account (MCP)

Konv exposes a Model Context Protocol (MCP) server. Agents that can call MCP tools can manage products and generate videos on behalf of an authenticated user.

- MCP endpoint: `https://api.konvlabs.com/functions/v1/mcp-server` (JSON-RPC 2.0 over HTTP POST)
- Server Card: https://konvlabs.com/.well-known/mcp/server-card.json
- OpenAPI: https://konvlabs.com/openapi.yaml
- API Catalog (RFC 9727): https://konvlabs.com/.well-known/api-catalog

### Authentication

Two supported schemes:

1. OAuth 2.0 Authorization Code + PKCE (S256) — for connectors like Claude.ai. Discover endpoints at `https://api.konvlabs.com/functions/v1/mcp-server/.well-known/oauth-authorization-server`.
2. Bearer API key — issue a key in the Konv dashboard (format `sk_konverte_...`) and send it as `Authorization: Bearer <key>`. Best for Claude Code, Cursor, and scripts.

### Tools

- `check_credits` — current credit balance and plan.
- `list_products` — imported products available for video generation.
- `list_videos` — generated videos with status and URLs.
- `get_video` — details and status of one video by `creative_id`.
- `generate_video` — generate a UGC-style video for a product. Returns a `creative_id`; poll `get_video`. Generation takes 3 to 8 minutes.

Input schemas for every tool are in the Server Card.

## Agentic commerce (preview)

Konv plans to let purchasing agents buy credits and generation on a per-call or per-session basis without a human in the loop, via emerging standards:

- x402 (HTTP 402 Payment Required) for metered, per-call generation.
- Universal Commerce Protocol (UCP) for agent checkout of plans and credit packs.

These are not live yet. Agents that want machine-to-machine billing should contact team@konvlabs.com. When live, payment-required responses and the UCP descriptor will be advertised from this file and the API Catalog.

## Contact

- Email: team@konvlabs.com
- Website: https://konvlabs.com