ViralVadoo MCP Server

An MCP (Model Context Protocol) server that exposes all Vadoo AI APIs as tools — compatible with Claude Desktop, Claude Code, Cursor, and ChatGPT.

Tools Available

Tool	Description
get_balance	Check your remaining credit balance
generate_video	Create an AI video from a topic, custom script, or blog URL
get_video_status	Poll video generation progress and get the final URL
add_captions	Add AI captions/subtitles to any video
create_ai_clips	Extract viral short clips from a long YouTube/MP4 video
generate_podcast	Generate a 2-person AI podcast from a URL, PDF, or text
list_characters	List your AI characters
generate_character_image	Generate a new image of an AI character
get_character_image_status	Poll character image generation status
list_voices	List all available AI voices
list_languages	List supported languages
list_styles	List available visual image styles
list_themes	List available caption themes
list_video_topics	List predefined video topic categories
list_background_music	List available background music tracks

---

Setup

1. Install dependencies

cd ViralVadoo/mcp-server
pip install -r requirements.txt

2. Set your API key

cp .env.example .env
# Edit .env and add your Vadoo API key
# Get your key at: https://ai.vadoo.tv/profile

---

Client Configuration

Claude Desktop

Edit %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "viradvadoo": {
      "command": "python",
      "args": ["C:\\path\\to\\ViralVadoo\\mcp-server\\server.py"],
      "env": {
        "VADOO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Tip: Use the full absolute path to server.py. Alternatively, store the key in .env and omit the env block.

---

Claude Code

Run from the terminal inside the mcp-server directory:

claude mcp add viradvadoo -- python /full/path/to/server.py

Or set the env variable first:

VADOO_API_KEY=your_key claude mcp add viradvadoo -- python /full/path/to/server.py

Verify it is registered:

claude mcp list

---

Cursor

Open Settings → MCP and add a new server entry:

{
  "viradvadoo": {
    "command": "python",
    "args": ["/full/path/to/ViralVadoo/mcp-server/server.py"],
    "env": {
      "VADOO_API_KEY": "your_api_key_here"
    }
  }
}

---

ChatGPT (OpenAI)

ChatGPT (via mcp-proxy HTTP bridge)

Since ChatGPT runs in the cloud, it cannot run local python files directly. We can bridge this local stdio server to SSE (HTTP) and tunnel it.

1. Install mcp-proxy:

pip install mcp-proxy

2. Run the proxy with your API key:

Windows Command Prompt (CMD):

set VADOO_API_KEY=your_key_here && mcp-proxy --port 8080 -- python "C:\Users\JAYAP\joint-folder\ViralVadoo\mcp-server\server.py"

PowerShell:

$env:VADOO_API_KEY="your_key_here"; mcp-proxy --port 8080 -- python "C:\Users\JAYAP\joint-folder\ViralVadoo\mcp-server\server.py"

3. Expose your port 8080 using ngrok or localtunnel so ChatGPT can connect to it:

npx localtunnel --port 8080

Copy the forwarding URL (e.g., https://xxxx.localtunnel.me).

4. Add to ChatGPT:
   • Go to ChatGPT Settings → Apps / Connectors → Developer Mode (Turn ON).
   • Click Add MCP Server / Add App.
   • Set URL to your tunnel URL with /sse appended (e.g. https://xxxx.localtunnel.me/sse).

---

Quick Test

# Start the server directly (stdin/stdout MCP protocol)
python server.py

The server is ready when it silently awaits — connect your MCP client and the tools will appear automatically.