# avocado-ai

Generate AI images, videos, UGC ads, and product photos directly from Claude, Cursor, or any MCP client.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add wander8jackson/avocado-ai

# Browse available tools
npx -y @smithery/cli@latest tool list wander8jackson/avocado-ai

# Get full schema for a tool
npx -y @smithery/cli@latest tool get wander8jackson/avocado-ai models.list

# Call a tool
npx -y @smithery/cli@latest tool call wander8jackson/avocado-ai models.list '{}'
```

## Direct MCP Connection

Endpoint: `https://avocado-ai--wander8jackson.run.tools`

**Optional config:**
- `apiKey` (query) — Your Avocado AI API key. Get one at https://www.avocadoai.co/api-keys

## Tools (6)

- `models.list` — List all available AI image generation models on Avocado AI. Returns model names, IDs, credit costs, and descriptions. …
- `account.check_credits` — Check your Avocado AI credit balance. Returns available credits, membership tier, and what you can generate with your c…
- `generate.image` — Generate an AI image using Avocado AI. Supports 19+ models including Flux Pro, Imagen 4, Ideogram V3, Recraft V4, SeedD…
- `generate.video` — Generate an AI video using Avocado AI's Seedance 2.0 model by ByteDance. Creates high-quality AI videos from text promp…
- `generate.music` — Generate AI music using Avocado AI powered by ElevenLabs. Create original music tracks from text prompts describing gen…
- `generate.speech` — Convert text to natural-sounding speech using Avocado AI powered by ElevenLabs. Supports multiple voices and languages.…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get wander8jackson/avocado-ai <tool-name>
```

## Prompts (3)

- `generate-social-post` (platform, topic) — Generate an eye-catching image for a social media post
- `generate-product-photo` (product, style) — Generate a professional product photo for e-commerce or marketing
- `create-video-ad` (product, duration) — Create a short AI video ad for a product or service