VIRALAI MCP · CLI

Generate viral videos from any agent.

Plug ViralAI's Seedance 2.0 video + Seedream 5.0 image engines into Claude, ChatGPT, Cursor, or your own pipeline. Same credits, same account — new superpowers.

Get your key See the setup

GET CONNECTED

One card. Any client. Ninety seconds.

Your connector link

Paste it into Claude → Settings → Connectors → Add. That's the whole setup.

Your key is already in the link — it spends your own credits. Keep it private; treat it like a password.

Using Claude Code, Codex, or Hermes? The CLI is the fastest path.

REAL TOOLS, REAL OUTPUTS

The entire toolkit.

generate_video

Text to finished ad, inside your agent.

One tool call turns a sentence into a broadcast-ready vertical clip — rendered on Seedance 2.0, returned as a CDN URL your agent can post anywhere.

Try it in Claude

1generate_video

Generate a 15-second vertical ad: perfume bottle on wet black marble, slow dolly-in, golden hour.

sd2_pro9:1615ssound

DownloadGet URLRegenerate

agents poll get_generation → status: completed · video_url

generate_image

Stills that sell, on tap.

Product heroes, thumbnails, key art — Seedream 5.0 Pro and GPT-Image-2 render campaign-grade stills straight into the same conversation.

Try it in ChatGPT

2generate_image

Product hero shot: chrome sneaker floating over teal studio sweep, hard rim light.

seedream_5_0_pro2K

DownloadGet URLRegenerate

returns immediately → image_url · lands in your gallery

viralai CLI

Or skip the agent entirely.

One line to install, one command to generate. Same key, same credits — perfect for scripts, cron jobs, and CI runners.

curl -fsSL https://viralai.in/cli.sh | sh

viralai — zsh

$viralai generate "a cat surfing at sunset" --wait

⠿ processing… (2m 14s)

✓ completed

https://cdn.viralai.in/videos/8f3a2c….mp4

$ viralai credits

Credits: 1924

WHAT SHIPS TODAY

Five tools. The whole pipeline.

generate_video

Text prompt → a Seedance 2.0 video job. Returns a generation you poll.

generate_image

Text prompt → an image via Seedream 5.0, GPT-Image-2, or Nano Banana 2.

get_generation

Check any generation by id. Returns the CDN URL once it's completed.

list_models

List the available video + image models and their credit costs.

get_credits

Show your account email and remaining credit balance.

ENGINES ON TAP

The latest models, one connection.

Seedance 2.0 Pro

video · up to 4K

Seedance 2.0 Fast

video · 720p

Seedance 2.0 Mini

video · budget

Seedream 5.0 Pro

image · 2K

Seedream 5.0

image · fast

Seedream 4.5

image

GPT-Image-2

image · realism

Nano Banana 2

image · reference

PRICING

Same credits as the website.

Video starts from 25 credits, images from 2 credits — see the pricing page for the full breakdown. Every generation you make through the MCP server or the CLI lands in your gallery too.

QUESTIONS

Good to know.

How do I get a key?

It's self-serve. Head to Profile → API keys, hit New key, and point your agent at it. The key is shown once, so keep it somewhere safe.

Which agents can I use?

Claude, Claude Code, ChatGPT (via connectors), Cursor, Hermes, or any MCP-compatible client. Prefer scripts? The one-line bash CLI does the same job from your terminal — same account, same key.

Is it free?

It runs on your existing ViralAI credit balance — exactly the same credits as the website. New accounts start with 20 credits for $1; top up anytime on the pricing page.

How long does a video take?

Typically 2–6 minutes. Generations run server-side, so the tool returns a job immediately — poll get_generation until status is "completed" and the video URL appears.

Where do my outputs go?

Every generation returns a CDN URL and also lands in your ViralAI gallery, tied to your account — nothing is siloed off somewhere else.

Can I use this in production?

Yes. The MCP server and the CLI are both built for it — wire the CLI into a script, cron job, or CI runner, or let an agent drive the MCP server. Same key, same credits, same gallery.

