{
  "markdown": "# botverse-mcp\n\nMCP server **and command-line tool** for [Botverse](https://botverse.cloud) — video transcoding and document conversion for AI agents and the humans who configure them.\n\n[![npm](https://img.shields.io/npm/v/botverse-mcp)](https://www.npmjs.com/package/botverse-mcp)\n\n## What it does\n\n- **Video transcoding** — MP4 (H.264), WebM (VP9), ProRes 422, GIF, MP3 extraction · $0.25/job\n- **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\n- **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\n- **Document conversion** — Markdown ↔ DOCX ↔ PDF ↔ HTML ↔ XLSX · $0.05/file\n- **Transcription** — speaker-labelled transcripts (diarization + AI speaker naming) → txt/srt/vtt/docx/pdf · ~$3/hour\n\nTwo 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.\n\n## Setup\n\n1. Sign up at [botverse.cloud](https://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.\n2. Get an API key or connector URL from your dashboard\n3. Add to your MCP client config\n\n## Usage\n\n### Claude Desktop / Cursor / Windsurf\n\n```json\n{\n  \"mcpServers\": {\n    \"botverse\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"botverse-mcp\"],\n      \"env\": {\n        \"BOTVERSE_API_KEY\": \"bv_live_...\"\n      }\n    }\n  }\n}\n```\n\nOr with a connector URL (recommended for claude.ai):\n\n```json\n{\n  \"mcpServers\": {\n    \"botverse\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"botverse-mcp\"],\n      \"env\": {\n        \"BOTVERSE_CONNECTOR_URL\": \"https://botverse.cloud/mcp?token=bv_sess_...\"\n      }\n    }\n  }\n}\n```\n\n## Command line (`botverse`)\n\nThe same package ships a `botverse` CLI for the shell — it reads files from disk and\nstreams them straight to the API (no content goes through an LLM), so it's the fast\npath for evaluation, automation, and local coding agents.\n\n```bash\nexport BOTVERSE_API_KEY=bv_live_…        # or BOTVERSE_CONNECTOR_URL=…?token=bv_sess_…\n\nnpx botverse convert report.md --to pdf\nnpx botverse convert *.md --to docx,pdf -o ./out\nnpx botverse transcode clip.mov --to mp4 -o ./out\nnpx botverse transcribe call.mp4 --to docx --attendees \"Sarah Chen,Mike Torres\"\nnpx botverse conform video.mp4 audio.wav --to mp4 --method speed_conform --target-framerate 25\nnpx botverse balance\n```\n\nEach job uploads → polls → downloads the finished file to `-o` (default: current dir).\nGlobs and multiple `--to` formats run as a batch.\n\n> **Sandbox note:** the CLI needs outbound network to `botverse.cloud` and S3, so it does\n> **not** run inside sandboxed agent environments (claude.ai / Claude Desktop), whose\n> egress is allowlisted. There, use the MCP tools (`convert_content` / `get_output_content`).\n\n## Tools (MCP)\n\n| Tool | Description |\n|---|---|\n| `transcode_from_url` | Transcode video from a public URL |\n| `transcode_video` | Transcode an uploaded video file |\n| `conform_from_url` | Mux a separate video + audio source (public URLs) into one output |\n| `conform_media` | Mux an uploaded video + audio source into one output |\n| `conform_splice_from_url` | Concatenate video/image segments (public URLs) — slates, bumpers, end cards, inserts, joined clips |\n| `conform_splice_media` | Concatenate uploaded video/image segments — same use cases |\n| `convert_content` | Convert document content inline (up to 4 MB; sandbox-safe) |\n| `convert_from_url` | Convert a document from a public URL |\n| `convert_file` | Convert an uploaded document |\n| `get_job_status` | Poll a job until complete |\n| `get_download_url` | Get the signed download URL |\n| `get_output_content` | Get finished output bytes inline (sandbox-safe download) |\n| `get_wallet_balance` | Check wallet balance |\n\n## Pricing\n\n- Video transcode (≤5 min): **$0.25/job**\n- Video overage: **+$0.08/min**\n- ProRes 422: **$0.35/source-min** ($0.50 min)\n- Document conversion: **$0.05/file**\n\nCredits never expire. [Full pricing →](https://botverse.cloud/pricing)\n\n## Links\n\n- [Documentation](https://botverse.cloud/docs)\n- [Dashboard](https://botverse.cloud/dashboard)\n- [Support](mailto:support@botverse.cloud)\n",
  "bytes": 4482,
  "sha": "471759c84fd5ae148cbc4a4f32bccc6c559a4df0bad2e19abae15de3ece3dfdb",
  "repo_slug": "mkturner74/botverse-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mkturner74_botverse_67a7e54c/readme"
}