# VideoResolver: MCP agent guide

VideoResolver downloads public videos and audio from a link (YouTube, X, LinkedIn, Instagram, TikTok, Vimeo, Facebook, Reddit, Twitch and more) and returns a private download link.

## Connect

- MCP endpoint (Streamable HTTP, stateless JSON): `https://www.videoresolver.com/api/mcp`
- Auth: `Authorization: Bearer <API_KEY>`, or `?key=<API_KEY>` for clients that only accept a URL
- Get a key: https://www.videoresolver.com/app#api (one key per tool, revocable at any time)

Claude Code:

```bash
claude mcp add --transport http videoresolver https://www.videoresolver.com/api/mcp --header "Authorization: Bearer <API_KEY>"
```

Any client that reads an `mcpServers` JSON config:

```json
{ "mcpServers": { "videoresolver": { "url": "https://www.videoresolver.com/api/mcp", "headers": { "Authorization": "Bearer <API_KEY>" } } } }
```

## Tools

| Tool | Arguments | Returns |
| --- | --- | --- |
| `get_account` | none | plan, credits, renews_at |
| `get_media_info` | `url` | title, channel, platform, duration_seconds, credits_required |
| `download_media` | `url`, `format?` (mp4, mp3, m4a, wav), `quality?` | download_id, status |
| `get_download` | `download_id` | status, progress, download_url when ready |
| `list_downloads` | `limit?` | recent downloads |

## Recommended flow

1. Optionally call `get_media_info` to show the title and the credit cost before downloading.
2. Call `download_media`. If credits are missing, tell the user to upgrade at https://www.videoresolver.com/app.
3. Poll `get_download` every few seconds until `status` is `ready` (or `failed`).
4. Give the user `download_url`. It is valid for 1 hour; call `get_download` again for a fresh link while the file is still available.

## Rules worth knowing

- 1 credit per started minute of media. Failed downloads are refunded automatically.
- Choosing `format` and `quality` requires a paid plan or credit pack; free accounts always get MP4 at best quality.
- Private, deleted, age-restricted and live content can't be downloaded.
- Lookups are rate limited per account (about 60 per hour).

## REST API

The same key works with the REST API: `https://www.videoresolver.com/api/v1`. Schema: https://www.videoresolver.com/openapi.json