How do I revoke a key?

Go to Profile → API keys → Revoke. The key stops working immediately, everywhere it was used.

One card. Any client. Ninety seconds.

Your connector link

Paste it into Claude → Settings → Connectors → Add. That's the whole setup.

Your key is already in the link — it spends your own credits. Keep it private; treat it like a password.

Using Claude Code, Codex, or Hermes? The CLI is the fastest path.

The entire toolkit.

generate_video

Text to finished ad, inside your agent.

One tool call turns a sentence into a broadcast-ready vertical clip — rendered on Seedance 2.0, returned as a CDN URL your agent can post anywhere.

Try it in Claude

1generate_video

Generate a 15-second vertical ad: perfume bottle on wet black marble, slow dolly-in, golden hour.

sd2_pro9:1615ssound

DownloadGet URLRegenerate

agents poll get_generation → status: completed · video_url

generate_image

Stills that sell, on tap.

Product heroes, thumbnails, key art — Seedream 5.0 Pro and GPT-Image-2 render campaign-grade stills straight into the same conversation.

Try it in ChatGPT

2generate_image

Product hero shot: chrome sneaker floating over teal studio sweep, hard rim light.

seedream_5_0_pro2K

DownloadGet URLRegenerate

returns immediately → image_url · lands in your gallery

viralai CLI

Or skip the agent entirely.

One line to install, one command to generate. Same key, same credits — perfect for scripts, cron jobs, and CI runners.

curl -fsSL https://viralai.in/cli.sh | sh

viralai — zsh

$viralai generate "a cat surfing at sunset" --wait

⠿ processing… (2m 14s)

✓ completed

https://cdn.viralai.in/videos/8f3a2c….mp4

$ viralai credits

Credits: 1924

Five tools. The whole pipeline.

generate_video

Text prompt → a Seedance 2.0 video job. Returns a generation you poll.

generate_image

Text prompt → an image via Seedream 5.0, GPT-Image-2, or Nano Banana 2.

get_generation

Check any generation by id. Returns the CDN URL once it's completed.

list_models

List the available video + image models and their credit costs.

get_credits

Show your account email and remaining credit balance.

Good to know.

How do I get a key?

It's self-serve. Head to Profile → API keys, hit New key, and point your agent at it. The key is shown once, so keep it somewhere safe.

Which agents can I use?

Claude, Claude Code, ChatGPT (via connectors), Cursor, Hermes, or any MCP-compatible client. Prefer scripts? The one-line bash CLI does the same job from your terminal — same account, same key.

Is it free?

It runs on your existing ViralAI credit balance — exactly the same credits as the website. New accounts start with 20 credits for $1; top up anytime on the pricing page.

How long does a video take?

Typically 2–6 minutes. Generations run server-side, so the tool returns a job immediately — poll get_generation until status is "completed" and the video URL appears.

Where do my outputs go?

Every generation returns a CDN URL and also lands in your ViralAI gallery, tied to your account — nothing is siloed off somewhere else.

Can I use this in production?

Yes. The MCP server and the CLI are both built for it — wire the CLI into a script, cron job, or CI runner, or let an agent drive the MCP server. Same key, same credits, same gallery.

How do I revoke a key?

Go to Profile → API keys → Revoke. The key stops working immediately, everywhere it was used.

Generate viral videos from any agent.

One card. Any client. Ninety seconds.

Your connector link

The entire toolkit.

Text to finished ad, inside your agent.

Stills that sell, on tap.

Or skip the agent entirely.

Five tools. The whole pipeline.

The latest models, one connection.

Same credits as the website.

Good to know.

Start with 20 credits for $1.

Generate viral videos from any agent.

One card. Any client. Ninety seconds.

Your connector link

The entire toolkit.

Text to finished ad, inside your agent.

Stills that sell, on tap.

Or skip the agent entirely.

Five tools. The whole pipeline.

The latest models, one connection.

Same credits as the website.

Good to know.

Start with 20 credits for $1.