API & MCP

Connect your agents to Venari.

Venari is a Model Context Protocol (MCP) server. Any MCP-capable agent — Claude, Codex, Cursor, Hermes — can generate images, videos, and creator ads, billed to your Venari plan.

1 · Get a key

Open Developer in the app and create an API key. You'll see the full vnri_… key once — copy it.

2 · Add the server

Endpoint (Streamable HTTP, JSON-RPC 2.0):

https://www.venaristudio.com/api/mcp

Authenticate with your key as a Bearer token. Example client config:

{
  "mcpServers": {
    "venari": {
      "url": "https://www.venaristudio.com/api/mcp",
      "headers": { "Authorization": "Bearer vnri_..." }
    }
  }
}

3 · Tools

list_styles

List valid contentType + looks. Call first so you pass valid values.

params: —

generate_image

Generate a marketing image from a source photo. Returns a generationId; poll check_status until "ready". Consumes 1 image credit.

params: inputImageUrl (required), prompt, aspectRatio, contentType, look

generate_video

Generate a short video from a source photo. Paid plans only. Consumes 1 video credit.

params: inputImageUrl (required), prompt, aspectRatio, contentType, look

create_creator_ad

Lifelike presenter talks about your product (UGC ad). Paid plans only. Consumes 1 video credit.

params: productImageUrl (required), productTitle, preset, script, avatarHint, aspectRatio, brandHint

check_status

Advance and read a job by id. Returns status + output URL when finished.

params: generationId (required)

list_generations

List the account's recent generations.

params: limit (1–50, default 20)

Typical flow

  1. list_styles → pick a contentType + look
  2. generate_image with a source photo URL → returns a generationId
  3. poll check_status until status is ready → use the output URL

Billing & limits

Each call meters the key owner's plan credits — the same wallet as the web app. Video and creator ads require a paid plan. Failed jobs are automatically refunded. Keys can be revoked anytime from the Developer page.

Create your API keyBack to home