# Veo — how to use (mcp.ai)

Connect your Veo account and use 5 tools for artificial intelligence straight from your AI agent. Connect with your own API key. Veo 3 is Google's state-of-the-art model for generating high-fidelity 8s 720p videos with natively generated audio via the Gemini API.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_veo?ms=1787295840000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `veo_download_video`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/veo`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/veo/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/veo/download/video` — Download video (veo)
  - body: { video_uri: string, download_path: string }
- `POST https://api.mcp.ai/api/veo/generate/videos` — Generate videos (veo)
  - body: { model?: string, extras?: object, prompt: string, aspect_ratio?: string, negative_prompt?: string, person_generation?: string }
- `POST https://api.mcp.ai/api/veo/get/videos/operation` — Get videos operation (veo)
  - body: { operation_name: string }
- `POST https://api.mcp.ai/api/veo/list/models` — List models (gemini api)
  - body: { filter_prefix?: string }
- `POST https://api.mcp.ai/api/veo/wait/for/video` — Wait for video (veo)
  - body: { timeout_s?: integer, operation_name: string, poll_interval_s?: integer }

## Example prompts
- "What can I do in Veo?"
- "Show me a summary of my Veo account"

## More
- Page: https://mcp.ai/veo
- Agent spec (llms.txt): https://mcp.ai/veo/llms.txt
- Postman collection: https://mcp.ai/veo/postman.json