Odel
botverse mcp

botverse mcp

Local
@mkturner741JavaScriptMITUpdated Yesterday

Transcode/conform/splice video, convert docs, transcribe audio for AI agents. Free $1 trial.

botverse-mcp

MCP server and command-line tool for Botverse — video transcoding and document conversion for AI agents and the humans who configure them.

npm

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

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.cloudfree 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

{
  "mcpServers": {
    "botverse": {
      "command": "npx",
      "args": ["-y", "botverse-mcp"],
      "env": {
        "BOTVERSE_API_KEY": "bv_live_..."
      }
    }
  }
}

Or with a connector URL (recommended for claude.ai):

{
  "mcpServers": {
    "botverse": {
      "command": "npx",
      "args": ["-y", "botverse-mcp"],
      "env": {
        "BOTVERSE_CONNECTOR_URL": "https://botverse.cloud/mcp?token=bv_sess_..."
      }
    }
  }
}

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.

export BOTVERSE_API_KEY=bv_live_…        # or BOTVERSE_CONNECTOR_URL=…?token=bv_sess_…

npx botverse convert report.md --to pdf
npx botverse convert *.md --to docx,pdf -o ./out
npx botverse transcode clip.mov --to mp4 -o ./out
npx botverse transcribe call.mp4 --to docx --attendees "Sarah Chen,Mike Torres"
npx botverse conform video.mp4 audio.wav --to mp4 --method speed_conform --target-framerate 25
npx botverse balance

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 S3, so it does not run inside sandboxed agent environments (claude.ai / Claude Desktop), whose egress is allowlisted. There, use the MCP tools (convert_content / get_output_content).

Tools (MCP)

ToolDescription
transcode_from_urlTranscode video from a public URL
transcode_videoTranscode an uploaded video file
conform_from_urlMux a separate video + audio source (public URLs) into one output
conform_mediaMux an uploaded video + audio source into one output
conform_splice_from_urlConcatenate video/image segments (public URLs) — slates, bumpers, end cards, inserts, joined clips
conform_splice_mediaConcatenate uploaded video/image segments — same use cases
convert_contentConvert document content inline (up to 4 MB; sandbox-safe)
convert_from_urlConvert a document from a public URL
convert_fileConvert an uploaded document
get_job_statusPoll a job until complete
get_download_urlGet the signed download URL
get_output_contentGet finished output bytes inline (sandbox-safe download)
get_wallet_balanceCheck wallet balance

Pricing

  • Video transcode (≤5 min): $0.25/job
  • Video overage: +$0.08/min
  • ProRes 422: $0.35/source-min ($0.50 min)
  • Document conversion: $0.05/file

Credits never expire. Full pricing →

Links