Connect Viralance to Claude via MCP: Create Videos, Images and Voiceovers From Your AI Assistant
TL;DR
TL;DR: Viralance runs an official MCP (Model Context Protocol) server, so Claude — Claude Code, Claude Desktop, or any MCP client — can call Viralance tools like generate_video, generate_image, and generate_voiceover directly. Create a scoped API key, run one connect command, then brief jobs in plain English. Credits come from the same wallet as the web app: a VEO 3.1 Fast 720p clip is 6 credits at 4 seconds, and an ElevenLabs Eleven v3 voiceover is 2 credits.
Instead of clicking through a dashboard, you describe the clip you want and your AI assistant produces it. The Model Context Protocol makes that real: Claude stops being a thing that only talks and starts calling tools that act. This guide covers the setup, the exact tools Viralance exposes, and what each one draws from your credit balance.
What is MCP, and why connect Viralance to Claude?
MCP is an open standard that lets an AI assistant call external tools through a typed, validated interface. Viralance implements it as a server built on the official MCP SDK, served over Streamable HTTP with JSON-RPC 2.0. Claude reads your account state through MCP resources (viralance://models, viralance://credits, viralance://packages), then invokes purpose-built tools rather than a raw API.
The practical payoff: you brief a video the way you'd brief a teammate. "Make a 6-second VEO 3.1 Fast clip of a cat surfing a neon wave, vertical 9:16" becomes an actual generation job inside your account, with the file handed back in chat.
Related questions: What is the Model Context Protocol? Can Claude generate videos directly? Does Viralance have an official MCP server?
How do I connect Viralance to Claude?
Setup runs about two minutes:
-
Create an API key. Go to Dashboard → Settings → API Keys and generate one. Grant only the scopes you need — the server defines video:create, video:read, image:create, and credits:read — and revoke it anytime.
-
Connect your client. In Claude Code, one command does it:
claude mcp add --transport http viralance https://viralance-mcp.run.app/mcp
Claude Code can authenticate over OAuth in your browser, so there's no key to paste. Prefer a key? Append --header "Authorization: Bearer YOUR_API_KEY". For Claude Desktop, add an mcp-remote entry to claude_desktop_config.json and restart — the exact snippet is on your in-app Viralance MCP page.
-
Confirm it. Ask Claude "Check my Viralance credit balance." That calls get_balance and proves the connection is live.
Related questions: How do I add an MCP server to Claude Code? Where is my Viralance API key? Does Viralance MCP work with Claude Desktop?
What can Claude create through Viralance?
The MCP server reaches the same generation engine as the web app:
- Videos —
generate_video runs 16+ models including VEO 3.1 Fast, Sora 2, Kling, and Seedance 2.0, in text-to-video or image-to-video mode. Track jobs with get_video_status and list_videos.
- Images —
generate_image covers Nano Banana, Nano Banana Pro (up to 4K), GPT Image, and Grok Imagine, at 9:16, 1:1, 16:9, or 4:5.
- Voiceovers —
generate_voiceover is a dedicated text-to-speech tool powered by ElevenLabs Eleven v3. Pass up to 5,000 characters and a voice name like Rachel, Antoni, or Bella; it returns an audioId and an audio URL.
- Copy —
enhance_prompt, generate_caption, and generate_hooks turn a rough idea into tighter prompts, captions with hashtags, and scroll-stopping hooks.
- Editing and 3D — reframe, background removal, subtitles, plus
generate_3d, which turns an image into a downloadable GLB mesh via Meshy.
- Autopilot —
autopilot_create, autopilot_execute, and autopilot_status plan and run a full content batch from a single brief.
Related questions: Can Claude make AI voiceovers? Which video models does Viralance support? Can an AI assistant write my TikTok captions?
What does each action cost in credits?
Every MCP call draws from the same one-time credit wallet as the web app — no separate billing, no subscription, and accounting is atomic so nothing double-charges. Concrete numbers:
- VEO 3.1 Fast, 720p: 6 credits at 4s, 8 at 6s, 12 at 8s. The 1080p tier runs 8 / 10 / 16.
- Images: Grok Imagine is 1 credit, Nano Banana and GPT Image (medium) are 2, GPT Image high and Nano Banana Pro are 4, and Nano Banana Pro at 4K is 6.
- Voiceover: an ElevenLabs Eleven v3 generation is 2 credits.
New accounts start with 6 free signup credits — enough to run a video end-to-end before buying. Ask Claude "What does a 6-second Sora 2 clip cost?" and it calls get_model_costs so you can compare before spending.
Related questions: How much does an AI video cost on Viralance? Are MCP credits separate from web credits? Is there a free trial?
Is connecting through MCP secure?
Security is scoped by design. Each key is limited to the scopes you grant, so a read-only key literally cannot spend. The server enforces a daily spend cap per key, so a leaked key can't drain your balance. Authentication uses OAuth 2.1 with PKCE, credentials are hashed, and every request passes through rate limiting and audit logging. Revoke a key from Settings and that connection dies immediately.
Related questions: Is MCP safe to use? Can I limit what an API key can do? How do I revoke a Viralance API key?
First prompts worth trying
- "Generate a 5-second VEO 3.1 Fast video of a cat surfing a giant wave, vertical."
- "Make a neon cyberpunk city image with Nano Banana Pro at 9:16."
- "Write 5 viral hooks for a skincare brand, then voice the best one with the Rachel voice."
- "List my last 5 videos with their status, and tell me my remaining credits."
Connect once and Claude becomes a front end to your whole content pipeline. Open the Viralance MCP page in your dashboard to grab your server URL and key, then start shipping from a single chat.
Related questions: What's a good first prompt for Viralance MCP? Can Claude run a full content batch with Autopilot?
