MkTurner74/botverse-mcp

MCP server **and command-line tool** for Botverse — video transcoding and document conversion for AI agents and the humans who configure them.
What it does
- **Video transcoding** — MP4 (H.264), WebM (VP9), ProRes 422, GIF, MP3 extraction · $0.25/job
- **Video/audio conform** — mux a separate video and audio source into one output, reconciling frame-rate and duration mismatches (including true pulldown-style speed conforms, e.g. 24→25fps) · $0.30/job
- **Conform splice** — concatenate video and/or still-image segments into one output: head slates/bumpers, tail slates/end cards, mid-roll inserts/cutaways, or joining clips together · from $0.30/job
- **Document conversion** — Markdown ↔ DOCX ↔ PDF ↔ HTML ↔ XLSX · $0.05/file
- **Transcription** — speaker-labelled transcripts (diarization + AI speaker naming) → txt/srt/vtt/docx/pdf · ~$3/hour
- **Workflows** — chain multiple Botverse operations (transcode, convert, transcribe, conform, splice) into a single multi-step job with automatic dependency ordering and parallel branches, instead of orchestrating each call yourself · convert-only steps run on wallet balance ($0.05/step); transcode/transcribe steps bill by source duration and require auto-refill
Two ways to use it: an **MCP server** for your AI agents, and a **botverse CLI** for the shell — evaluation, CI/CD, cron, scripts, and local coding agents. No AWS. No FFmpeg. No infrastructure.
Setup
1. Sign up at botverse.cloud — **free to try: $1 credit on signup, no card required.** A card + 2FA are only needed at your first top-up ($5 min). No monthly fees.
2. Get an API key or connector URL from your dashboard
3. Add to your MCP client config
Usage
Claude Desktop / Cursor / Windsurf
Or with a connector URL (recommended for claude.ai):
Command line (botverse)
The same package ships a botverse CLI for the shell — it reads files from disk and
streams them straight to the API (no content goes through an LLM), so it's the fast
path for evaluation, automation, and local coding agents.
Each job uploads → polls → downloads the finished file to -o (default: current dir).
Globs and multiple --to formats run as a batch.
> **Sandbox note:** the CLI needs outbound network to botverse.cloud and Botverse's file storage host, so it does
> **not** run inside sandboxed agent environments (claude.ai / Claude Desktop), whose
> egress is allowlisted. There, use the MCP tools (e.g. convert_content) instead.
Tools (MCP)
| Tool | Description |
|---|---|
| get_upload_url | Get a presigned URL to upload a file for use with the _media/_file/_video (object-key-based) tools |
| transcode_from_url | Transcode video from a public URL |
| transcode_video | Transcode an uploaded video file |
| conform_from_url | Mux a separate video + audio source (public URLs) into one output |
| conform_media | Mux an uploaded video + audio source into one output |
| conform_splice_from_url | Concatenate video/image segments (public URLs) — slates, bumpers, end cards, inserts, joined clips |
| conform_splice_media | Concatenate uploaded video/image segments — same use cases |