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

Related MCP server: PixVerse MCP

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.