Getting started

Create an account, top up your wallet, get your API key, and run your first transcode job — all in under five minutes.

1
Create your account
Go to botverse.cloud and sign up. You'll need an email address. No credit card required to sign up — you'll add funds in the next step.
2
Top up your wallet — minimum $5
Botverse uses a prepaid wallet. There are no subscriptions. Add at least $5 to activate your account. Your balance rolls over indefinitely. You can set up auto-refill later to keep your bots running without interruption.
3
Get your API key
From your dashboard, generate an API key. It will look like bv_live_••••••••••••••••. Treat this like a password — it authorizes all job submissions and wallet charges against your account.
4
Connect your agent
Paste the config block into your MCP client. See the Connect guide for Claude Desktop, Cursor, OpenAI, and more. The quickest path is Claude Desktop — your agent will be ready in under a minute.
5
Run your first job
Ask your agent to transcode a video. The agent will call the Botverse tools automatically — upload, transcode, poll, download. You don't write any code.

Your first API call (raw HTTP)

Every Botverse tool is a JSON-RPC 2.0 call to the MCP endpoint. If you want to test without an AI client, here's the bare HTTP request to get an upload URL:

curl — get an upload URL
curl -X POST https://botverse.cloud/mcp \
  -H "Content-Type: application/json" \
  -H "X-API-Key: bv_live_YOUR_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_upload_url",
      "arguments": {
        "filename": "keynote.mp4"
      }
    }
  }'
Response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"object_key\": \"uploads/abc123/keynote.mp4\", \"upload_url\": \"https://s3...presigned...\"}"
      }
    ]
  }
}

Upload your file with a PUT request to the upload_url, then call transcode_videowith the object_key. See the Transcode service reference for all tool calls in sequence.

Wallet and billing

Checking your balance

Your bot can check its own wallet balance at any time — no dashboard required:

tools/call — get_wallet_balance
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_wallet_balance",
    "arguments": {}
  }
}

// Response
{
  "balance_usd": 4.87,
  "auto_refill": { "enabled": true, "threshold_usd": 1.00, "amount_usd": 10.00 },
  "monthly_cap_usd": 50.00
}

Auto-refill

Set a refill threshold from your dashboard. When your balance drops below the threshold, Botverse automatically charges your card and tops up to your chosen amount. Set a monthly cap to avoid surprises.

Job costs

Every completed job returns a job_cost field showing exactly what was charged. Use get_usage_history to see a log of all jobs and their costs.

ℹ
Costs are deducted at job completion, not at submission. If a job fails, you are not charged.

Current limits

LimitValueNotes
Max video duration10 minutesValidated before encoding begins; longer jobs coming with EC2 tier
Max file size5 GBValidated before job is queued — invalid files are rejected, not charged
Job timeout15 minutesEncode jobs have a 14.5-minute processing timeout with graceful abort
Presigned upload URL expiry15 minutesUpload must begin within this window
Presigned download URL expiry24 hoursRegenerate with get_download_url if expired
API key authX-API-Key headerDo not send in query string
⚠
The 10-minute cap is a current platform constraint, not a design limit. A higher-capacity worker tier for longer jobs is on the roadmap. If you need to transcode video conference recordings or longer clips, contact us.