# Dopplio MCP

> Dopplio connects your AI agent to a full multimedia automation suite. It lets you programmatically create personalized video messages, generate reports from URLs or HTML into PDFs, and automatically capture screenshots of any website. You control complex media pipelines—videos, documents, images—all through natural conversation.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** video-personalization, ai-video, document-rendering, marketing-tech, automated-media, voice-cloning

## Description

Stop exporting assets manually. This connector puts video generation, document rendering, and web monitoring directly into your agent's workflow. Instead of logging into three different dashboards to get a report, wait for a video render, and check a screenshot, you just ask your AI client to coordinate it all. Your agent manages the whole sequence: triggering personalized videos with voice cloning, generating high-fidelity PDFs from raw web data, or running scheduled screenshots to monitor assets. It's total control over multimedia output without leaving your chat window. You can access this power via Vinkius, connecting Dopplio directly to any of your favorite AI clients.

## Tools

### capture_screenshot
Takes an image snapshot of a specific webpage URL.

### generate_video
Creates personalized, AI-powered videos using provided templates and recipient data.

### get_render_status
Checks if a previously requested video or document rendering job has finished processing.

### get_video_details
Retrieves specific metadata and information about an already created video asset.

### list_videos
Lists the titles, IDs, and basic details of all videos you've previously generated with Dopplio.

### render_pdf
Generates a PDF file by reading content from either a provided URL or raw HTML text.

## Prompt Examples

**Prompt:** 
```
Render a PDF from the URL 'https://vinkius.com/report'.
```

**Response:** 
```
PDF rendering triggered! I've successfully initiated the document generation for your URL. You can download the finalized file here: [download_url]. Your report is now ready.
```

**Prompt:** 
```
Capture a mobile screenshot of 'google.com'.
```

**Response:** 
```
Screenshot captured! I've used the mobile viewport settings to capture 'google.com'. You can view your image here: [image_url]. Shall I check the PDF version of this page as well?
```

**Prompt:** 
```
Check the status of my video rendering job 'job_123'.
```

**Response:** 
```
Monitoring job... Video rendering for job_123 is currently 'Completed'. You can now access the hosting URL and metadata. Shall I retrieve the direct download link for you?
```

## Capabilities

### Generate personalized video messages
Use templates and data points to create bulk, customized videos using advanced voice cloning.

### Create PDF reports from web content
Convert public URLs or raw HTML strings into downloadable, formatted PDF documents for invoicing or reporting.

### Monitor websites with screenshots
Automatically capture images of any website with custom viewports to track visual assets over time.

### Track multimedia job status
Check the real-time progress and final status of all rendering jobs, whether they are videos or documents.

### List and retrieve video metadata
View your complete library of generated videos and pull key details like hosting links and creation dates.

## Use Cases

### The Sales Team needs personalized follow-ups.
A salesperson has a list of 50 prospects. Instead of recording 50 individual videos, they prompt their agent: 'Generate 50 customized Dopplio videos using the provided template and prospect name data.' The agent handles the `generate_video` task for all 50 recipients.

### The Finance team needs quarterly reports.
At month-end, the finance manager doesn't want to manually download several CSVs. They ask their agent to 'Render a PDF of the Q3 data from this internal dashboard URL.' The `render_pdf` tool handles the conversion immediately.

### The Web Team monitors site changes.
A growth engineer needs to check if the pricing page broke during deployment. They run a scheduled task that uses `capture_screenshot` on the URL and compares the image output over time, flagging any visual discrepancies.

### The Product Team archives documentation.
A technical writer has a massive chunk of raw HTML code from an old product spec. They use the agent to 'Render this entire block of HTML into a single PDF' using `render_pdf`, archiving it correctly without needing Word or LaTeX.

## Benefits

- Stop managing complex render jobs manually. Using `get_render_status` ensures you know exactly when your personalized videos or PDFs are ready to download.
- Create targeted marketing assets faster than ever. The `generate_video` tool lets you build bulk, customized video campaigns using natural language prompts and data inputs.
- Generate official reports instantly. Instead of manual exporting, the `render_pdf` tool turns any web page or raw HTML into a professional PDF document on demand.
- Monitor your site without code. The `capture_screenshot` tool lets you schedule automated visual checks across multiple URLs, giving you an eye on your web assets 24/7.
- Stay organized with full visibility. You can use `list_videos` to see every video Dopplio has created for you and then use `get_video_details` to pull specific IDs or links.

## How It Works

The bottom line is you never have to manage complex rendering pipelines manually; your AI handles the whole sequence from start to finish.

1. Subscribe to the Dopplio MCP on Vinkius and grab your API Key.
2. Instruct your AI client—like Claude or Cursor—to run a task (e.g., 'Generate a PDF from this URL' or 'Create 5 personalized videos').
3. Your agent manages the process: it starts the job, checks the status using its internal tools, and finally provides the direct download link for the finished asset.

## Frequently Asked Questions

**How do I check if my Dopplio video rendering job finished?**
You use the `get_render_status` tool. Just pass it the job ID provided when you first initiated the `generate_video` task, and it tells you if the asset is ready.

**Can I make a PDF from a specific URL using Dopplio?**
Yes, use the `render_pdf` tool. You just need to provide the target URL in your request body, and it handles turning that live web page into a downloadable file.

**How do I see all the videos Dopplio has created?**
Run the `list_videos` tool. This command pulls a directory of every video you've generated, giving you IDs and names to work with.

**What is the difference between `get_video_details` and `get_render_status`?**
`get_render_status` tells you if the job is finished. `get_video_details`, however, gives you specific metadata about the video itself once it's complete.

**When I use the `capture_screenshot` tool, how do I specify the viewport size or device type?**
You pass specific viewports and formats as parameters. This lets you capture assets accurately, whether you need a mobile phone view, desktop dimensions, or just a custom pixel size.

**What structured data do I need to provide when calling `generate_video`?**
You must provide both the video template and the personalization data for each recipient. The tool uses these variables to automatically customize the AI-generated clip at scale.

**If a render job fails, how do I troubleshoot it using `get_render_status`?**
The status check reports not only 'Failed' but often includes an error code or detailed log. This helps you pinpoint if the failure is due to bad input data or a system issue.

**Aside from the URL, what specific information does `get_video_details` retrieve about a video?**
It pulls rich metadata for the asset. You get details like rendering dimensions, original job identifiers, and the associated hosting links needed for your reports.

**How do I find my Dopplio API Key?**
Log in to your account at [doppio.sh](https://doppio.sh/), navigate to the API or Dashboard section, and copy your unique secret key.

**Are multimedia renderings synchronous?**
Video generation is typically asynchronous. You initiate a job and use the `get_render_status` tool to check for completion status.

**Can I render a PDF from custom HTML?**
Yes! The `render_pdf` tool allows you to provide raw HTML strings in the `body_json` parameter to generate a document immediately.