{"openapi":"3.1.0","info":{"title":"Avocado AI agent surface (MCP server and CLI)","version":"1.0.0","summary":"HTTP endpoints behind the Avocado MCP server and CLI: MCP, OAuth discovery, API keys and generation. Not a public developer API.","description":"Avocado AI is an AI creative workspace for ecommerce and DTC brands. One creative system, three ways to work: Studio (you make it), Flows (you repeat it) and Super Agent (Avo does it for you). Brand DNA carries your products, references, visual direction, tone and rules into every result.\n\nThis is not a developer API product. Avocado AI does not sell a public REST API. The HTTP endpoints in this document exist to serve the Avocado MCP server and the Avocado CLI. To use Avocado from an agent, connect the MCP server at https://www.avocadoai.co/mcp or install the CLI (npm package @avocado-ai-co/cli). The generation routes are listed for transparency and have no stable request schema.\n\n## What Avocado AI includes\n\n- Studio: an image workbench (generate, or edit your own product photo, up to 4 variations per run, upscale), a video workbench (text to video, animate a still, start and end frames, reference and motion-control modes), a UGC studio (creator looks, script to talking video, the product in the creator's hand, up to 30s) and an Audio Studio (text to speech, voice design, voice cloning, music, sound effects). One credit balance, one library.\n- Flows: an infinite canvas that chains prompt, LLM, image, video, music and voice nodes and runs them in one click, with Director mode for cutting a commercial. On every paid plan.\n- Super Agent 2.0: an AI marketing teammate that creates on-brand images, videos, music and captions, with Memory, Projects, Skills and a content calendar. After your approval it publishes and schedules posts to Instagram, Facebook, TikTok, LinkedIn, Threads and X (X includes 50 posts per month). It also runs Meta Ads: campaigns are always created paused and every launch needs your approval. Talk to it in the web app, Slack or Telegram. Super Agent is on Growth and Pro; publishing and Meta Ads also need the Connectors add-on (called Operator in the app).\n- Avocado MCP server: 60+ tools for Claude, Codex, Cursor or your own agent, covering image, video, UGC, speech, music, sound effects, Flows, Brand DNA, publishing, content calendar and Meta Ads.\n- Avocado CLI: generate images and videos, list models, track jobs, and install the MCP server into Claude Code or Cursor.\n\n## Current models (examples)\n\n- Image: GPT Image 2.5 Flare (default), GPT Image 2.5 Sunburst, GPT Image 2, Nano Banana 2, Seedream 5.0 Pro, Krea v2, Krea v3, Recraft v4.1, Luma Uni-1 Max, Grok Imagine.\n- Video: Seedance 2.5 and Seedance 2.0 (including Faces variants that accept real human faces), Kling 3.0 and Kling o3 4K, MiniMax H3, H3 MAX and H3 MAX Turbo, Google Veo 3.1, Gemini Omni Flash, Grok Imagine Video.\n- Audio: Fish Audio S2 Pro (default voice), ElevenLabs, Seed Audio, MiniMax Music 3, ElevenLabs Music, sound effects.\n\n## Plans (EUR per month, yearly billing is 20% off)\n\n- Intro: EUR 19.99, 100 credits\n- Starter: EUR 39, 300 credits\n- Growth: EUR 99, 800 credits, adds Super Agent\n- Pro: EUR 249, 2,000 credits\n\nEvery plan includes commercial rights and no watermarks, and credits roll over for up to one year. Details: https://www.avocadoai.co/pricing\n\n## Links\n\n- Pricing: https://www.avocadoai.co/pricing\n- Knowledge base: https://www.avocadoai.co/knowledge-base\n- MCP server: https://www.avocadoai.co/mcp\n- Agent index: https://www.avocadoai.co/llms.txt\n- Sitemap: https://www.avocadoai.co/sitemap.xml\n\n## Authentication\n\n- /api/mcp: Authorization: Bearer with an OAuth 2.1 access token (PKCE S256, dynamic client registration; discover the authorization server via /.well-known/oauth-protected-resource, metadata mirrored at /.well-known/oauth-authorization-server and /.well-known/openid-configuration) or an Avocado API key (avk_). Unauthenticated calls get 401 with WWW-Authenticate so MCP clients can start OAuth.\n- /api/mcp/public, /api/mcp/resources, /.well-known/*: no auth.\n- /api/mcp/keys: signed-in browser session. Keys are shown once.\n- Generation routes: avk_ API key or signed-in browser session.\n\n## Technical notes\n\n- /api/v1/<route> is a path alias that rewrites to /api/<route>. Responses carry API-Version: 1 and RateLimit headers; 429 responses carry Retry-After.\n- These routes change together with the MCP server and CLI. There is no separate versioning program and no Deprecation or Sunset schedule.","contact":{"url":"https://www.avocadoai.co"}},"servers":[{"url":"https://www.avocadoai.co","description":"Site root. Paths without their own servers entry resolve here."},{"url":"https://www.avocadoai.co/api/v1","description":"Path alias used by the /generate-* paths"}],"tags":[{"name":"Discovery","description":"Machine-readable indexes of the site"},{"name":"MCP","description":"Avocado MCP server (Streamable HTTP, JSON-RPC)"},{"name":"Auth","description":"OAuth discovery and Avocado API keys (avk_) for the MCP server and CLI"},{"name":"Generation","description":"Routes the web app, MCP server and CLI use to start generations. Not a stable public API; prefer the MCP tools."}],"paths":{}}